Fable Mode

---

Fable Mode 是面向 AI 编码 Agent 的开源控制平面。

它让 Agent 深思熟虑、提供证据，并经受对抗性审查，然后才允许其写入你的工作区。门禁由机制强制执行，而非依赖提示词建议：没有计时器、没有证明，就没有写入权限。

演示

KERR // ORRERY

一个独立的 HTML 文件。原生 WebGL、零库、零外部资源，也无需构建步骤。

https://github.com/user-attachments/assets/8287bbfe-e3ee-4dcf-ba0f-f9ff22ae79bd

_{最终版本前拒绝了 7 次渲染 · 捕获了 2 个错误 · 通过了 10/10 项红队探测}

Fable Mode 概览

https://github.com/user-attachments/assets/27f4f8a2-b1bb-4398-a08c-bc9fd93d69d7

快速开始

会话启动时处于锁定状态。信心不会解除锁定。

1. 使用以下任一选项安装 MCP 服务。
2. 如果需要完整工作流，可添加可选的 Agent Skill。
3. 让你的 Agent 使用 Fable Mode 完成一项具体的编码任务，并选择时间预算。

新会话启动时，执行权限处于锁定状态：

{
  "action": "create_session",
  "session_name": "demo-refactor",
  "objective": "Refactor the parser without changing public behavior",
  "time_budget_minutes": 2
}

随后，Agent 会记录证据和一条不变量。在权限计时器和证明前提满足之前，提前发起的 unlock_execution 请求会被拒绝。你可以随时使用 get_status 查看当前阶段、剩余时间、证据数量和锁定状态。

同一套门禁会保护每个阶段：为声明提供证据收据、通过五向量红队蜂群审查代码，并密封记录已验证的内容。

一个软件包，两种 Agent 环境

Fable 以一个 PyPI 软件包的形式发布。同一个软件包包含运行时、stdio MCP 服务和完整的 Agent Skill。安装过程明确可控，因此安装 MCP 服务不会悄悄启用工作区指令。

请在 Agent 将要处理的项目中运行设置命令：

uvx --from fable-engine==1.3.9 fable-mode setup --yes

这会在隔离的 uv 环境中解析固定版本的软件包，并将内置技能复制到 .agents/skills/fable-mode。使用 --dry-run 预览，或使用 --target <dir> 指定其他技能目录。若要进行持久安装，请使用：

python -m pip install fable-engine
fable-mode setup --yes

然后，只选择与 Agent 环境相匹配的调用方式。

原生 MCP 客户端

将 fable-engine 作为 stdio 服务运行。例如：

// Claude Code: claude mcp add fable-engine -- uvx --from fable-engine==1.3.9 fable-engine
// Cursor or another JSON-configured client:
{
  "mcpServers": {
    "fable-engine": {
      "command": "uvx",
      "args": ["--from", "fable-engine==1.3.9", "fable-engine"]
    }
  }
}

可联网的 Shell 沙箱，无 MCP 主机

同一软件包还提供直接 JSON 传输。将一个 fable_session 参数对象通过管道传给 fable-mode call：

printf '%s\n' '{"action":"create_session","session_name":"demo","objective":"Verify this change","time_budget_minutes":2}' \
  | uvx --from fable-engine==1.3.9 fable-mode call

该命令使用 JSON Lines：每个输入行包含一个 fable_session 参数对象，每个输出行包含一个 JSON 结果。完整工作流期间请保持该进程运行，以便权限计时器和会话留在同一个可信运行时中。单行管道适用于单次检查调用。每条 uvx 命令都可以解析独立环境；如果沙箱会在多次调用之间保留 Python 环境，则更适合使用 pip install。会话数据会持久保存在该环境之外的 Fable 数据目录中（可通过 FABLE_DATA_DIR 覆盖）。

Python 3.10+，无运行时依赖。已发布到 PyPI，名称为 fable-engine。

技能激活仍需显式进行

setup 是统一的安装方式。较旧的 install-skill 命令仍作为兼容别名保留，仅用于安装技能。fable-engine 和 pip install fable-engine 都不会自行将指令写入工作区。

工作原理

1. 思考 — 由时间锁定的推理。计时器结束前，Agent 不能写入。
2. 举证 — 声明需要真实证据（工具回执、哈希值、不变量）。
3. 攻击 — 红队群组会尝试破坏代码。
4. 编写 — 只有到这时，工作区才会解锁。

可选：AI 证据裁定器

会话中的证据由 AI Agent 编写，因此 Fable 可以选择让外部审核模型在工作区解锁前审核这些证据。仅使用标准库，只进行一次有界 HTTPS 调用，不需要本地模型，也几乎不占用额外 RAM。默认关闭；强制执行时会在失败时关闭。它会增加伪造证据的成本，但无法保证欺骗绝无可能，机械门控仍是主要判定依据。设置方法和诚实的局限说明： AI 证据裁定器。

它不是什么

• 不是对代码完美无缺的保证。这是一套可检查的工作流，而非保证。
• 不是更长的提示词。锁由引擎强制执行，而非由措辞决定。
• 不会造成框架锁定。它支持 MCP，可与当前 Agent 并行运行。

文档

• 从这里开始：实用指南
• Agent Skill 参考
• V1 → V2 迁移
• V2 架构
• System 3（实验性）
• AI 证据裁定器（可选）

贡献

欢迎提交问题和拉取请求。请参阅 CONTRIBUTING.md。

---