DEEPSEEK HARNESS · HANDOVER · 0.1.11

项目交接单

配套的两份材料:22 个场景检查的缺陷台账(19 条,每条带复现输入)与 语料状况(哪些检查有真实文件跑过、哪些只有自造样例)。
这份交接单没有生效:接收人一栏写的是「尚未指定」。按它自己校验用的那个检查(dsh-handover-check),这是唯一的 error——而这个 error 是真的。

交接人:zjukop3(唯一维护者) 接收人:尚未指定 交接日期:2026-11-19

这份文档写给"如果明天我不在"的那一刻。它不描述项目有多好,只描述接手的人需要知道什么才不会让它烂掉。

交接事项

  1. 三个仓库的职责边界 — 负责人 zjukop3
  2. 发布流程与那四段时间常数 — 负责人 zjukop3
  3. 192 条判定规则的验证状态与 18 个已知缺陷 — 负责人 zjukop3
  4. 北极星指标为什么是 0,以及不要把它做上去 — 负责人 zjukop3
  5. 两个待合并的目录条目 — 负责人 zjukop3

1. 三个仓库各自负责什么

仓库职责不该放什么
dsh-vertical-kit22 个场景检查,一条规则一个判定需要模型的判断、跨文件推理
dsh-verify-kit5 个通用检查(表格、引用、大纲、数字、交付文件校验)特定行业的词汇
dsh-review-outbox插件本体 + 度量、决策记录、事故复盘、这份交接单任何会被误读成"用户数"的数字

三个仓库共用同一个 format 1 索引源。检查类仓库的分工原则是:能从单个文件判定的放进 kit,需要人判断的不要做成检查。

2. 发布

发布不是 npm publish 就完事。四段时间常数写在 docs/OPERATIONS.md,最少要记住:registry.npmjs.org 的 dist-tag 会滞后一到两分钟;目录仓库的条目合并后要等它自己重建;市场卡片有 24 小时冷却;运行中的 DSH 进程持有旧插件,装完必须重启才生效。

本机 .npmrc 默认指向 npmmirror,所以每条发布命令都要显式 --registry=https://registry.npmjs.org。推送用 npm run push:verified——它读远端比对,不看退出码,因为这台机器到 github.com:443 一直在抖。

3. 规则的验证状态

dsh-vertical-kit/scripts/audit-rules.mjs 要求每条规则在测试里被观察到两个方向。test/dogfood.test.js 要求每个检查在真实文档上不误报。两套都是 npm run check 的一部分,红了就是真红了。

18 个已知缺陷记在 scripts/defects.mjs,站点在 /defects/。其中最该读的是第 12 条和第 17 条:前者是修另一个缺陷时引入的,后者(行号偏上一行)写了十七轮没人发现,因为写 fixture 的人只关心"有没有报"。如果接手后要改判定逻辑,先读这两条。

22 个检查里有 11 个只有自造的样例,没有陌生人的真实文件跑过。名单在 /corpus/。这不是"待办",是"已知未验证"——不要把它们的存在当成质量证明。

4. 指标:为什么是 0,以及别把它做上去

北极星指标是"每周被真正审阅并处置的成果数"。现在是 0,因为没有人真的用过。

docs/adr/ADR-0003 记了为什么不能加 --approve-all:一旦实现者可以随时清空分母,这个数就只剩装饰作用。接手后最容易被做的一件事就是把它做上去——加个批量按钮、把老条目标成 expired,两个都能让面板好看,且都能自动化。两者都不做。

下载数同理,见 ADR-0002:6,200 次/周听起来像有用户,但离散度检查(变异系数 0.186)说明那是一个自动化客户端的一个频率。

5. 两个待合并的条目

dsh-handover-check(PR #16825)与 dsh-expense-claim-check(PR #16902),闸都已过,等上游批量合并队列。合并后跑 npm run catalog:coverage 确认 27 个包全在册。

账号与权限

未完成事项

签字确认

无。目前没有接收人,所以这份交接单没有生效——按 dsh-handover-check 自己的判定,它现在缺的就是接收人。

原文:docs/HANDOVER.md · 由 dsh-handover-check 校验,唯一的 error 是"没有接收人"。