DSH VERIFY KIT · dsh-hashcheck

交付文件校验清单(SHA-256 manifest)

它决定一件事:交付出去的 bytes 和你验收过的 bytes 是否还是同一份。

检查规则

规则判定
changed清单里有、磁盘上也有,但哈希对不上 → error,报前后摘要
missing清单里有、磁盘上没有 → error
unlisted磁盘上有、清单里没有 → warn(交付后混进来的文件)
size-mismatch哈希相同但记录的字节数不符 → warn(顺手核对,极少出现)

用法

npx dsh-hashcheck build ./delivery --out delivery/hashcheck.json --ignore node_modules
npx dsh-hashcheck verify delivery/hashcheck.json --dir ./delivery

真实输入输出

输入
delivery/
├── report.md      ← 交付后有人改了一个字
├── nested.csv
└── hashcheck.json
$ dsh-hashcheck build ./delivery
delivery/hashcheck.json: 2 files, sha256
$ dsh-hashcheck verify delivery/hashcheck.json --dir ./delivery
ok: 2 checked, 0 errors, 1 warnings

# 有人改了 report.md 之后再验:
$ dsh-hashcheck verify delivery/hashcheck.json --dir ./delivery
error changed report.md changed: expected d2f56516fd6c…, found 99527e917f49…
warn unlisted hashcheck.json is on disk but not in the manifest
fail: 2 checked, 1 errors, 1 warnings

出口码:改前 0,改后 1。输出为真实 CLI 运行的逐字结果,由测试与工具保持同步。

出口码:0 干净、1 有发现、2 用法或读文件错误。--json 输出机器可读结果,--warnings-fail 让警告也算失败。DSH 内同样的函数在 POST /hashcheck/api({"text":"…"} 或 {"path":"…"}),面板与 CI 调同一实现,不可能不一致。

这是清单,不是专业人士。每条发现都是文件里可判定的结构缺陷,带行号或路径;它从不说「内容好不好」。
清单本身是确定性的:路径排序、正斜杠、无时间戳,同一目录在任何机器上生成同一份清单,可以直接 diff。 · dsh-verify-kit 全部五个检查