ForgeBridge

ForgeBridge

俄语文档

状态：公开 Alpha 版 / Beta 测试。 ForgeBridge 已开放早期真实场景测试， 但尚未发布稳定的生产版本。Alpha/Beta 版本之间的命令、MCP 模式、配置和行为 可能会发生变化。项目将持续更新、修复问题、改进用户体验并添加新功能。

ForgeBridge 是一个本地、权限受控的 MCP Agent，用于在用户拥有且明确授权的计算机上开展开发工作。它专为文件系统编辑、交互式终端、持久化任务、Git 工作流和兼容 AI 客户端上的语义浏览器测试而设计。对于模型驱动的开发，ForgeBridge 提供语义项目检查、Git 读取和经过审核的验证操作，让日常工作无需依赖任意 shell 命令。首先调用 project_inspect，通过一次受限调用了解项目技术栈、Git 状态、主机操作系统和 shell。请参阅以模型为先的工作流。

本仓库正积极开发，目标是推出 v0.1，应视为测试版/Beta 软件。当前状态和已验证的限制记录在实施计划中。欢迎提交问题和反馈；未来版本将继续改善稳定性、入门体验、远程/多设备用户体验和工具覆盖范围。

控制中心

ForgeBridge 内置本地控制中心，方便了解 Agent 正在执行的操作、审核权限、跟踪任务和会话，以及查看审计记录，而无需翻查原始状态文件。

项目	审批

界面支持英语和俄语、深色和浅色主题、响应式布局、实时任务、会话、审批、项目策略，以及由真实本地控制 API 提供支持且经过脱敏处理的审计动态。

项目状态

当前公开版本： v0.1.0-alpha.4 · 发布渠道： next · 预计 v1.0 就绪度： ≈68%

此百分比是加权里程碑估算值，并非质量评分或发布日期。随着主要产品模块从实验阶段迈向 可发布状态，此估算会相应更新。

领域	状态
本地 Agent、权限、审计、文件系统、Git、终端、持久化任务、浏览器	✅ 已发布
控制中心、俄语/英语、主题、生命周期操作、引导式设置	✅ 已发布
跨平台 CI、npm 包、MCP Registry、SBOM/校验和	✅ 已发布
更新 / 修复 / 恢复	🟡 进行中
公共 API 稳定性、迁移、弃用策略	🟡 进行中
多设备 / 远程路由	🟠 下一个主要产品模块
兼容性矩阵 + 独立安全审查	🟠 1.0 前必须完成

下一个里程碑： 0.2.0-beta.1 — 多设备基础、生命周期/更新体验，以及首次兼容性冻结。

查看完整的 通往 1.0 之路。

快速开始

公开 Alpha 包名为 forgebridge；安装后的命令仍为 forgebridge。首个 npm 版本发布后：

npm install --global forgebridge@next
forgebridge init --root /path/to/your/project
forgebridge doctor
forgebridge browser install
forgebridge serve --transport stdio

可以启动 stdio 服务的 MCP 客户端无需全局安装即可运行 ForgeBridge：

npx -y forgebridge@next serve --transport stdio

ForgeBridge 也已准备好通过官方 MCP Registry 以 io.github.t1ktakdev/forgebridge 的名称供发现。浏览器自动化需要经过审查的 Chromium/Chrome/Edge 安装；Windows UI Automation 仍为可选启用。有关特定平台的设置，请参阅 安装与打包。

设计

ForgeBridge 将特权执行控制保留在工作站上：

• 每项操作都由默认拒绝的权限引擎进行检查；
• 路径仅限于规范化的允许根目录；
• 写入审批与确切操作绑定，并设有有效期；
• 终端和任务输出均有长度限制并采用分页；
• 浏览器会话默认相互隔离；
• 默认的 BACKGROUND 执行配置会强制使用无头浏览器，并延后会改变焦点的桌面操作；
• 已尝试和已完成的操作都会写入经过脱敏并以哈希链连接的审计日志。

对于 ChatGPT 网页版，首选的 v0.1 传输方式是 OpenAI Secure MCP Tunnel，它会创建出站 HTTPS 通道，而无需在工作站上开放端口。本地 MCP 客户端可以直接使用 stdio。

请参阅：

• 模型优先的开发工作流
• 研究
• 架构
• 安全模型
• 安全验证矩阵
• Windows 验证记录
• 2026-09-15 模型体验加固验证
• 发布就绪审计
• 权限模型
• 威胁模型
• 安全隧道操作手册
• Windows 自动启动
• 后台执行与焦点保护
• 实施计划

开发

要求：Node.js 22 或更高版本、pnpm 11、Git，以及用于原生验证的 Windows 10/11。

pnpm install
pnpm check
pnpm build
node dist/cli.js init --root C:\src\my-project
node dist/cli.js serve --transport stdio

可信本地开发

对于你明确信任的代码库，ForgeBridge 可以免去对已审核的代码库定义验证的重复批准提示，同时保留相同的规范根目录边界和硬性拒绝规则：

forgebridge project trust C:\src\my-project

这会为每个项目创建一个 FULL 配置，并设置 autonomy: trusted-local。这是有意设计为本地配置：代码库文件无法启用此配置。此后，已审核的 project_check 计划可以无需重新批准即可运行，而破坏性命令、Git push、提权、持久化、访问机密、会产生重大影响的浏览器/Windows 提交，以及任何超出已配置根目录的操作，仍会受到限制或被拒绝。使用 forgebridge project set PATH --mode balanced --autonomy standard 恢复，或使用 forgebridge project remove PATH 移除项目配置。

本地安装

ForgeBridge 以兼容 npm 的 tarball 形式打包，因为 node-pty 是原生依赖项，且 Playwright 浏览器二进制文件因平台而异。发布脚本不会发布任何内容。

pnpm run package:artifact
pnpm run package:validate
.\scripts\install-windows.ps1 -PackagePath .\release\forgebridge-0.1.0-alpha.4.tgz -InstallChromium

此构件包含 CycloneDX SBOM 和 SHA-256 校验和。验证会将实际 tarball 安装到一次性前缀中，并测试已安装的 CLI、MCP stdio、文件系统、终端和无头浏览器路径。请参阅安装和升级说明。

安装后，可选的 Windows 自动启动功能可通过 configure-autostart-windows.ps1 启用。只有在明确完成本地配置后，它才会创建当前用户的计划任务，并使用 Windows DPAPI 存储权限最小化的隧道运行密钥；默认安装程序仍不会创建启动项。

可选的 Windows UI Automation 默认处于禁用状态。在本地配置中将 windowsUiAutomation.enabled 设为 true，即可启用受限的语义 Windows 元素树和控件模式操作。此功能需要已解锁的交互式桌面，且绝不会绕过跨用户或提权边界。在 BACKGROUND 和 GAMING 配置中，更改焦点的操作会被持久延后，并且需要本地批准以及显式切换到 NORMAL。

Agent 绝不会隐式安装自动启动项或后台服务。请勿将其本地 HTTP 端点暴露到网络接口。

在任何公开 Alpha 版本发布前，必须完成发布就绪情况审计中列出的剩余外部验证关卡，包括在独立的干净 Windows VM 上运行、对构件签名以及进行独立安全审查。针对已记录 Windows 配置的 Secure MCP Tunnel/ChatGPT 实时验证已通过。

安全性

ForgeBridge 按设计具有强大能力。获批的任意 shell 拥有运行 Agent 的 OS 帐户的全部权限。为实现隔离，请使用权限较低的专用帐户、Windows Sandbox/VM，或其他由 OS 强制实施的隔离边界。在敏感系统上使用 Agent 前，请阅读 SECURITY.md。

许可证

Apache License 2.0。请参阅 LICENSE。