代理记忆治理库fantasyce/agent-recall-trail

ART — Agent Recall Trail

ART 是一款面向编码代理的本地优先记忆与受治理知识产品。每个 Agent 都拥有一个物理上独立的私有 Recall Trail。稳定的结论会成为不可变的 Knowledge Edition，其他 Agent 可以检索这些版本，而无需看到私有来源身份或来源正文。

ART 0.3.5 通过 stdio MCP 支持 Codex 和 DeepSeek Harness（DSH）。它是独立的：不需要 AAA 适配器、云同步、捆绑模型或自主发布。

产品边界

- 私有记忆属于一个进程绑定的 Agent 身份。
- 共享知识仅包含已提交、已审核的 Edition。
- Agent 可以捕获、召回、读取、提供反馈、创建提案并请求治理。
- 人工治理在 ART 的本地页面中运行。一个显式启用、默认关闭的本地委托策略也允许通过一条明确无歧义的指令进行原子化批准和发布；这些操作被标记为 AgentDelegated，绝不会标记为 Human。
- 撤销、取代、归档和保证仍然是人工操作。
- 存储的内容是证据，绝不是可执行指令或授权。

渐进式召回

ART 暴露一个召回 API，具有四种显式检索模式：lexical、full_scan、semantic 和 hybrid。默认始终是 lexical。一个紧凑的 route 请求可以在有界 recall 之前识别相关的私有和共享主题；确切正文仅由 read 返回。

- lexical 使用本地 BM25 以及精确、token、Jieba 和 CJK 二元组信号。
- full_scan 对每条符合治理条件的规范记录进行排序。它不需要嵌入服务，适用于对完整性敏感、规模较小的存储。
- semantic 仅使用显式配置的嵌入端点和一次性的本地向量投影。
- hybrid 通过所有者可配置、带版本的融合策略组合词法和语义排名。如果可选提供程序或投影不可用，ART 返回未更改的词法结果并报告回退。

ART 的可选嵌入适配器由用户提供和操作。ART 不会仅仅因为某个模型的端点兼容就捆绑、下载、训练、选择该模型或对其质量作出声明。

快速开始

cargo build --release --locked
./target/release/art --home /an/explicit/art-home init --confirm
./target/release/art --home /an/explicit/art-home agent create --id codex-primary --host codex
./target/release/art --home /an/explicit/art-home doctor --agent codex-primary --json

使用 Codex 集成 或 DSH 集成 启动一个绑定的 stdio 子进程。运行 art --help 查看操作员 CLI。

安装

从
最新版本
下载原生归档文件和 SHA256SUMS，
验证归档文件，然后使用解压出的二进制文件运行随附的安装程序：

bash scripts/install.sh --binary /absolute/path/to/art --confirm
art --version
art doctor --agent codex-primary --json

安装程序将可执行文件字节保存在 ~/.across/bin/art 下，在
~/.local/bin/art 创建发现链接，并初始化仅所有者可访问的 ART 数据。它
不会编辑 Codex 或 DSH 配置。轻量级 Codex 插件位于
plugin/agent-recall-trail 下；其 MCP 子进程永久绑定到
codex-primary。在迁移或发布知识之前，请参阅运维文档。

ART 0.3.5 将 art_governance_ui_open 转变为一个精确、可访问的提案
审查工作区，具备安全渲染的 Markdown、原始源代码、锁定溯源、
Edition 比较、冲突安全的决策以及权威发布
回执。它保留了八种规范源锚点类型、持久化委托治理、
针对兼容客户端的独立 Elicitations、受限主机插件发现、
渐进式路由、受治理的全量扫描、可选语义与混合适配器、
确定性 Knowledge Vault 备份、本地审查权限的加密恢复、经验证的
空主目录恢复，以及可复现的词汇 BEIR 门禁。在创建
专用私有 Git 仓库之前，请参阅
运维文档。

配置优先级为 --home，然后是 --config ，然后是仅所有者可访问的用户配置 ~/.across/config/art/config.json，然后是内置的 ~/.across 根目录。根配置仅接受 schema 和 home。可选的嵌入配置隔离在 /config/art/embedding/default.json；可选的排名融合策略位于 /config/art/retrieval/fusion.json；令牌（在需要时）存放在单独的仅所有者可访问文件中。

Agent 可靠性工具包

ART 是一个小型、本地优先的可靠性工具包中的一个独立部分：

- Agent Recall Trail 将私有 Agent 记忆与经过审查的共享知识分开。
- Agent Runtime Proof 验证运行中的 Agent 或 MCP 运行时是否与你批准的制品匹配。
- Agent Residue Evidence 记录测试和构建留下的任务范围文件、进程和监听端口。

每个项目保持可独立安装，并保留各自的信任边界。

社区反馈

真实的 Codex 和 DSH 评估尤其有用。请在设计合作伙伴 issue 中分享合成或
脱敏的工作流程，
包括主机和 ART 版本、尝试的操作以及观察到的
结果。DSH 用户还可以加入
官方社区讨论。
请勿发布凭据、私有知识或完整转录记录。

文档

- 架构
- 记忆与知识模型
- 运维
- 安全模型
- 测试与验收
- 架构决策
- 独立设计评审

所有自动化或手动测试都必须使用显式的、由任务拥有的 ART 主目录。ART 绝不会自动修改 Codex 或 DSH 配置。

采用 Apache-2.0 许可。参见安全、
贡献和支持。