前言¶
在 DeepSeek Harness(DSH)中,workspace instruction files 会影响会话。当出现 nested-workspace boundary 或 instruction budget incident 时,需要先确认哪些 AGENTS.md / CLAUDE.md 文件实际进入了某次会话,而不是只靠猜测。
dsh-instruction-audit 面向这个场景,为 DeepSeek Harness workspace instructions 记录 privacy-minimal receipts。
这是什么¶
dsh-instruction-audit 是一个独立社区 bundle,不是 DeepSeek AI 官方包。它观察 Harness 已经发出的 durable agent-instructions message source,并据此记录 receipts。
仓库地址是 https://github.com/1052326311/dsh-instruction-audit 。
核心功能¶
- 记录 DeepSeek Harness 实际放入 session 的 workspace instruction files 的 receipts。
- 观察 durable
agent-instructionsmessage source。 - 每条 receipt 包含 session id、event sequence/time、baseline flag、logical scope、display path、action 和 producer-owned content digest。
- 不读取 instruction files,不保存 instruction text,不修改 workspace,也不改变 prompt assembly。
- 无 runtime npm dependencies,并使用 active Harness process 提供的 existing Cordis context。
- 可用于审计哪些
AGENTS.md/CLAUDE.md文件影响了 session,包括 nested-workspace boundary 或 instruction budget incidents。 - 提供 CLI,用于读取一个 session 的 receipts。
安装与启用¶
仓库给出的安装示例是先打包,再把 packed tarball 安装到 web profile:
pnpm install
pnpm pack
dsh plugin --profile web add ./dsh-instruction-audit-0.1.1.tgz
默认情况下,receipts 写在 $DSH_HOME/instruction-audit/v1/。文件名为 session id 的 SHA-256 hash;session id 仍保存在每条 JSONL receipt 中。
如果需要把 receipts 写到别的目录,可以配置:
- id: instruction-audit
config:
receiptRoot: /absolute/path/to/receipts
典型用法¶
读取一个 session 的 receipts:
dsh-instruction-audit --session session-123
适用场景与注意¶
适合在以下情况下使用:
1、需要确认某次 session 中哪些 AGENTS.md / CLAUDE.md 文件实际生效。
2、nested-workspace boundary 或 instruction budget incident 发生后,需要查看结构化来源记录。
3、希望保留最小隐私证据,而不是留存 instruction text。
需要注意:
- Receipt 只证明 Harness 记录了结构化来源,不证明模型遵循了指令。
producer-owned content digest不构成 security boundary。--dump-config只证明该 layer 可以组合。- 它会使用当前 Harness 进程提供的 existing Cordis context,安装前建议检查仓库源码与 MIT 许可证。
- 版本
0.1.1已对照 DeepSeek Harness source revision47f943859bef60e4160492346772ded9b24f765a验证。
结尾¶
如果你需要的是对 DeepSeek Harness workspace instructions 的最小留痕,dsh-instruction-audit 提供了一个不读取文件、不保存指令正文、可用 CLI 查询单 session receipts 的插件入口。
仓库地址:https://github.com/1052326311/dsh-instruction-audit