dsh-evidence-ledger

面向 DeepSeek Harness 的本地证据账本插件。

它给 DSH agent 提供一个 evidence_ledger 工具，用于把事实、测试结果、决策、失败路径和待验证项记录到工作区内的 JSONL 文件。账本默认位于 .dsh/evidence-ledger.jsonl，只追加、不联网、不删除历史记录。

安装

dsh plugin --profile demo add github:Freakz2z/dsh-evidence-ledger

安装 bundle 后，插件会自动加入 profile。npm 包发布后也可以使用 dsh-evidence-ledger 作为安装 spec；随后用 evidence_ledger 工具记录或检索证据。

工具用法

记录一条已经观察到的测试结果：

{
  "action": "record",
  "kind": "test",
  "status": "verified",
  "claim": "npm test passes",
  "evidence": "node test.mjs exited with code 0",
  "source": "test.mjs",
  "tags": ["release", "ci"]
}

查询最近记录：

{
  "action": "list",
  "query": "release",
  "limit": 10
}

也可以按类型、状态或标签缩小结果：

{
  "action": "list",
  "kind": "test",
  "status": "verified",
  "tag": "ci",
  "limit": 20
}

需要快速查看账本分布时，可以使用 summary：

{
  "action": "summary",
  "status": "verified"
}

支持的 kind：fact、test、decision、failure、note。

支持的 status：observed、verified、rejected、pending。

list 的 kind、status 和 tag 是精确筛选；query 仍会在声明、证据、来源和标签中进行不区分大小写的全文搜索。

summary 使用相同的筛选条件，返回匹配记录总数、按 kind 与 status 聚合的数量，以及最新一条匹配记录。

记录内容应区分“已经看到的证据”和“尚未验证的判断”。插件不会替 agent 判断一条声明是否真实，只负责保存原始记录并提供可检索的来源指针。

配置

默认配置已经足够使用。需要修改文件位置或列表上限时，可以在 profile 的 patch 中覆盖配置：

- id: evidence-ledger
  config:
    path: .dsh/project-evidence.jsonl
    maxResults: 40

path 必须是工作区内的相对路径；插件拒绝绝对路径和逃出工作区的 .. 路径。maxResults 范围为 1–100。

隐私与边界

• 不发起网络请求，也不依赖远程服务。
• 只写入配置的工作区内文件。
• 使用 JSONL 追加记录，历史记录不会被插件自动覆盖或删除。
• 不读取工作区中的其他文件来“推断”证据；写入内容来自工具调用参数。
• 记录前请避免把 token、密码、私钥和完整个人数据放入 claim、evidence 或 source。

开发

npm ci
npm test
npm run pack:check

需要检查真实 Loader 组合时，可在一个已构建的 DeepSeek Harness checkout 中安装本地包：

dsh plugin --profile demo add .

License

MIT