Add custom gemini baseurl support (zilliztech#183)

* Add Gemini API basic URL configuration, optimize CI workflow to support multiple operating systems, update dependencies and fix cleanup scripts

* Optimize build performance, add Windows specific settings and troubleshooting documentation, update configurations to support incremental builds and caching

* Optimize CI workflow to support cross platform build output validation, update documentation to include validation commands for Windows and Unix

Author: AstroAir

.env.example

@@ -44,6 +44,9 @@ OPENAI_API_KEY=your-openai-api-key-here
 # Google Gemini API key
 # GEMINI_API_KEY=your-gemini-api-key-here
 
+# Gemini API base URL (optional, for custom endpoints)
+# GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta
+
 # =============================================================================
 # Ollama Configuration
 # =============================================================================

.github/workflows/ci.yml

@@ -2,39 +2,61 @@ name: CI
 
 on:
   push:
-    branches: [ master, main, claude_context ]
+    branches: [master, main, claude_context]
   pull_request:
-    branches: [ master, main, claude_context ]
+    branches: [master, main, claude_context]
 
 jobs:
   lint_and_build:
-    runs-on: ubuntu-latest
-    
+    runs-on: ${{ matrix.os }}
+
     strategy:
       matrix:
+        os: [ubuntu-latest, windows-latest]
         node-version: [20.x, 22.x]
-    
+
     steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-      
-    - name: Install pnpm
-      uses: pnpm/action-setup@v4
-      with:
-        version: 10
-        
-    - name: Setup Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v4
-      with:
-        node-version: ${{ matrix.node-version }}
-        cache: 'pnpm'
-        
-    - name: Install dependencies
-      run: pnpm install --frozen-lockfile
-      
-    # - name: Lint code
-    #   run: pnpm lint
-      
-    - name: Build packages
-      run: pnpm build
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: "pnpm"
+
+      - name: Configure Windows line endings
+        if: matrix.os == 'windows-latest'
+        run: git config --global core.autocrlf false
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      # - name: Lint code
+      #   run: pnpm lint
+
+      - name: Build packages
+        run: pnpm build
+
+      - name: Test clean command (Windows validation)
+        if: matrix.os == 'windows-latest'
+        run: |
+          pnpm clean
+          echo "Clean command executed successfully on Windows"
+
+      - name: Verify build outputs (Unix)
+        if: matrix.os != 'windows-latest'
+        run: |
+          ls -la packages/core/dist || echo "packages/core/dist not found"
+          ls -la packages/mcp/dist || echo "packages/mcp/dist not found"
 
+      - name: Verify build outputs (Windows)
+        if: matrix.os == 'windows-latest'
+        run: |
+          Get-ChildItem packages/core/dist -ErrorAction SilentlyContinue | Format-Table -AutoSize || Write-Host "packages/core/dist not found"
+          Get-ChildItem packages/mcp/dist -ErrorAction SilentlyContinue | Format-Table -AutoSize || Write-Host "packages/mcp/dist not found"

.npmrc

@@ -0,0 +1,17 @@
+# Enable shell emulator for cross-platform script execution
+shell-emulator=true
+
+# Ignore workspace root check warning (already configured in package.json)
+ignore-workspace-root-check=true
+
+# Build performance optimizations
+prefer-frozen-lockfile=true
+auto-install-peers=true
+dedupe-peer-dependents=true
+
+# Enhanced caching
+store-dir=~/.pnpm-store
+cache-dir=~/.pnpm-cache
+
+# Parallel execution optimization
+child-concurrency=4

CONTRIBUTING.md

@@ -13,22 +13,44 @@ Thank you for your interest in contributing to Claude Context! This guide will h
 ### Development Setup
 
 1. **Fork and Clone**
+
    ```bash
    git clone https://github.com/your-username/claude-context.git
    cd claude-context
    ```
 
-2. **Install Dependencies**
+2. **Platform-Specific Setup**
+
+   **Windows Users:**
+
+   ```powershell
+   # Configure git line endings (recommended)
+   git config core.autocrlf false
+
+   # Ensure pnpm is installed
+   npm install -g pnpm
+   ```
+
+   **Linux/macOS Users:**
+
+   ```bash
+   # Standard setup - no additional configuration needed
+   ```
+
+3. **Install Dependencies**
+
    ```bash
    pnpm install
    ```
 
-3. **Build All Packages**
+4. **Build All Packages**
+
    ```bash
    pnpm build
    ```
 
-4. **Start Development Mode**
+5. **Start Development Mode**
+
    ```bash
    pnpm dev
    ```
@@ -71,6 +93,7 @@ pnpm dev
 ### Package-Specific Development
 
 For detailed development instructions for each package, see:
+
 - [Core Package Development](packages/core/CONTRIBUTING.md)
 - [VSCode Extension Development](packages/vscode-extension/CONTRIBUTING.md)
 - [MCP Server Development](packages/mcp/CONTRIBUTING.md)
@@ -97,6 +120,7 @@ refactor(mcp): improve error handling
 ### Pull Request Process
 
 1. **Create Feature Branch**
+
    ```bash
    git checkout -b feature/your-feature-name
    ```
@@ -106,17 +130,20 @@ refactor(mcp): improve error handling
    - Update documentation if needed
 
 3. **Build and Verify**
+
    ```bash
    pnpm build
    ```
 
 4. **Commit Your Changes**
+
    ```bash
    git add .
    git commit -m "feat(core): add your feature description"
    ```
 
 5. **Push and Create PR**
+
    ```bash
    git push origin feature/your-feature-name
    ```