dsh-evidence-ledger
DeepSeek Harness 的本地追加式证据账本
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Freakz2z/dsh-evidence-ledger#a430069a7fa192d559508ff0d0054d71b2b67033Evidence Ledger 以 dsh-evidence-ledger 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →面向 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。
npm ci
npm test
npm run pack:check
需要检查真实 Loader 组合时，可在一个已构建的 DeepSeek Harness checkout 中安装本地包：
dsh plugin --profile demo add .
MIT