桌面应用

Forgexa Desktop 是基于 Tauri 2 和 React 构建的原生桌面工作台。它提供 IDE 风格的环境，让你直接在自己的本地工作目录中审查和驱动 Forgexa 的 工作流 / 质量门禁 / QA 治理 AI Agent——无需浏览器。

应用完全自包含：内置运行时守护进程并自动管理，无需单独安装 CLI。

下载与安装

登录 Forgexa Web 应用，在侧边栏打开 下载 页面。页面会自动识别你的平台，并从 Forgexa Desktop 发布渠道提供最新构建。

平台	格式	说明
macOS	.dmg	通用二进制（Intel + Apple Silicon）
Linux（Debian/Ubuntu）	.deb	Ubuntu 22.04+、Deepin 25
Linux（其他发行版）	.AppImage	x86_64
Windows	.exe（NSIS）、.msi（WiX）	Windows 10+

macOS

1. 打开下载的 .dmg 文件。
2. 将 Forgexa.app 拖入 应用程序 文件夹。
3. 如果 macOS 拦截了未签名的应用，移除隔离属性：

sudo xattr -cr /Applications/Forgexa.app

Linux

# .deb（Debian / Ubuntu / Deepin）
sudo dpkg -i ~/Downloads/forgexa_*.deb

# .AppImage
chmod +x ~/Downloads/forgexa_*.AppImage
./forgexa_*.AppImage

Windows

1. 双击 .exe（或 .msi）安装程序。
2. 如果 Windows SmartScreen 弹出警告，点击 更多信息 → 仍要运行。
3. 按安装向导完成安装。

登录

首次启动时应用会要求登录 Forgexa 账号。正式构建默认连接生产 API；如需连接其他服务器（例如本地后端），可以：

• 在共享的 ~/.forgexa/config 文件中设置 server_url（与 CLI 的 forgexa login 使用同一文件），或
• 直接带环境变量启动原始二进制，例如 FORGEXA_SERVER_URL=http://localhost:8000 "./Forgexa.app/Contents/MacOS/forgexa-desktop"。

界面概览

工作台采用 VS Code 风格布局：

• 活动栏——在 资源管理器、搜索、源代码管理、需求、Agent 视图之间切换；账号与设置位于底部。
• 侧边栏——绑定本地文件夹的文件树、跨文件搜索，或随当前视图切换的需求 / Agent 面板。
• 编辑区——标签页代码编辑器，支持语法高亮、Diff 视图和 Markdown 预览；设置也以标签页形式在此打开。
• 底部面板——集成终端、工作流节点输出流，以及 Problems（来自内置 TypeScript/JavaScript 语言服务器）。
• 状态栏——当前绑定的工作区、关联项目、守护进程连接状态，以及正在运行的 Agent 状态。
• 快速打开（Quick Open）——键盘按文件名跳转到任意文件。

应用有两种模式，通过活动栏切换：

• 需求模式——从列表中选择需求，推进其 AI 驱动的工作流。
• Agent 模式——在绑定的文件夹中进行自由 Agent 对话与代码编辑。

工作区

Forgexa Desktop 基于本机上的一个本地文件夹工作：

1. 点击 Open Folder（状态栏或资源管理器），将本地目录绑定为工作区。
2. 可选：从状态栏 Link to Project，把该文件夹关联到 Forgexa 平台项目——这会把需求、执行和门禁与你的本地文件连接起来。
3. 最近使用的工作区会被记住，通过状态栏的 Switch Workspace 在它们之间切换。

Agent 对话

Agent 视图提供一个对话编辑器，在你的工作区内驱动 AI Agent：

• 用自然语言下达指令；Agent 会读取并编辑绑定文件夹中的文件。
• 工具调用（文件编辑、命令执行）在对话记录中内联展示，敏感操作前会弹出确认提示。
• 正在运行的 Agent 会显示在状态栏，点击即可回到对话。

DeepSeek Harness 的精确 0.2.0-rc.2 构件/Node/平台验收通过后，会出现在既有 Agent 选择器。输出是提交后的 JSONL 消息，不是 token 流；final 只发一次，取消由 AgentHost 监督。原生恢复绑定同一工作区/build/运行配置。图片、原生 fork、只读 review 与并行能力不开放。认证使用外部只读引用，运行状态保存在受管 home；原生 Windows 未启用。参阅 Harness 配置。

需求与工作流

需求视图将平台的需求工作流映射到本地：

• 浏览关联项目的需求，打开后查看详情、描述与变更文件。
• 通过阶段向导（Phase Wizard）推进 AI 驱动的各个阶段，在底部面板实时查看每个工作流节点的输出。
• 门禁待审时进行审阅、查看门禁评分，并跟进交付步骤直至验证完成。
• 需求的 Files 面板只展示该需求的变更，而资源管理器始终展示整个项目。

编辑器、终端与 Git

• 编辑器——从资源管理器打开文件，修改直接保存到磁盘。外部修改（例如 Agent 所为）会被检测到，由你选择重新加载或覆盖保存。Markdown 文件提供渲染预览。
• 终端——底部面板中的真实 Shell，工作目录为工作区文件夹。
• 源代码管理——以彩色 Diff 查看工作区变更，并在 Git 面板中提交。
• Problems——内置语言服务器为打开的 TypeScript/JavaScript 文件提供诊断。

设置与更新

从活动栏（或原生应用菜单）打开 设置。可配置项包括：

• 主题（浅色 / 深色 / 跟随系统）与界面语言
• 服务器地址解析、守护进程状态与开机自启
• 本地输出日志查看与清理
• 更新检查——应用会自动检查 /releases/desktop/latest 渠道，也可手动重新检查

从源码构建

应用从仓库根目录的 desktop/ 目录构建。完整构建指南见 desktop/README.md。简要命令：

cd desktop
npm install
npm run tauri dev      # 开发模式（Vite dev server + Tauri 窗口）

# 正式构建
./desktop/scripts/build-macos.sh    # macOS .dmg
./desktop/scripts/build-linux.sh    # Linux .deb + .AppImage
.\desktop\scripts\build-windows.ps1 # Windows .exe + .msi