@lobehub/chat 1.82.10 → 1.83.0

package/.env.desktop

@@ -3,6 +3,5 @@ APP_URL=http://localhost:3015
 FEATURE_FLAGS=-check_updates,+pin_list
 KEY_VAULTS_SECRET=oLXWIiR/AKF+rWaqy9lHkrYgzpATbW3CtJp3UfkVgpE=
 DATABASE_URL=postgresql://postgres@localhost:5432/postgres
-DEFAULT_AGENT_CONFIG="model=qwen2.5;provider=ollama;chatConfig.searchFCModel.provider=ollama;chatConfig.searchFCModel.model=qwen2.5"
-SYSTEM_AGENT="default=ollama/qwen2.5"
 SEARCH_PROVIDERS=search1api
+NEXT_PUBLIC_SERVICE_MODE='server'

package/.github/workflows/{release-desktop.yml → desktop-pr-build.yml}

@@ -1,9 +1,6 @@
-name: Release Desktop
+name: Desktop PR Build
 
 on:
-#  uncomment when official desktop version released
-#  release:
-#    types: [published] # 发布 release 时触发构建
   pull_request:
     types: [synchronize, labeled, unlabeled] # PR 更新或标签变化时触发
 
@@ -12,6 +9,9 @@ concurrency:
   group: ${{ github.ref }}-${{ github.workflow }}
   cancel-in-progress: true
 
+# Add default permissions
+permissions: read-all
+
 env:
   PR_TAG_PREFIX: pr- # PR 构建版本的前缀标识
 
@@ -19,10 +19,7 @@ jobs:
   test:
     name: Code quality check
     # 添加 PR label 触发条件，只有添加了 Build Desktop 标签的 PR 才会触发构建
-    if: |
-      (github.event_name == 'pull_request' &&
-       contains(github.event.pull_request.labels.*.name, 'Build Desktop')) ||
-      github.event_name != 'pull_request'
+    if: contains(github.event.pull_request.labels.*.name, 'Build Desktop')
     runs-on: ubuntu-latest # 只在 ubuntu 上运行一次检查
     steps:
       - name: Checkout base
@@ -38,7 +35,7 @@ jobs:
       - name: Setup pnpm
         uses: pnpm/action-setup@v2
         with:
-          version: 8
+          version: 9
 
       - name: Install deps
         run: pnpm install
@@ -50,21 +47,14 @@ jobs:
         env:
           NODE_OPTIONS: --max-old-space-size=6144
 
-  #      - name: Test
-  #        run: pnpm run test
-
   version:
     name: Determine version
     # 与 test job 相同的触发条件
-    if: |
-      (github.event_name == 'pull_request' &&
-       contains(github.event.pull_request.labels.*.name, 'Build Desktop')) ||
-      github.event_name != 'pull_request'
+    if: contains(github.event.pull_request.labels.*.name, 'Build Desktop')
     runs-on: ubuntu-latest
     outputs:
       # 输出版本信息，供后续 job 使用
       version: ${{ steps.set_version.outputs.version }}
-      is_pr_build: ${{ steps.set_version.outputs.is_pr_build }}
     steps:
       - uses: actions/checkout@v4
         with:
@@ -82,32 +72,13 @@ jobs:
           # 从 apps/desktop/package.json 读取基础版本号
           base_version=$(node -p "require('./apps/desktop/package.json').version")
 
-          if [ "${{ github.event_name }}" == "pull_request" ]; then
-            # PR 构建：在基础版本号上添加 PR 信息
-            branch_name="${{ github.head_ref }}"
-            # 清理分支名，移除非法字符
-            sanitized_branch=$(echo "${branch_name}" | sed -E 's/[^a-zA-Z0-9_.-]+/-/g')
-            # 创建特殊的 PR 版本号：基础版本号-PR前缀-分支名-提交哈希
-            version="${base_version}-${{ env.PR_TAG_PREFIX }}${sanitized_branch}-$(git rev-parse --short HEAD)"
-            echo "version=${version}" >> $GITHUB_OUTPUT
-            echo "is_pr_build=true" >> $GITHUB_OUTPUT
-            echo "📦 Release Version: ${version} (based on base version ${base_version})"
-
-          elif [ "${{ github.event_name }}" == "release" ]; then
-            # Release 事件直接使用 release tag 作为版本号，去掉可能的 v 前缀
-            version="${{ github.event.release.tag_name }}"
-            version="${version#v}"
-            echo "version=${version}" >> $GITHUB_OUTPUT
-            echo "is_pr_build=false" >> $GITHUB_OUTPUT
-            echo "📦 Release Version: ${version}"
-
-          else
-            # 其他情况（如手动触发）使用 apps/desktop/package.json 的版本号
-            version="${base_version}"
-            echo "version=${version}" >> $GITHUB_OUTPUT
-            echo "is_pr_build=false" >> $GITHUB_OUTPUT
-            echo "📦 Release Version: ${version}"
-          fi
+          # PR 构建：在基础版本号上添加 PR 信息
+          pr_number="${{ github.event.pull_request.number }}"
+          ci_build_number="${{ github.run_number }}" # CI 构建编号
+          version="${base_version}-nightly.pr${pr_number}.${ci_build_number}"
+          echo "version=${version}" >> $GITHUB_OUTPUT
+          echo "📦 Release Version: ${version} (based on base version ${base_version})"
+
         env:
           NODE_OPTIONS: --max-old-space-size=6144
 
@@ -115,7 +86,6 @@ jobs:
       - name: Version Summary
         run: |
           echo "🚦 Release Version: ${{ steps.set_version.outputs.version }}"
-          echo "🔄 Is PR Build: ${{ steps.set_version.outputs.is_pr_build }}"
 
   build:
     needs: [version, test]
@@ -137,43 +107,57 @@ jobs:
       - name: Setup pnpm
         uses: pnpm/action-setup@v2
         with:
-          version: 8
+          version: 9
 
+      # node-linker=hoisted 模式将可以确保 asar 压缩可用
       - name: Install deps
-        run: pnpm install
+        run: pnpm install --node-linker=hoisted
 
       - name: Install deps on Desktop
         run: npm run install-isolated --prefix=./apps/desktop
 
       # 设置 package.json 的版本号
       - name: Set package version
-        run: npm run workflow:set-desktop-version ${{ needs.version.outputs.version }}
+        run: npm run workflow:set-desktop-version ${{ needs.version.outputs.version }} nightly
 
       # macOS 构建处理
       - name: Build artifact on macOS
         if: runner.os == 'macOS'
         run: npm run desktop:build
         env:
-          APP_URL: http://localhost:3010
+          # 设置更新通道，PR构建为nightly，否则为stable
+          UPDATE_CHANNEL: 'nightly'
+          APP_URL: http://localhost:3015
           DATABASE_URL: 'postgresql://postgres@localhost:5432/postgres'
           # 默认添加一个加密 SECRET
           KEY_VAULTS_SECRET: 'oLXWIiR/AKF+rWaqy9lHkrYgzpATbW3CtJp3UfkVgpE='
-        # 公证部分将来再加回
-        #   CSC_LINK: ./build/developer-id-app-certs.p12
-        #   CSC_KEY_PASSWORD: ${{ secrets.APPLE_APP_CERTS_PASSWORD }}
-        #   APPLE_ID: ${{ secrets.APPLE_ID }}
-        #   APPLE_ID_PASSWORD: ${{ secrets.APPLE_ID_PASSWORD }}
+          # macOS 签名和公证配置
+          CSC_LINK: ${{ secrets.APPLE_CERTIFICATE_BASE64 }}
+          CSC_KEY_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
+          NEXT_PUBLIC_DESKTOP_PROJECT_ID: ${{ secrets.UMAMI_NIGHTLY_DESKTOP_PROJECT_ID }}
+          NEXT_PUBLIC_DESKTOP_UMAMI_BASE_URL: ${{ secrets.UMAMI_NIGHTLY_DESKTOP_BASE_URL }}
+
+          # allow provisionally
+          CSC_FOR_PULL_REQUEST: true
+          APPLE_ID: ${{ secrets.APPLE_ID }}
+          APPLE_APP_SPECIFIC_PASSWORD: ${{ secrets.APPLE_APP_SPECIFIC_PASSWORD }}
+          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
 
       # 非 macOS 平台构建处理
       - name: Build artifact on other platforms
         if: runner.os != 'macOS'
         run: npm run desktop:build
         env:
-          APP_URL: http://localhost:3010
+          # 设置更新通道，PR构建为nightly，否则为stable
+          UPDATE_CHANNEL: 'nightly'
+          APP_URL: http://localhost:3015
           DATABASE_URL: 'postgresql://postgres@localhost:5432/postgres'
           KEY_VAULTS_SECRET: 'oLXWIiR/AKF+rWaqy9lHkrYgzpATbW3CtJp3UfkVgpE='
+          NEXT_PUBLIC_DESKTOP_PROJECT_ID: ${{ secrets.UMAMI_NIGHTLY_DESKTOP_PROJECT_ID }}
+          NEXT_PUBLIC_DESKTOP_UMAMI_BASE_URL: ${{ secrets.UMAMI_NIGHTLY_DESKTOP_BASE_URL }}
+
 
-      # 上传构建产物，移除了 zip 相关部分
+      # 上传构建产物
       - name: Upload artifact
         uses: actions/upload-artifact@v4
         with:
@@ -186,18 +170,21 @@ jobs:
             apps/desktop/release/*.AppImage
           retention-days: 5
 
-      - name: Log build info
-        run: |
-          echo "🔄 Is PR Build: ${{ needs.version.outputs.is_pr_build }}"
-
-  # 将原本的 merge job 调整，作为所有构建产物的准备步骤
-  prepare-artifacts:
+  publish-pr:
     needs: [build, version]
-    name: Prepare Artifacts
+    name: Publish PR Build
     runs-on: ubuntu-latest
+    # Grant write permissions for creating release and commenting on PR
+    permissions:
+      contents: write
+      pull-requests: write
     outputs:
       artifact_path: ${{ steps.set_path.outputs.path }}
     steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
       # 下载所有平台的构建产物
       - name: Download artifacts
         uses: actions/download-artifact@v4
@@ -210,66 +197,6 @@ jobs:
       - name: List artifacts
         run: ls -R release
 
-      # 设置构建产物路径，供后续 job 使用
-      - name: Set artifact path
-        id: set_path
-        run: echo "path=release" >> $GITHUB_OUTPUT
-
-  # 正式版发布 job - 只处理 release 触发的场景
-  publish-release:
-    # 只在 release 事件触发且不是 PR 构建时执行
-    if: |
-      github.event_name == 'release' &&
-      needs.version.outputs.is_pr_build != 'true'
-    needs: [prepare-artifacts, version]
-    name: Publish Release
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      # 下载构建产物
-      - name: Download artifacts
-        uses: actions/download-artifact@v4
-        with:
-          path: ${{ needs.prepare-artifacts.outputs.artifact_path }}
-          pattern: release-*
-          merge-multiple: true
-
-      # 将构建产物上传到现有 release
-      - name: Upload to Release
-        uses: softprops/action-gh-release@v1
-        with:
-          tag_name: ${{ github.event.release.tag_name }}
-          files: |
-            ${{ needs.prepare-artifacts.outputs.artifact_path }}/latest*
-            ${{ needs.prepare-artifacts.outputs.artifact_path }}/*.dmg*
-            ${{ needs.prepare-artifacts.outputs.artifact_path }}/*.zip*
-            ${{ needs.prepare-artifacts.outputs.artifact_path }}/*.exe*
-            ${{ needs.prepare-artifacts.outputs.artifact_path }}/*.AppImage
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-  # PR 构建的处理步骤
-  publish-pr:
-    if: needs.version.outputs.is_pr_build == 'true'
-    needs: [prepare-artifacts, version]
-    name: Publish PR Build
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      # 下载构建产物
-      - name: Download artifacts
-        uses: actions/download-artifact@v4
-        with:
-          path: ${{ needs.prepare-artifacts.outputs.artifact_path }}
-          pattern: release-*
-          merge-multiple: true
-
       # 生成PR发布描述
       - name: Generate PR Release Body
         id: pr_release_body
@@ -287,22 +214,22 @@ jobs:
 
             return body;
 
-      # 为构建产物创建一个临时发布
       - name: Create Temporary Release for PR
         id: create_release
         uses: softprops/action-gh-release@v1
         with:
           name: PR Build v${{ needs.version.outputs.version }}
-          tag_name: pr-build-${{ github.event.pull_request.number }}-${{ github.sha }}
+          tag_name: v${{ needs.version.outputs.version }}
+          #          tag_name: pr-build-${{ github.event.pull_request.number }}-${{ github.sha }}
           body: ${{ steps.pr_release_body.outputs.result }}
           draft: false
           prerelease: true
           files: |
-            ${{ needs.prepare-artifacts.outputs.artifact_path }}/latest*
-            ${{ needs.prepare-artifacts.outputs.artifact_path }}/*.dmg*
-            ${{ needs.prepare-artifacts.outputs.artifact_path }}/*.zip*
-            ${{ needs.prepare-artifacts.outputs.artifact_path }}/*.exe*
-            ${{ needs.prepare-artifacts.outputs.artifact_path }}/*.AppImage
+            release/latest*
+            release/*.dmg*
+            release/*.zip*
+            release/*.exe*
+            release/*.AppImage
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
@@ -315,17 +242,12 @@ jobs:
             const releaseUrl = "${{ steps.create_release.outputs.url }}";
             const prCommentGenerator = require('${{ github.workspace }}/.github/scripts/pr-comment.js');
 
-            const body = await prCommentGenerator({
+            const result = await prCommentGenerator({
               github,
               context,
               releaseUrl,
               version: "${{ needs.version.outputs.version }}",
-              tag: "pr-build-${{ github.event.pull_request.number }}-${{ github.sha }}"
+              tag: "v${{ needs.version.outputs.version }}"
             });
 
-            github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: body
-            });
+            console.log(`评论状态: ${result.updated ? '已更新' : '已创建'}, ID: ${result.id}`);

package/.github/workflows/release-desktop-beta.yml

@@ -0,0 +1,196 @@
+name: Release Desktop
+
+on:
+  release:
+    types: [published] # 发布 release 时触发构建
+
+# 确保同一时间只运行一个相同的 workflow，取消正在进行的旧的运行
+concurrency:
+  group: ${{ github.ref }}-${{ github.workflow }}
+  cancel-in-progress: true
+
+# Add default permissions
+permissions: read-all
+
+jobs:
+  test:
+    name: Code quality check
+    # 添加 PR label 触发条件，只有添加了 Build Desktop 标签的 PR 才会触发构建
+    runs-on: ubuntu-latest # 只在 ubuntu 上运行一次检查
+    steps:
+      - name: Checkout base
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 9
+
+      - name: Install deps
+        run: pnpm install
+
+      - name: Lint
+        run: pnpm run lint
+
+  version:
+    name: Determine version
+    runs-on: ubuntu-latest
+    outputs:
+      # 输出版本信息，供后续 job 使用
+      version: ${{ steps.set_version.outputs.version }}
+      is_pr_build: ${{ steps.set_version.outputs.is_pr_build }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      # 主要逻辑：确定构建版本号
+      - name: Set version
+        id: set_version
+        run: |
+          # 从 apps/desktop/package.json 读取基础版本号
+          base_version=$(node -p "require('./apps/desktop/package.json').version")
+
+          # Release 事件直接使用 release tag 作为版本号，去掉可能的 v 前缀
+          version="${{ github.event.release.tag_name }}"
+          version="${version#v}"
+          echo "version=${version}" >> $GITHUB_OUTPUT
+          echo "is_pr_build=false" >> $GITHUB_OUTPUT
+          echo "📦 Release Version: ${version}"
+
+      # 输出版本信息总结，方便在 GitHub Actions 界面查看
+      - name: Version Summary
+        run: |
+          echo "🚦 Release Version: ${{ steps.set_version.outputs.version }}"
+          echo "🔄 Is PR Build: ${{ steps.set_version.outputs.is_pr_build }}"
+
+  build:
+    needs: [version, test]
+    name: Build Desktop App
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        # 暂时先支持 macOS
+        os: [macos-latest]
+    #        os: [macos-latest, windows-latest, ubuntu-latest]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 9
+
+      # node-linker=hoisted 模式将可以确保 asar 压缩可用
+      - name: Install deps
+        run: pnpm install --node-linker=hoisted
+
+      - name: Install deps on Desktop
+        run: npm run install-isolated --prefix=./apps/desktop
+
+      # 设置 package.json 的版本号
+      - name: Set package version
+        run: npm run workflow:set-desktop-version ${{ needs.version.outputs.version }} beta
+
+      # macOS 构建处理
+      - name: Build artifact on macOS
+        if: runner.os == 'macOS'
+        run: npm run desktop:build
+        env:
+          UPDATE_CHANNEL: 'stable'
+          APP_URL: http://localhost:3015
+          DATABASE_URL: 'postgresql://postgres@localhost:5432/postgres'
+          # 默认添加一个加密 SECRET
+          KEY_VAULTS_SECRET: 'oLXWIiR/AKF+rWaqy9lHkrYgzpATbW3CtJp3UfkVgpE='
+          # macOS 签名和公证配置
+          CSC_LINK: ${{ secrets.APPLE_CERTIFICATE_BASE64 }}
+          CSC_KEY_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
+          # allow provisionally
+          CSC_FOR_PULL_REQUEST: true
+          APPLE_ID: ${{ secrets.APPLE_ID }}
+          APPLE_APP_SPECIFIC_PASSWORD: ${{ secrets.APPLE_APP_SPECIFIC_PASSWORD }}
+          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
+
+          NEXT_PUBLIC_DESKTOP_PROJECT_ID: ${{ secrets.UMAMI_BETA_DESKTOP_PROJECT_ID }}
+          NEXT_PUBLIC_DESKTOP_UMAMI_BASE_URL: ${{ secrets.UMAMI_BETA_DESKTOP_BASE_URL }}
+
+      # 非 macOS 平台构建处理
+      - name: Build artifact on other platforms
+        if: runner.os != 'macOS'
+        run: npm run desktop:build
+        env:
+          UPDATE_CHANNEL: 'stable'
+          APP_URL: http://localhost:3015
+          DATABASE_URL: 'postgresql://postgres@localhost:5432/postgres'
+          KEY_VAULTS_SECRET: 'oLXWIiR/AKF+rWaqy9lHkrYgzpATbW3CtJp3UfkVgpE='
+          NEXT_PUBLIC_DESKTOP_PROJECT_ID: ${{ secrets.UMAMI_BETA_DESKTOP_PROJECT_ID }}
+          NEXT_PUBLIC_DESKTOP_UMAMI_BASE_URL: ${{ secrets.UMAMI_BETA_DESKTOP_BASE_URL }}
+
+      # 上传构建产物，移除了 zip 相关部分
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-${{ matrix.os }}
+          path: |
+            apps/desktop/release/latest*
+            apps/desktop/release/*.dmg*
+            apps/desktop/release/*.zip*
+            apps/desktop/release/*.exe*
+            apps/desktop/release/*.AppImage
+          retention-days: 5
+
+  # 正式版发布 job
+  publish-release:
+    needs: [build, version]
+    name: Prepare Artifacts
+    runs-on: ubuntu-latest
+    # Grant write permission to contents for uploading release assets
+    permissions:
+      contents: write
+    outputs:
+      artifact_path: ${{ steps.set_path.outputs.path }}
+    steps:
+      # 下载所有平台的构建产物
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: release
+          pattern: release-*
+          merge-multiple: true
+
+      # 列出所有构建产物
+      - name: List artifacts
+        run: ls -R release
+
+      # 将构建产物上传到现有 release
+      - name: Upload to Release
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: ${{ github.event.release.tag_name }}
+          files: |
+            ${{ needs.prepare-artifacts.outputs.artifact_path }}/latest*
+            ${{ needs.prepare-artifacts.outputs.artifact_path }}/*.dmg*
+            ${{ needs.prepare-artifacts.outputs.artifact_path }}/*.zip*
+            ${{ needs.prepare-artifacts.outputs.artifact_path }}/*.exe*
+            ${{ needs.prepare-artifacts.outputs.artifact_path }}/*.AppImage
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 # Changelog
 
+## [Version 1.83.0](https://github.com/lobehub/lobe-chat/compare/v1.82.10...v1.83.0)
+
+<sup>Released on **2025-04-27**</sup>
+
+#### ✨ Features
+
+- **misc**: Support desktop release framework and workflow.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's improved
+
+- **misc**: Support desktop release framework and workflow, closes [#6474](https://github.com/lobehub/lobe-chat/issues/6474) ([ed97363](https://github.com/lobehub/lobe-chat/commit/ed97363))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ### [Version 1.82.10](https://github.com/lobehub/lobe-chat/compare/v1.82.9...v1.82.10)
 
 <sup>Released on **2025-04-26**</sup>

package/apps/desktop/.i18nrc.js

@@ -0,0 +1,31 @@
+const { defineConfig } = require('@lobehub/i18n-cli');
+
+module.exports = defineConfig({
+  entry: 'resources/locales/zh-CN',
+  entryLocale: 'zh-CN',
+  output: 'resources/locales',
+  outputLocales: [
+    'ar',
+    'bg-BG',
+    'zh-TW',
+    'en-US',
+    'ru-RU',
+    'ja-JP',
+    'ko-KR',
+    'fr-FR',
+    'tr-TR',
+    'es-ES',
+    'pt-BR',
+    'de-DE',
+    'it-IT',
+    'nl-NL',
+    'pl-PL',
+    'vi-VN',
+    'fa-IR',
+  ],
+  temperature: 0,
+  modelName: 'gpt-4o-mini',
+  experimental: {
+    jsonMode: true,
+  },
+});

package/apps/desktop/Development.md

@@ -0,0 +1,47 @@
+## Menu 实现框架
+
+```
+apps/desktop/src/main/
+├── core/
+│   ├── App.ts                // 应用核心类
+│   ├── BrowserManager.ts     // 浏览器窗口管理
+│   └── MenuManager.ts        // 新增：菜单管理核心类，负责选择和协调平台实现
+├── menus/                    // 新增：菜单实现目录
+│   ├── index.ts              // 导出平台实现和接口
+│   ├── types.ts              // 定义菜单平台接口 IMenuPlatform
+│   └── impl/                 // 平台特定实现目录
+│       ├── BaseMenuPlatform.ts // 基础平台类，注入App
+│       ├── DarwinMenu.ts       // macOS 充血模型实现
+│       ├── WindowsMenu.ts      // Windows 充血模型实现
+│       └── LinuxMenu.ts        // Linux 充血模型实现
+├── controllers/
+│   └── MenuCtr.ts            // 菜单控制器，处理渲染进程调用
+```
+
+## i18n
+
+src/main/
+├── core/
+│ ├── I18nManager.ts //i18n 管理器
+│ └── App.ts // 应用主类，集成 i18n
+├── locales/
+│ ├── index.ts // 导出 i18n 相关功能
+│ ├── resources.ts // 资源加载逻辑
+│ └── default/ // 默认中文翻译源文件
+│ ├── index.ts // 导出所有翻译
+│ ├── menu.ts // 菜单翻译
+│ ├── dialog.ts // 对话框翻译
+│ └── common.ts // 通用翻译
+
+主进程 i18n 国际化管理
+使用方式:
+
+1. 直接导入 i18nManager 实例:
+   import i18nManager from '@/locales';
+
+2. 使用翻译函数:
+   import {t} from '@/locales';
+   const translated = t ('key');
+
+3. 添加新翻译:
+   在 locales/default/ 目录下添加翻译源文件

package/apps/desktop/README.md

@@ -0,0 +1,6 @@
+# LobeHub Desktop
+
+构建路径：
+
+- dist: 构建产物路径
+- release: 发布产物路径

package/apps/desktop/build/entitlements.mac.plist

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+    <key>com.apple.security.cs.allow-jit</key>
+    <true/>
+    <key>com.apple.security.cs.allow-unsigned-executable-memory</key>
+    <true/>
+    <key>com.apple.security.cs.allow-dyld-environment-variables</key>
+    <true/>
+  </dict>
+</plist>