# Desktop组件与源码部署

GA主仓拥有后端与整体分发，独立私有Desktop仓只构建桌面组件。两仓不使用子模块，也不互相复制源码。

## Desktop构建

在Desktop仓手动运行 **Build standalone Desktop components**，选择平台；也可使用 `desktop-component-*` 标签。

| 平台 | 组件产物 | 源码部署位置 |
| --- | --- | --- |
| Windows x64 | `GenericAgent.exe` | `frontends/GenericAgent.exe` |
| macOS ARM64 | `GenericAgent-Desktop-macOS-arm64.zip` | 解压为 `frontends/GenericAgent.app` |
| Linux x64 | `GenericAgent-Linux-x86_64.AppImage` | `frontends/GenericAgent.AppImage` |

UI由Tauri内嵌，不依赖 `frontends/desktop/static/`。组件不包含GA、Python或Python依赖。启动时配置已有GA根目录和Python解释器。

mac组件沿用ad-hoc签名，签名校验失败会中止构建；压缩解压后再次验签。它不是Developer ID签名或Apple公证，首次启动可能需要系统设置中手动允许。当前只构建Apple Silicon，不是Intel或Universal版。保持 `.app` 完整，不修改内部文件。

## 部署与发布

**主仓不配置CI；CI仅在Desktop仓构建桌面组件。**

1. 从Desktop Actions下载对应平台产物，核对SHA256和Desktop commit。
2. 将组件放到上表所列的源码部署路径。mac需完整解压 `.app`，不要修改内部文件。
3. 使用已有GA源码、Python环境与依赖启动桌面。
4. Windows发布沿用现有手工/VPS发布SOP；需要分发mac组件时，使用Desktop CI输出的已签名ZIP。

私有仓Actions下载需要认证，产物保留30天。长期分发使用现有二进制发布渠道，不把私有Actions下载页作为公开下载地址。

Desktop CI不打包GA或Python；主仓不承担自动组装、测试或发布任务。