本地优先的 AI 编程工作台。核心是自研的 Forge Agent 执行引擎，同时可在一个桌面端或 CLI 中使用 Codex、Claude Code 和 Cursor Agent，并统一管理会话、代码变更、Skills、插件、MCP 与自动化。
桌面端下载 · 移动端与消息渠道 · 人才中心 · 5 分钟快速开始 · 操作手册
项目仍处于早期开发阶段。桌面安装包暂未签名，建议先在测试项目中使用。
- 一个界面，多种 Agent：每个任务可选择 Forge、Codex、Claude Code 或 Cursor Agent，无需切换工作环境。
- 过程可见，也可撤回：实时查看工具调用、文件变更与终端输出；按轮次创建检查点，必要时回滚代码或对话。
- 本地优先的安全边界：工作区操作与会话数据库在本机管理，模型请求只发往你配置的服务；文件、命令、网络和软件操作都可设为允许、确认或拒绝。
- 移动端与消息渠道：通过 Channel Gateway 从外部消息平台连接本机 Agent；微信 iLink 是当前首个落地渠道，后续可继续扩展其他平台。
- 可持续扩展：统一管理 Skills、插件、MCP、Hooks、定时自动化与消息渠道，并可在不同 Agent 间分发扩展。
Forge Agent 不是把 Prompt 转发给模型的聊天外壳，而是项目自研的完整 Agent Runtime。它负责理解代码库、组织上下文、驱动模型与工具多轮执行，并把计划、修改、验证和审查串成一条可观察、可控制、可恢复的开发流程。
项目规则 / Git / 相关代码 → 可见计划 → 工具执行 → 测试验证 → 反思纠错 → 交付与回滚
- 真正理解当前项目：自动组合
AGENTS.md、Git 状态与 Diff、@文件、相关代码搜索、Skills、Hooks 和长期记忆，不靠用户反复粘贴上下文。 - 真正执行开发任务：通过文件读写、精准 Patch、命令、网络、软件、MCP 等工具完成“分析 → 修改 → 测试”，编码任务首轮只说不做时会主动要求模型使用工具。
- 复杂任务有编排：内置用户可见计划；只读搜索和子代理可并行，写操作保持顺序并由主代理统一落盘，兼顾速度与一致性。
- 交付前自检：支持独立的
plan、run、review工作流；可选审校模型会依据任务、结果和工具失败证据检查遗漏，发现阻断问题后要求返工。 - 全过程在控制内：流式展示思考、工具调用、文件变化与终端输出；命令和外部操作可确认，任务可取消，每轮可用 Git 检查点回滚。
forge plan "为项目增加登录功能" --cwd /path/to/project
forge run "按计划实现并运行测试" --cwd /path/to/project
forge review --cwd /path/to/projectForge 内置 248 个中文职业人才模板，覆盖 17 个专业领域。你可以从人才市场租用产品经理、架构师、代码审查工程师、设计师、营销专家、安全顾问等 AI 同事，为他们设置姓名、@mention、Skills、工具和权限，再像带团队一样直接派活。
人才市场 → 租用专家 → 绑定 Skills / 工具 → @人才派活 → 团队负责人汇总交付
- 单人接管：
@Nova! 重构登录模块，指定人才带着自己的人设、技能和工具完成整轮任务。 - 多人协作：
@方夏 定义需求 @Lumi 出方案 @老周 审查风险，团队负责人拆分任务、识别依赖并按波次调度。 - 安全并行：无依赖的专家可并行研究；后台人才保持只读，由团队负责人统一写盘、验证和汇总，避免多人同时修改代码造成冲突。
- 可管理的团队：人才支持重命名、启停、技能/工具绑定、严格 Skill 模式和任务统计；项目人才名册可随仓库共享。
| 能力 | 能解决什么问题 |
|---|---|
| 👩 人才中心 / 团队 | 从 248 个专业模板组建 AI 团队，通过 @mention 指定单人或多人协作，并查看派活与汇总进度。 |
| 🤖 Forge Agent（自研） | 自主读取项目、制定计划、调用工具修改代码、运行验证并审查结果，而不只是生成一段回答。 |
| ⇄ 多 Runtime | 在同一个项目和会话界面中切换 Forge、Codex、Claude Code 与 Cursor Agent。 |
| 🔌 插件 | 从 GitHub 搜索和安装能力包，一次带入 Skills、MCP、命令、Hooks 与工作流。 |
| ◆ Skills | 为代码审查、测试、设计、文档等任务加载可复用的专业方法，并按项目启停。 |
| ⚙ MCP | 连接数据库、浏览器和内部系统，把外部工具纳入同一权限与执行时间线。 |
| ⚡ Hooks | 在会话、Prompt、工具调用和压缩等生命周期节点注入规则、运行脚本或阻止危险操作。 |
| 📡 移动端与消息渠道 | 通过统一的 Channel Gateway 接收外部消息、调用本机 Agent 并返回结果；当前已接入微信 iLink，可继续扩展其他平台。 |
| ⏱ 自动化 | 用自然语言或 Cron 创建定时 Agent 任务，保留独立会话、运行记录和结果通知。 |
| 🧩 Extension Hub | 集中管理扩展，并把同一份 Skill / Plugin 部署到 Forge、Codex、Claude Code 和 Cursor。 |
| ↩ 检查点与回滚 | 每轮任务前保存 Git 检查点，可只恢复文件，也可同时撤回后续对话。 |
Forge 的 Channel Gateway 是连接外部消息平台与本机 Agent 的统一入口。渠道收到任务后，会把消息转发到绑定的本地项目，调用 Forge Agent 执行，再将结果返回原渠道；相关会话也会同步显示在桌面端。
外部消息渠道 → Channel Gateway → 本机 Forge Agent → 项目执行 → 原渠道接收结果
- 无需把工作区搬到云端：代码、项目目录、会话和工具仍由本机 Forge 管理。
- 统一接入与管理：不同渠道使用同一套项目绑定、会话、Agent、工具和权限体系。
- 当前已接入微信：微信 iLink 是首个可用渠道，可扫码绑定并收发文字任务。
- 面向更多平台扩展：Channel Gateway 为飞书、钉钉及自定义平台等后续渠道保留统一适配层。
- 清晰的运行边界：电脑需要保持 Forge Daemon 与 Gateway 在线；各渠道支持的消息类型以对应适配器为准。
CI 会为每次通过测试的提交生成安装包：
| 平台 | 安装包 | 下载 |
|---|---|---|
| macOS（Apple Silicon） | .dmg |
下载最新构建 |
| Windows（x64） | .exe |
下载最新构建 |
打开最新成功的 CI 运行，在页面底部 Artifacts 下载 forge-desktop-macos-latest 或 forge-desktop-windows-latest。GitHub Actions 下载可能需要登录 GitHub。
安装、首次启动和系统安全提示见桌面端指南。正式版本发布后会出现在 GitHub Releases。
Expo 在云端打 APK，构建完成后 expo.dev 页面自带安装二维码，手机用流量即可扫码下载，不依赖公司 Wi‑Fi / 隧道 / GitHub。
一次性设置（约 2 分钟）：
cd apps/mobile
pnpm install
pnpm exec eas login # 注册/登录免费 Expo 账号
pnpm exec eas init # 创建 forge-mobile 项目，写入 projectId每次发布：
pnpm publish:mobile:expo
# 或
cd apps/mobile && pnpm exec eas build --platform android --profile preview构建完成后终端会打印 https://expo.dev/accounts/.../builds/... 链接，打开即可看到 Install / 二维码。也可在 expo.dev → Projects → Forge Mobile → Builds 查看。
免费账号有月度构建额度；Android internal 分发 APK 无需 Google Play。
pnpm share:mobile:androidFinder 定位 APK，用微信文件传输助手发到手机安装。
RELAY_HOST=root@你的ECS公网IP pnpm publish:mobile:apk-relay- 系统设置 → 通用 → 共享 → 互联网共享，手机连 Mac 热点。
pnpm serve:mobile:android，手机打开终端打印的地址。
pnpm pack:mobile:android安装时若系统拦截，请在 Android 设置中允许「安装未知应用」。
手机端通过公网 Relay 配对 Desktop；配置见 Relay 部署说明。当前不提供 iOS 侧载包。
CI 也会上传 forge-mobile-android Artifact：Actions 下载
需要 Node.js 22+、pnpm 9+ 和 Git。
git clone https://github.com/guoyang1982/forge-agent.git
cd forge-agent
pnpm install
pnpm build
pnpm link:global
forge init
forge model use openai gpt-4o-mini
forge config set model.apiKey <YOUR_API_KEY>
forge daemon start
forge进入任意代码仓库后，也可以直接运行单次任务：
forge run "解释这个项目并找出最值得先修的问题" --cwd /path/to/project
forge plan "为项目增加登录功能" --cwd /path/to/project
forge review --cwd /path/to/project完整的 Windows 命令、环境变量配置和首次任务示例见快速开始。
| 文档 | 内容 |
|---|---|
| 快速开始 | 安装、模型配置、首次对话与验证 |
| 桌面端指南 | 下载、项目、Runtime、变更审查与回滚 |
| 人才中心与团队派活 | 浏览人才市场、租用专家、绑定能力与多人协作 |
| 移动端与消息渠道 | Channel Gateway、渠道接入、项目绑定、运行条件与安全边界 |
| 移动端 Relay 实施计划 | Channel Gateway 内的 Mobile Adapter、Go Relay 独立部署、E2EE、设备配对与分阶段执行清单 |
| 操作手册 | CLI、会话、Skills、插件、MCP 和常用工作流 |
| 配置参考 | 模型 Profile、环境变量、权限和配置优先级 |
| 自动化指南 | 定时任务、模板、运行记录与排障 |
| Hooks 指南 | 生命周期事件、脚本拦截与上下文注入 |
| Agent 能力与边界 | 子代理、并行执行、检查点与安全边界 |
| 构建与打包 | 开发环境、测试、桌面端打包与排障 |
pnpm build
pnpm test
pnpm smoke
pnpm dev:desktop项目采用 pnpm workspace：apps/desktop、apps/cli 和 apps/daemon 提供客户端与后台服务，packages/ 存放 Agent、工具、会话、配置和扩展能力。