Agent Recall Trail

ART — Agent Recall Trail

ART 是一款以本地优先的记忆与受治理知识产品，面向编码 Agent。每个 Agent 都拥有一条物理隔离的私有 Recall Trail。稳定结论会成为不可变的知识版本，供其他 Agent 检索，而不会暴露私有来源的身份或内容。

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

产品边界

• 私有记忆属于一个与进程绑定的 Agent 身份。
• 共享知识仅包含已提交并经过审核的版本。
• Agent 可以捕获、回忆、读取、提供反馈、创建提案并请求治理。
• 人类治理在 ART 的本地页面中进行。明确启用的默认关闭本地委派策略，也允许通过一条明确无歧义的指令原子化地批准并发布；这些操作会标记为 AgentDelegated，绝不会标记为 Human。
• Codex 的选择性自动记忆由该页面中另一项默认关闭的全机器范围开关控制。对于获准的轮次，它最多创建一个有界私有候选项；绝不会发布共享知识。
• 撤销、取代、归档和保障措施仍由人类执行。
• 存储的内容是证据，绝不是可执行指令或授权。

渐进式召回

ART 提供一个召回 API，包含四种明确的检索模式：lexical、full_scan、semantic 和 hybrid。默认始终为 lexical。紧凑的 route 请求可以在进行有界 recall 前识别相关的私有和共享主题；只有 read 才会返回精确内容。

• lexical 使用本地 BM25，以及精确匹配、词元、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 桌面端／CLI 集成启动一个绑定的 stdio 子进程。桌面端导出内容包含 MCP 补丁和独立的技能：art integration dsh --desktop --agent <id> --apply --output <new-directory>。运行 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.7 新增了可选择启用的自动记忆功能，包含中立的 Hook 提示词、Agent/Hook 共享价值指引、有界预算、独立验证的证据、基于语义相似度的审核路由和可见诊断信息。它保留了精确且易于访问的提案审核工作区、八种规范的来源锚点类型、持久化的委派治理、兼容客户端各自独立的 Elicitation、受限主机上的插件发现、渐进式路由、受治理的完整扫描、可选的语义和混合适配器、确定性的 Knowledge Vault 备份、本地审核权限的加密恢复、经验证的空主目录恢复，以及可复现的词法 BEIR 门禁。创建专用的私有 Git 仓库之前，请参阅运维文档。

配置优先级依次为 --home、--config <file>、仅所有者可访问的用户配置文件 ~/.across/config/art/config.json，最后是内置的 ~/.across 根目录。根配置仅接受 schema 和 home。可选的嵌入配置单独存放在 <ART_HOME>/config/art/embedding/default.json；可选的排序融合策略存放在 <ART_HOME>/config/art/retrieval/fusion.json；如需令牌，则单独存放在一个仅所有者可访问的文件中。

自动记忆设置单独存储在 <ART_HOME>/config/art/auto-memory.json。缺少配置或无法读取配置时，功能默认禁用。只有操作经过身份验证的治理页面的用户才能更改此设置；MCP 工具可以读取状态，但无法启用该功能。此开关独立于共享知识委派，不影响回忆功能或显式的 art_memory_capture 请求。

Agent 可靠性工具包

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

• Agent Recall Trail 将私有 Agent 记忆与经过审核的共享知识分开保存。
• Agent Runtime Proof 验证运行中的 Agent 或 MCP 运行时是否与获批的制品一致。
• Agent Residue Evidence 记录测试和构建遗留的、按任务划分的文件、进程和侦听端口。

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

社区反馈

真实的 Codex 和 DSH 评估尤其有帮助。完成安装后，可以通过简短的已验证安装报告记录结果。如需深入评估，请在设计合作伙伴议题中分享合成或删减后的工作流，并注明主机和 ART 版本、尝试的操作以及观察到的结果。DSH 用户也可以加入官方社区讨论。 请勿发布凭据、私有知识或完整对话记录。

文档

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

所有自动化或手动测试都必须使用任务专属的 ART home。ART 绝不会自动修改 Codex 或 DSH 配置。

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