Merge pull request #45 from LeslieLeung/milestones/m3

Author: LeslieLeung

.env.example

@@ -38,3 +38,92 @@ ADMIN_PORT=3001
 
 # CORS origins (JSON array)
 # CORS_ORIGINS=["http://localhost", "http://localhost:3000"]
+
+# ========================================
+# Embedding Configuration
+# ========================================
+# Embedding provider: openai, sentence-transformers, volc-engine
+EMBEDDING_PROVIDER=sentence-transformers
+
+# API key for embeddings (needed for openai and volc-engine providers)
+# OpenAI: Get from https://platform.openai.com/api-keys
+# Volcengine: Get from https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey
+# EMBEDDING_API_KEY=your-api-key-here
+
+# Alternative API key for Volcengine (official SDK recommended)
+# Get from: https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey
+# ARK_API_KEY=your-volcengine-api-key-here
+
+# Embedding model name
+# For sentence-transformers: all-MiniLM-L6-v2 (384d), paraphrase-multilingual-MiniLM-L12-v2 (384d)
+# For openai: text-embedding-3-small (1536d), text-embedding-3-large (3072d)
+# For volc-engine: doubao-embedding (1024d) or your model endpoint ID
+EMBEDDING_MODEL=all-MiniLM-L6-v2
+
+# Embedding dimension
+# all-MiniLM-L6-v2: 384
+# paraphrase-multilingual-MiniLM-L12-v2: 384
+# text-embedding-3-small: 1536
+# doubao-embedding: 1024
+EMBEDDING_DIMENSION=384
+
+# Batch size for embedding generation
+# Recommended: sentence-transformers (20), openai (20), volc-engine (4)
+EMBEDDING_BATCH_SIZE=20
+
+# Max retries for failed embedding requests
+EMBEDDING_MAX_RETRIES=3
+
+# Request timeout in seconds
+EMBEDDING_TIMEOUT=30
+
+# Optional: Custom API base URL
+# For local models via LiteLLM: http://localhost:8000/v1
+# For Volcengine (default): https://ark.cn-beijing.volces.com
+# EMBEDDING_BASE_URL=http://localhost:8000/v1
+
+# ========================================
+# Milvus Configuration
+# ========================================
+# Milvus host
+MILVUS_HOST=localhost
+
+# Milvus port
+MILVUS_PORT=19530
+
+# Milvus credentials (optional for dev)
+# MILVUS_USER=
+# MILVUS_PASSWORD=
+
+# Collection names
+MILVUS_ENTRIES_COLLECTION=entries
+MILVUS_PREFS_COLLECTION=user_preferences
+
+# ========================================
+# Preference Configuration
+# ========================================
+# Default score for entries without preference model
+PREFERENCE_DEFAULT_SCORE=50.0
+
+# Confidence threshold (samples needed for full confidence)
+PREFERENCE_CONFIDENCE_THRESHOLD=10
+
+# Signal weights
+PREFERENCE_LIKE_WEIGHT=1.0
+PREFERENCE_BOOKMARK_WEIGHT=0.7
+
+# Maximum affinity boosts
+PREFERENCE_SOURCE_BOOST_MAX=5.0
+PREFERENCE_AUTHOR_BOOST_MAX=3.0
+
+# ========================================
+# Score Configuration
+# ========================================
+# Threshold for "recommended" section (score >= 70)
+SCORE_RECOMMEND_THRESHOLD=70.0
+
+# Threshold for "low interest" section (score < 40)
+SCORE_LOW_INTEREST_THRESHOLD=40.0
+
+# Score cache TTL in seconds
+SCORE_CACHE_TTL=3600

.github/workflows/release.yml

@@ -45,6 +45,10 @@ jobs:
             type=semver,pattern={{major}}
             type=raw,value=latest,enable={{is_default_branch}}
 
+      - name: Extract version from tag
+        id: version
+        run: echo "version=${GITHUB_REF_NAME#v}" >> $GITHUB_OUTPUT
+
       - name: Build and push Backend image
         uses: docker/build-push-action@v6
         with:
@@ -54,6 +58,8 @@ jobs:
           push: true
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            APP_VERSION=${{ steps.version.outputs.version }}
           cache-from: type=gha
           cache-to: type=gha,mode=max
 
@@ -151,9 +157,88 @@ jobs:
           cache-from: type=gha
           cache-to: type=gha,mode=max
 
+  build-electron:
+    name: Build Electron App (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    permissions:
+      contents: write
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-latest
+            platform: mac
+          - os: windows-latest
+            platform: win
+          - os: ubuntu-latest
+            platform: linux
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 8
+
+      - name: Get pnpm store directory
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+
+      - name: Setup pnpm cache
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Extract version from tag
+        id: version
+        shell: bash
+        run: echo "version=${GITHUB_REF_NAME#v}" >> $GITHUB_OUTPUT
+
+      - name: Update package.json version
+        shell: bash
+        working-directory: frontend/apps/web
+        run: |
+          npm pkg set version=${{ steps.version.outputs.version }}
+
+      - name: Install dependencies
+        working-directory: frontend
+        run: pnpm install
+
+      - name: Build Electron app
+        working-directory: frontend/apps/web
+        run: pnpm build:electron -- --${{ matrix.platform }}
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Upload artifacts to release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: |
+            frontend/apps/web/release/*.dmg
+            frontend/apps/web/release/*.zip
+            frontend/apps/web/release/*.exe
+            frontend/apps/web/release/*.AppImage
+            frontend/apps/web/release/*.deb
+            frontend/apps/web/release/*.rpm
+            frontend/apps/web/release/*.yml
+            frontend/apps/web/release/*.yaml
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
   create-release:
     name: Create GitHub Release
-    needs: [build-backend, build-web, build-admin]
+    needs: [build-backend, build-web, build-admin, build-electron]
     runs-on: ubuntu-latest
     permissions:
       contents: write
@@ -175,6 +260,10 @@ jobs:
             - `ghcr.io/${{ env.IMAGE_PREFIX }}-web:${{ github.ref_name }}`
             - `ghcr.io/${{ env.IMAGE_PREFIX }}-admin:${{ github.ref_name }}`
             
+            ## Desktop Apps
+            
+            Download the desktop application for your platform from the assets below.
+            
             ## Quick Start
             
             ```bash