Sovereign Agent Logbook

主权 Agent 日志簿

每个 AI Agent 都需要一本日志簿。你的日志簿应留在欧洲。

为 AI Agent 打造的开源、防篡改日志簿。它会将 Agent 记录的每个操作、工具调用和人工审批写入你自己的服务上的仅追加、哈希链式文件。每条记录都说明了谁执行了什么、原因是什么、由谁审批以及结果如何。它适用于任何模型（Mistral、GPT-NL、Llama、Claude、GPT……），因为它使用开放的 Model Context Protocol。

v0.1 是一个可用的基础框架，不是成品。 它可以记录、链接、屏蔽秘密信息、验证和导出，并且本页中的每项说明都有测试作为依据。它目前还做不到的事情已如实列在 ROADMAP.md 中。

为什么需要

《欧盟 AI 法案》要求高风险 AI 系统的提供者和部署者保留日志，并确保人类能够进行干预（第 12、14 和 26(6) 条）。这些义务原定于 2026 年 8 月 2 日生效，或对于集成在受监管产品中的 AI，于 2027 年 8 月 2 日生效。随后，《AI 数字综合法案》（法规 (EU) 2026/1744，于 2026 年 7 月 27 日生效）对这些规定作出了调整。大多数高风险系统的生效日期推迟至 2027 年 12 月 2 日，集成在受监管产品中的 AI 则推迟至 2028 年 8 月 2 日。期限推迟了，但义务并未取消。报告严重事件（第 73 条）属于该法案的另一章节，不在此次延期范围内；请核实适用于你系统的时间要求。日志簿会为你提供经验证的 Agent 操作时间线，以便据此进行报告。

自主 Agent 让这些义务更难履行。一个任务可能涉及十次工具调用，而一旦出错，就没人能还原每次调用做了什么、依据谁的审批。

这类工具大多内置于美国云平台，或是为某个模型供应商定制的。如果你运行的是主权方案——在自有硬件上运行开放权重模型——就没有轻巧、中立的工具可直接接入。这就是这样一款工具。

你将获得什么

• 防篡改日志。 每个事件都包含前一条记录的哈希值。修改、插入、删除或重排任一行，logbook verify 都会准确指出位置。(原理：约 80 行代码)
• 适配任何模型、任何主机，也可以完全不使用云服务。 提供四个 MCP 工具： log_event、verify_logbook、recent_events、export_logbook。
• 写入前屏蔽秘密信息。 看起来像密码、令牌、API 密钥、IBAN 或 BSN 的信息，在哈希计算前都会被替换为 ***masked***。
• 通过公开测试证明不向外联网。 测试会阻止 Python 运行时建立出站套接字连接，同时仍能完成完整的写入、验证和导出流程。另一项测试会断言日志簿核心不导入任何 HTTP 客户端。 (tests/test_no_network.py)
• 可直接用于审计的导出内容。 DPO 或审计人员无需使用此工具，就能读取 JSON 和 CSV 文件。
• 开放格式。 SPEC.md 定义了日志格式，与代码分离并采用 Apache 许可证，因此其他工具也能写入该格式。
• Skills 包，教会任何 Agent 何时记录、记录什么，以及何时暂停并询问人工。(skills/sovereign-agent-logbook/SKILL.md)

五分钟安装

pip install sovereign-agent-logbook

通过 stdio 将支持 MCP 的 Agent 主机指向该服务。适用于 Claude Desktop / Claude Code、Cursor、Continue，或任何包含 mcpServers 配置块的主机：

{
  "mcpServers": {
    "logbook": {
      "command": "sovereign-agent-logbook",
      "env": { "LOGBOOK_PATH": "/var/lib/logbook/agent.jsonl" }
    }
  }
}

或者使用 Docker 在自己的设备上将其作为服务运行：

docker build -t sovereign-agent-logbook .
docker run -d --name logbook \
  -p 127.0.0.1:8765:8765 \
  -v logbook-data:/data \
  sovereign-agent-logbook
# MCP endpoint: http://127.0.0.1:8765/mcp   (put TLS in front for anything beyond localhost)

然后，任何时候都可以由人工执行：

logbook --path /var/lib/logbook/agent.jsonl verify
logbook --path /var/lib/logbook/agent.jsonl export --format csv > audit.csv
logbook --path /var/lib/logbook/agent.jsonl tail --limit 10

事件示例

{"spec":"0.1","seq":42,"id":"…","ts":"2026-11-05T20:41:03.123456+00:00",
 "prev_hash":"9f2c…","hash":"3a1b…",
 "agent_id":"invoice-bot","model":"mistral-small-4",
 "action":"pay_invoice","arguments":{"amount":1250,"iban":"***masked***"},
 "reason":"Invoice 2026-118 matches PO 4471 and is under the auto-approval limit",
 "approval":"auto","approved_by":null,"approval_rule":"pay-under-2000-matched-po",
 "outcome":"success","result_summary":"Paid via bank API, ref 88213",
 "run_id":"task-7f3e","tags":["finance"]}

字段含义以 SPEC.md 中的规范定义为准。

信任：没有黑箱

我们的承诺	你可以如何自行验证
篡改可检测	编辑日志簿文件中的任意一行，然后运行 logbook verify
不连接外部网络	tests/test_no_network.py；Dockerfile 不添加网络工具
测试公开，并在每次更改时运行	上方的 CI 徽章链接到每次运行记录
我们会说明它不能防范什么	THREAT-MODEL.md
我们会说明它有助于遵守哪些《AI 法案》条款，以及哪些条款不适用	docs/ai-act-mapping.md
格式的生命周期长于软件	SPEC.md，Apache-2.0
安全问题有处理流程	SECURITY.md
决策均有记录	ROADMAP.md，CHANGELOG.md

不依赖单一平台

大多数开发者都会查看 GitHub，因此这里是主要代码仓库。 我们计划在欧盟托管的基础设施上建立一个完全相同的镜像，以确保代码 不依赖单一平台；目标平台正在遴选中，确定后会记录在 ROADMAP.md 中。在此之前，git clone 可为你提供一份 完整副本——这正是 git 的意义所在。

托管版本

如果你不想自行运行服务，我们计划推出一个托管版本，使用仅位于欧盟的 基础设施（德国 Hetzner / 法国 Scaleway），并提供保留策略、每日签名锚定链以及每月审计导出。 delfen.ai/logbook 上提供的条款为： 每月 €29（不含增值税），免费试用 30 天，可随时取消；如果托管版本在试用期结束时仍未上线， 则会取消试用，而不会收费。

许可

Apache License 2.0。由 Delfen 在荷兰开发。 欢迎贡献——请参阅 CONTRIBUTING.md。