Merge pull request #52 from JStone2934/feat/desktop-branch

Feat/desktop branch

Author: JStone2934

.github/workflows/desktop-build.yml

@@ -0,0 +1,165 @@
+name: Desktop Build
+
+on:
+  push:
+    branches: [ main, master, feat/desktop-branch ]
+    tags:
+      - 'v*.*.*-*'   # prerelease: v0.1.0-beta.1
+      - 'v[0-9]*.[0-9]*.[0-9]*'  # release: v0.1.0 (纯版本号)
+    paths:
+      - 'desktop/**'
+      - '.github/workflows/desktop-build.yml'
+  pull_request:
+    branches: [ main, master, feat/desktop-branch ]
+    paths:
+      - 'desktop/**'
+      - '.github/workflows/desktop-build.yml'
+  workflow_dispatch:
+
+concurrency:
+  group: desktop-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Desktop ${{ matrix.platform }} (${{ matrix.arch }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-14
+            platform: mac
+            arch: arm64
+            python: python3.10
+            asr: funasr-onnx
+            artifact_path: |
+              desktop/release/*.dmg
+          - os: windows-latest
+            platform: win
+            arch: x64
+            python: python
+            asr: funasr-onnx
+            artifact_path: |
+              desktop/release/*.exe
+
+    defaults:
+      run:
+        shell: bash
+        working-directory: desktop
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+          run_install: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+          cache-dependency-path: desktop/pnpm-lock.yaml
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Prepare Python env for ASR backend
+        working-directory: desktop
+        run: pnpm run prepare:python
+
+      - name: Print app version
+        id: meta
+        run: |
+          node -e "const v=require('./package.json').version; console.log('app_version='+v)" >> "$GITHUB_OUTPUT"
+
+
+      - name: Build desktop package
+        env:
+          PYTHON: ${{ matrix.python }}
+          ASR_IMPL: ${{ matrix.asr }}
+          ASR_PYTHON_PATH: ${{ matrix.platform == 'win' && format('{0}/desktop/python-env/Scripts/python.exe', github.workspace) || format('{0}/desktop/python-env/bin/python3', github.workspace) }}
+        run: |
+          if [ "${{ matrix.platform }}" = "mac" ]; then
+            pnpm run build:mac -- --${{ matrix.arch }}
+          else
+            pnpm run build:win -- --${{ matrix.arch }}
+          fi
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: livegalgame-desktop-${{ matrix.platform }}-${{ matrix.arch }}-v${{ steps.meta.outputs.app_version }}
+          path: ${{ matrix.artifact_path }}
+          if-no-files-found: error
+          retention-days: 14
+
+  prerelease:
+    name: Publish prerelease
+    runs-on: ubuntu-latest
+    needs: build
+    if: |
+      startsWith(github.ref, 'refs/tags/v') &&
+      contains(github.ref_name, '-')
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist
+
+      - name: Create prerelease
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create "${GITHUB_REF_NAME}" \
+            --prerelease \
+            --title "${GITHUB_REF_NAME}" \
+            --notes "Prerelease ${GITHUB_REF_NAME}"
+          # 处理带空格的文件名
+          find dist -type f -print0 | xargs -0 -I {} gh release upload "${GITHUB_REF_NAME}" "{}" --clobber
+
+  release:
+    name: Publish release
+    runs-on: ubuntu-latest
+    needs: build
+    if: |
+      startsWith(github.ref, 'refs/tags/v') &&
+      !contains(github.ref_name, '-')
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist
+
+      - name: Create release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create "${GITHUB_REF_NAME}" \
+            --title "${GITHUB_REF_NAME}" \
+            --notes "Release ${GITHUB_REF_NAME}"
+          # 处理带空格的文件名
+          find dist -type f -print0 | xargs -0 -I {} gh release upload "${GITHUB_REF_NAME}" "{}" --clobber

.github/workflows/release.yml

@@ -4,7 +4,7 @@ on:
   push:
     branches: [ main, master ]
     tags:
-      - 'v*'
+      - 'android-v*'
   pull_request:
     branches: [ main, master ]
   workflow_dispatch:

.gitignore

@@ -27,4 +27,36 @@ signing.properties
 /desktop/data
 /desktop/.temp
 /desktop/tests
-.cursor
+desktop/src/data
+desktop/.venv310
+/desktop/release
+/desktop/backend/build/
+/desktop/backend/dist/
+.venv
+/desktop/memory-service/.venv
+/desktop/memory-service/__pycache__
+__pycache__/
+# 忽略所有项目里的 python 环境目录（venv/虚拟环境/bootstrap python等）
+**/python-env
+**/python-bootstrap
+**/.venv*/
+**/venv/
+**/.venv
+# Python 缓存文件
+**/__pycache__/
+*.py[cod]
+*.pyo
+.cursor
+
+# Test media files
+test.mp4
+*.mp4
+*.wav
+
+# Desktop docs (local only)
+desktop/docs/
+**/node_modules
+
+# Environment variables
+.env
+.env.*

README.md

@@ -23,6 +23,8 @@
 
 <img width="100%" alt="preview" src="https://github.com/user-attachments/assets/d6c44e31-8362-4825-9d7c-a760a4720133" />
 
+<img width="100%" alt="recent preview" src="./docs/20251225-004407.gif" />
+
 ---
 
 ## 核心功能
@@ -63,10 +65,6 @@
 
 ### 下载
 
-[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
-     alt="Get it on F-Droid"
-     height="75">](https://f-droid.org/packages/com.jstone.livegalgame/)
-     
 - **GitHub Release**: [点击下载](https://github.com/JStone2934/LiveGalGame/tags)
 - **夸克网盘**: https://pan.quark.cn/s/1000136902b5
 - **百度网盘**: https://pan.baidu.com/s/1Bpt2DZNvjzT6BpKr8RyG-A?pwd=94g6
@@ -77,6 +75,13 @@
 
 **Windows / macOS 应用** - 专为语音聊天场景设计的智能助手
 
+### macOS 安装提示（未签名）
+
+- 当前开源版本未做 Apple 官方签名/公证，直接双击 DMG 可能提示“应用已损坏/来自未被认可的开发者”。
+- 推荐做法：在 Finder 中控制键+点按 DMG 内的 `LiveGalGame.app`，选择“打开”，在弹窗中再次“打开”，系统将对本次豁免。（参考 [macguide.leavelet.io](https://macguide.leavelet.io/Bike/appnotopen.html)）
+- 如仍被拦截，可在终端移除隔离属性：`sudo xattr -r -d com.apple.quarantine "/Applications/LiveGalGame.app"`（请替换为实际路径）。
+- 临时放宽 Gatekeeper（风险较高，装完建议恢复）：`sudo spctl --master-disable`，安装后 `sudo spctl --master-enable`。
+
 ### 使用流程
 
 1. **创建对话对象**

desktop/README.md

@@ -78,9 +78,10 @@ pnpm install
 ### 配置语音识别
 
 ```bash
-# 安装 FunASR（推荐，中文识别效果最好）
+# 安装 FunASR（推荐，中文识别效果最好，macOS 默认）
 npm run setup-funasr
 ```
+- Windows 也使用 FunASR ONNX，无需额外安装 faster-whisper。
 
 ### 启动
 
@@ -115,6 +116,70 @@ pnpm dev
 
 ---
 
+## 📦 桌面端发布规则（GitHub Actions）
+
+桌面端发布使用 tag 触发，并区分 **预发布** 和 **正式发布**：
+
+- **预发布（Prerelease）**：`vX.Y.Z-xxx`  
+  例：`v0.1.0-beta.1`
+- **正式发布（Release）**：`vX.Y.Z`  
+  例：`v0.1.0`
+
+Android 的发布已独立为 `android-v*` 标签，避免干扰桌面端发布。
+
+示例：
+
+```bash
+# 预发布（会生成 GitHub Prerelease）
+git tag v0.1.0-beta.1
+git push origin v0.1.0-beta.1
+
+# 正式发布（会生成 GitHub Release）
+git tag v0.1.0
+git push origin v0.1.0
+
+# Android 发布（仅 Android 流程触发）
+git tag android-v0.1.0
+git push origin android-v0.1.0
+```
+
+> 说明：桌面端产物为 macOS `.dmg` 与 Windows `.exe`，不会生成 APK。
+
+---
+
+## 🧰 模型下载与缓存目录（HF / ModelScope）
+
+应用内的语音识别模型（尤其是 FunASR ONNX）会在首次使用/点击下载时自动拉取，并缓存到本机磁盘。为了方便管理、并兼容 Windows / macOS 的默认目录差异，项目默认把缓存放到 Electron 的 `userData` 目录下（不同系统会自动选择合适位置）。
+
+如果你希望把模型统一下载到自己指定的盘符/目录（例如放到大硬盘、NAS 挂载目录等），推荐通过环境变量覆盖：
+
+- `ASR_CACHE_BASE`：ASR 缓存根目录（推荐只改这个）
+- `HF_HOME`：HuggingFace 缓存根目录（高级用法）
+- `ASR_CACHE_DIR`：HuggingFace hub 目录（高级用法）
+- `MODELSCOPE_CACHE`：ModelScope 缓存根目录（注意：实际会写到 `<MODELSCOPE_CACHE>/hub`）
+
+示例（macOS/Linux）：
+
+```bash
+ASR_CACHE_BASE=/data/livegalgame/asr-cache pnpm dev
+```
+
+示例（Windows PowerShell）：
+
+```powershell
+$env:ASR_CACHE_BASE="D:\\LiveGalGame\\asr-cache"; pnpm dev
+```
+
+如果你想手动使用 ModelScope CLI 把某个模型下载到指定位置（不走应用内下载），确实可以用：
+
+```bash
+modelscope download --model 'Qwen/Qwen2-7B' --local_dir /data/models/Qwen2-7B
+```
+
+但应用内的 FunASR 模型下载是由 `funasr_onnx` 触发的（不是直接下载单个 Qwen 模型），因此更推荐用上面的环境变量来统一管理缓存位置。
+
+---
+
 ## 🔧 开发者指南
 
 如果你想参与开发或了解技术细节，请查看项目源码：
@@ -125,4 +190,3 @@ pnpm dev
 - `src/db/` - 本地数据存储
 
 欢迎提交 PR！有问题请加 QQ 群：**1074602400**
-