chore: resolve merge conflicts in review service and story tree page

Author: Chen-speculation

.github/workflows/desktop-build.yml

@@ -3,6 +3,9 @@ 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'
@@ -102,3 +105,61 @@ jobs:
           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

@@ -29,6 +29,9 @@ signing.properties
 /desktop/tests
 desktop/src/data
 desktop/.venv310
+/desktop/release
+/desktop/backend/build/
+/desktop/backend/dist/
 .venv
 /desktop/memory-service/.venv
 /desktop/memory-service/__pycache__
@@ -52,4 +55,4 @@ test.mp4
 
 # Desktop docs (local only)
 desktop/docs/
-**/node_modules
+**/node_modules

desktop/README.md

@@ -116,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 模型），因此更推荐用上面的环境变量来统一管理缓存位置。
+
+---
+
 ## 🔧 开发者指南
 
 如果你想参与开发或了解技术细节，请查看项目源码：
@@ -126,4 +190,3 @@ pnpm dev
 - `src/db/` - 本地数据存储
 
 欢迎提交 PR！有问题请加 QQ 群：**1074602400**
-

desktop/scripts/download_funasr_model.py

@@ -39,15 +39,38 @@ def main():
 
     # 设置环境变量
     # FunASR 默认下载到 ~/.cache/modelscope/hub
-    # 如果指定了 cache-dir，我们尝试通过 MODELSCOPE_CACHE 环境变量来控制
+    # MODELSCOPE_CACHE 语义通常是 "base dir"，实际下载会落到 <base>/hub。
+    # 但历史上我们也可能传入了 ".../hub"。这里做兼容归一化，确保 Win/mac/Linux 都稳定落盘。
+    cache_base = None
+    cache_hub = None
     if args.cache_dir:
-        os.environ["MODELSCOPE_CACHE"] = args.cache_dir
-        os.environ["MODELSCOPE_CACHE_HOME"] = args.cache_dir
+        raw = os.path.abspath(args.cache_dir)
+        if os.path.basename(raw).lower() == "hub":
+            cache_base = os.path.dirname(raw)
+            cache_hub = raw
+        else:
+            cache_base = raw
+            cache_hub = os.path.join(raw, "hub")
     else:
-        cache = os.environ.get("ASR_CACHE_DIR")
+        # 兼容旧逻辑：若仅提供 ASR_CACHE_DIR（通常是 HF 的 hub），尝试回退到其父目录作为 base
+        cache = os.environ.get("MODELSCOPE_CACHE") or os.environ.get("MODELSCOPE_CACHE_HOME") or os.environ.get("ASR_CACHE_DIR")
         if cache:
-             os.environ["MODELSCOPE_CACHE"] = cache
-             os.environ["MODELSCOPE_CACHE_HOME"] = cache
+            raw = os.path.abspath(cache)
+            if os.path.basename(raw).lower() == "hub":
+                cache_base = os.path.dirname(raw)
+                cache_hub = raw
+            else:
+                cache_base = raw
+                cache_hub = os.path.join(raw, "hub")
+
+    if cache_base:
+        os.environ["MODELSCOPE_CACHE"] = cache_base
+        os.environ["MODELSCOPE_CACHE_HOME"] = cache_base
+        try:
+            os.makedirs(cache_base, exist_ok=True)
+            os.makedirs(cache_hub, exist_ok=True)
+        except Exception:
+            pass
 
     emit("manifest", modelId=args.model_id, message="准备下载 FunASR 模型...", totalBytes=0, fileCount=0)
 
@@ -98,12 +121,18 @@ def main():
         emit("manifest", modelId=args.model_id, message=f"正在下载标点模型: {punc_model_dir} (4/4)")
         CT_Transformer(model_dir=punc_model_dir, quantize=use_quantize, intra_op_num_threads=1)
 
-        emit("completed", modelId=args.model_id, message="FunASR 模型下载完成", localDir=os.environ.get("MODELSCOPE_CACHE"))
+        emit(
+            "completed",
+            modelId=args.model_id,
+            message="FunASR 模型下载完成",
+            localDir=cache_hub or os.environ.get("MODELSCOPE_CACHE") or "",
+            cacheBase=os.environ.get("MODELSCOPE_CACHE") or "",
+            cacheHub=cache_hub or "",
+        )
 
     except Exception as e:
         emit("error", modelId=args.model_id, message=str(e), traceback=traceback.format_exc())
         sys.exit(1)
 
 if __name__ == "__main__":
     main()
-

desktop/src/asr/asr-cache-env.js

@@ -0,0 +1,66 @@
+import fs from 'fs';
+import path from 'path';
+
+function ensureDir(targetPath) {
+  try {
+    fs.mkdirSync(targetPath, { recursive: true });
+  } catch {
+    // ignore mkdir errors
+  }
+}
+
+export function computeAsrCachePaths({ userDataDir, asrCacheBase }) {
+  const base = asrCacheBase || path.join(userDataDir, 'asr-cache');
+  const hfHome = path.join(base, 'hf-home');
+  const asrCacheDir = path.join(hfHome, 'hub');
+  const msBase = path.join(base, 'modelscope');
+  const msHub = path.join(msBase, 'hub');
+  return {
+    asrCacheBase: base,
+    hfHome,
+    asrCacheDir,
+    modelscopeCacheBase: msBase,
+    modelscopeCacheHub: msHub,
+  };
+}
+
+export function applyAsrCacheEnv({ userDataDir, asrCacheBase, force = false }) {
+  const paths = computeAsrCachePaths({ userDataDir, asrCacheBase });
+
+  // 允许用户通过环境变量强制覆盖；否则用我们计算的默认值/GUI 配置值。
+  if (force || !process.env.ASR_CACHE_BASE) {
+    process.env.ASR_CACHE_BASE = paths.asrCacheBase;
+  }
+
+  if (force || !process.env.HF_HOME) {
+    process.env.HF_HOME = paths.hfHome;
+  }
+
+  if (force || !process.env.ASR_CACHE_DIR) {
+    process.env.ASR_CACHE_DIR = paths.asrCacheDir;
+  }
+
+  if (force) {
+    process.env.MODELSCOPE_CACHE = paths.modelscopeCacheBase;
+    process.env.MODELSCOPE_CACHE_HOME = paths.modelscopeCacheBase;
+  } else if (!process.env.MODELSCOPE_CACHE && !process.env.MODELSCOPE_CACHE_HOME) {
+    process.env.MODELSCOPE_CACHE = paths.modelscopeCacheBase;
+    process.env.MODELSCOPE_CACHE_HOME = paths.modelscopeCacheBase;
+  } else if (!process.env.MODELSCOPE_CACHE_HOME && process.env.MODELSCOPE_CACHE) {
+    process.env.MODELSCOPE_CACHE_HOME = process.env.MODELSCOPE_CACHE;
+  }
+
+  // mkdir（不抛错）
+  ensureDir(process.env.ASR_CACHE_BASE);
+  ensureDir(process.env.HF_HOME);
+  ensureDir(process.env.ASR_CACHE_DIR);
+  if (process.env.MODELSCOPE_CACHE) {
+    ensureDir(process.env.MODELSCOPE_CACHE);
+    ensureDir(path.join(process.env.MODELSCOPE_CACHE, 'hub'));
+  }
+
+  return computeAsrCachePaths({
+    userDataDir,
+    asrCacheBase: process.env.ASR_CACHE_BASE,
+  });
+}

desktop/src/asr/model-cache.js

@@ -87,11 +87,19 @@ export function cleanModelScopeLocks(cacheDir, maxAgeMs = 10 * 60 * 1000) {
 function getModelCacheCandidates() {
   const homeDir = os.homedir();
   const userDataDir = app.getPath('userData');
+  const msEnv = process.env.MODELSCOPE_CACHE || process.env.MODELSCOPE_CACHE_HOME;
+  const msBase = msEnv && path.basename(msEnv).toLowerCase() === 'hub' ? path.dirname(msEnv) : msEnv;
+  const msHub = msBase ? path.join(msBase, 'hub') : (msEnv && path.basename(msEnv).toLowerCase() === 'hub' ? msEnv : null);
+  const appMsBase = path.join(userDataDir, 'asr-cache', 'modelscope');
+  const appMsHub = path.join(appMsBase, 'hub');
+
   return [
-    process.env.MODELSCOPE_CACHE,
+    msHub,
+    msBase,
     process.env.ASR_CACHE_DIR,
     process.env.HF_HOME ? path.join(process.env.HF_HOME, 'hub') : null,
-    path.join(userDataDir, 'asr-cache', 'modelscope', 'hub'),  // model-manager.js 下载位置
+    appMsHub,  // model-manager.js 默认下载位置（ModelScope hub）
+    appMsBase, // model-manager.js 默认下载位置（ModelScope base）
     path.join(userDataDir, 'hf-home', 'hub'),
     path.join(userDataDir, 'ms-cache'),
     homeDir ? path.join(homeDir, '.cache', 'huggingface', 'hub') : null,
@@ -189,4 +197,3 @@ export function resolveFunasrModelScopeCache(preset) {
 
   return { cacheDir: systemMsCache, found: false };
 }
-