Agent Residue Evidence

Agent Residue Evidence

Agent Residue Evidence（ARE）在 Agent 的测试和构建工作流中增加了一个证据检查点：

observe → Agent reviews evidence → user authorizes cleanup
        → Agent cleans with its own tools → ARE verifies

ARE 会显示任务范围内的文件、目录、归属明确的进程及其监听端口。它绝不会删除文件、停止进程、关闭端口、判定某项内容是否可以安全删除、扫描整台机器、上传数据、使用网络或收集遥测数据。

访问项目网站，运行可复现的任务残留演示，或下载最新的已验证版本。

标准任务

在首次测试或构建之前，Agent 会使用确切的工作区及任何由任务拥有的临时根目录调用 begin_task_observation。事件为可选项；可以通过 append_task_events 发送安全的通用事件或空心跳。在给出最终答复之前，Agent 会调用 end_task_observation，说明候选项并询问用户要如何处理。只有获得明确授权后，Agent 才会使用常规工具进行清理。然后，它会调用 verify_task_residue，重新检查相同的稳定候选项。

NO_CANDIDATES_OBSERVED 仅表示在声明的观察范围内没有发现候选项，并不代表整台主机都干净。

没有基线的已完成任务

inspect_completed_task 接受明确指定的根目录和有界时间窗口。结果始终为 PARTIAL_EVIDENCE；可以使用 Event、回执、推断或未归属的证据，但绝不会声称 BASELINE_OBSERVED。使用 get_residue_report 可读取已保存的报告，而无需再次观察。

每项观察都由不透明的所有者能力隔离。任务 ID、报告 ID、观察 ID 和候选项 ID 仅为显示用引用，绝不能授权访问。状态以加密形式静态存储，文件名不透明；只有通过授权的候选项解析调用才能显示确切路径。短期执行器能力只能追加明确允许的事件类型和根目录别名，不能读取、结束、验证或解析任务。

MCP 接口恰好包含八个工具：

• begin_task_observation
• append_task_events
• end_task_observation
• inspect_completed_task
• get_residue_report
• verify_task_residue
• delegate_task_executor
• resolve_residue_candidate

本项目有意不提供清理、删除、执行、终止或关闭工具。

本地优先的打包方式

一个版本包含原生 CLI/stdio MCP 服务、轻量 Agent Plugin、MCPB、校验和、来源证明及 SPDX SBOM。请参阅快速入门和安装。运行时操作完全在本地离线进行。报告默认保留七天，总容量上限为 100 MB；保留的报告和活动基线均受保护。卸载绝不会悄悄删除报告。

当前版本已发布到官方 MCP Registry，名称为 io.github.fantasyce/agent-residue-evidence。

原生验收通过强制原生 CI 作业覆盖 macOS 14+ arm64、Linux amd64 和 Windows 11 amd64。仅交叉编译不算原生验收。

Agent Reliability Toolkit

ARE 是一个小型、本地优先可靠性工具包中的独立组件：

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

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

社区反馈

真实 Agent 宿主的评估尤为有用。请在设计合作伙伴议题中分享合成或已脱敏的工作流，包括宿主和 ARE 版本、声明的观测范围以及观测结果。DSH 用户也可以加入官方社区讨论。请勿发布凭据、私有路径、原始命令行、环境变量值、专有代码或完整对话记录。

开发

需要 Go 1.26 或 1.27。

bash scripts/check.sh
bash scripts/run_native_acceptance.sh

采用 Apache-2.0 许可证。请参阅安全、贡献指南和原生验收。