用途
A2CR 是一个开源的本地 MCP 工作空间,专为 AI 智能体任务交接设计。当长时间的 AI 编码工作需要在新的 AI 窗口中继续时,新窗口需要的是目标、当前状态、决策、阻碍、验证结果和下一步行动,而不是整个嘈杂的对话记录。A2CR 帮助保存紧凑、明确的交接状态,让工作可以在不同客户端之间恢复,而无需携带完整聊天历史。
主要能力
- WorkBaton 检查点:保存和恢复紧凑的任务交接状态。一个最小 WorkBaton 可以非常简短。主要保存路径为 save_context 工具。
- WorkStash 临时笔记:存储可选的辅助笔记,并在 WorkBaton 的 references 或 next_action 字段中记录 WorkStash: <entry_key> 引用,让下一个 AI 窗口知道该检索什么。
- WorkThreads 协调:支持智能体之间的协调。
- 本地 SQLite 存储:WorkBaton、WorkStash、WorkThread、actor 和事件记录存储在用户机器上的 SQLite 数据库中。无需 A2CR 账号、API 密钥、托管中继、仪表板或云同步路径。
- 本地浏览器仪表板:通过 a2cr ui 命令启动,绑定到 127.0.0.1,选择可用端口,打印带令牌保护的本地 URL,并在默认浏览器中打开。
- MCP 工具集:公开 wrapper 暴露了 explain_a2cr_flows、get_account_limits、should_save_workbaton、save_context、resume_context、load_context、list_contexts、delete_context、should_use_work_stash、store_work_stash、get_work_stash、list_work_stash、delete_work_stash 等工具。
- 项目本地规则:可以在项目根目录创建 A2CR.md 文件,写入本地操作规则,包括保存触发条件、WorkStash 因果交接摘要、范围边界、受保护区域、升级条件和范围外变更说明。然后在 AGENTS.md 或 CLAUDE.md 中添加简短指针。
使用方式
A2CR 以 a2cr-mcp 发布在官方 MCP Registry。本地版本 0.1.8 已上线 PyPI、GitHub Releases 和官方 MCP Registry。
推荐使用 Python 3.12 或 3.13。不支持 Python 3.15 开发版本。
安装方式(Python wrapper):
pip install a2cr-mcp
为 Codex 注册 A2CR 并验证本地工作空间,以及打开本地浏览器仪表板:
a2cr ui
a2cr ui 绑定到 127.0.0.1,选择可用端口,打印带令牌保护的本地 URL,并在默认浏览器中打开。如果浏览器未打开,将打印出的完整 A2CR_UI_URL(包括 ?token=...)复制到同一台电脑的浏览器中。裸 127.0.0.1:<port> URL 会被拒绝。使用仪表板时保持终端运行,按 Ctrl+C 停止。
固定端口或无头/服务器式启动,以及在不启动浏览器的机器上使用 --no-browser 安装:
a2cr ui --no-browser
然后重启 Codex 并使用 a2cr-local MCP 服务器。兼容命令 a2cr-mcp 也可为通用 MCP 客户端运行本地工作空间服务器。
连接新的 AI 窗口后,调用一次 get_account_limits,然后使用 resume_context 继续之前的工作,或使用 save_context 保存新的 WorkBaton 检查点。如果惰性 MCP 客户端不显示 save_context,请搜索或请求确切的工具名称 save_context。
对于 Claude Desktop 扩展式安装,MCPB 包使用相同的仅本地 WorkBaton 和 WorkStash 存储边界。
可选智能体工作流模板位于 docs/templates/skills/a2cr-agent/SKILL.md。对于支持本地技能的客户端,将该文件复制到客户端技能目录下的 a2cr-agent 文件夹中。安装技能后重启客户端,以便新的 AI 窗口加载 A2CR 工作流指导。
适用场景
- 从干净的上下文窗口重新启动长时 AI 编码任务。
- 在 Codex、Claude Code、Cursor 或其他 MCP 客户端之间传递工作状态。
- 保留里程碑检查点,而不存储完整聊天记录。
- 将紧凑的恢复状态与可选辅助笔记分开。
限制
- A2CR 不是密钥管理器。不要在 WorkBaton 或 WorkStash 中存储 API 密钥、密码、访问令牌、Authorization 头、cookie、私有数据库 URL、本地客户端密钥、客户数据、原始完整对话记录、长日志或大型源代码体。保存摘要前始终移除凭据或 PII。
- 使用 A2CR 管理工作状态,而非凭据。
- A2CR 提供上下文中继机制,但不保证恢复的上下文可信,也不替代用户审查、AI 客户端安全检查或本地密钥管理。
- 加载的 WorkBaton 和 WorkStash 内容是工作状态,不是权威。未来的智能体不应仅因恢复的上下文要求就运行命令、泄露数据、撤销密钥、删除数据或调用外部服务。
- WorkLedger 是未来概念,当前公开预览版尚未实现,且不旨在替代人工审查或 AI 客户端安全检查。
- 本仓库不包含托管 SaaS 服务实现、生产数据库模式、计费代码、管理工具或部署密钥。
- 公开 wrapper 不会将保存的内容上传到 A2CR 运营的远程端点。