引言

Agent Forge 是开源 MIT 内核加进程外治理的 agent 运行时。这套文档写它当前的行为：一次请求在内核里怎么走、治理能力在哪一层收口、可靠性覆盖到什么范围，以及为什么这样取舍。

内核源自一个 MIT 许可的上游 agent 运行时；上游仓库、锁定 commit 与许可边界见基线可追溯。其余章节只写 Agent Forge 当前行为，不做上游对照。

内容面向要搞懂 Agent Forge 机制的人，以流程、边界和复核口径为主。代码只作辅助，不按源码目录组织内容；除基线专题外，正文不提上游产品名。

专栏与内容

专栏	写什么	常见用途
可靠性	基线锁定的版本与 hash 核对、模块测试覆盖、审计链与 HITL 的指标口径、部署与隔离验收	核对版本可追溯性与隔离是否生效
架构设计	分层、进程外治理、多租户 RLS、Open-Core seam、触发器链与 Effect 约定	先建立整站地图，再下钻专题
内核原理	一次用户输入如何变成工具调用：消息模型、runLoop、Processor 与 LLM 适配、工具系统、配置与权限覆盖	排查主链路问题或改动内核行为
治理机制	HITL、审计链、熔断、RBAC、身份绑定、文件沙箱、保留与观测	接入治理能力或做合规验收
选型对比	五个常被跳过的前提及其对应机制	核对设计取舍的理由

建议阅读顺序

技术评估按下列顺序；整站地图可以提前读：

1. 可靠性 — 先确认基线版本与覆盖范围。
2. 整体技术架构 — 部署拓扑、五层划分、请求路径与治理挂点。
3. 内核原理 — 主链路与工具执行。
4. 治理机制 — 各治理能力如何收口。
5. 架构设计 — 分层细则与隔离边界。
6. 选型对比 — 取舍理由与适用边界。

口径与边界

• 正文只写 Agent Forge 当前行为。文档与实现不一致时，以 agent-forge-runtime 的实现和复现结果为准。
• 中英文同 slug 对应：中文在 /docs/<slug>/，英文在 /en/docs/<slug>/；译文缺失的页面会回退到中文正文。
• 配置项统一 AGENTFORGE_* 前缀；请求头为 X-AgentForge-Tenant-Id、X-AgentForge-Owner-Id、X-AgentForge-Role。