DEEPSEEK HARNESS · HANDOVER · 0.1.11
项目交接单
dsh-handover-check),这是唯一的 error——而这个 error 是真的。交接人:zjukop3(唯一维护者) 接收人:尚未指定 交接日期:2026-11-19
这份文档写给"如果明天我不在"的那一刻。它不描述项目有多好,只描述接手的人需要知道什么才不会让它烂掉。
交接事项
- 三个仓库的职责边界 — 负责人 zjukop3
- 发布流程与那四段时间常数 — 负责人 zjukop3
- 192 条判定规则的验证状态与 18 个已知缺陷 — 负责人 zjukop3
- 北极星指标为什么是 0,以及不要把它做上去 — 负责人 zjukop3
- 两个待合并的目录条目 — 负责人 zjukop3
1. 三个仓库各自负责什么
| 仓库 | 职责 | 不该放什么 |
|---|---|---|
dsh-vertical-kit | 22 个场景检查,一条规则一个判定 | 需要模型的判断、跨文件推理 |
dsh-verify-kit | 5 个通用检查(表格、引用、大纲、数字、交付文件校验) | 特定行业的词汇 |
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 个包全在册。
账号与权限
- GitHub:
zjukop3,三个仓库 + 上游目录仓库的 fork。交接时需转移仓库所有权,并把 fork 里的开放分支一并说明。 - npm:
zjukop1(注意与 GitHub 用户名不同),27 个包的发布权限。没有 token 存在仓库里,全部走本机~/.npmrc。 - 站点:GitHub Pages,从各仓库
main的site/目录发布,无独立账号。 - 无服务器、无数据库、无付费服务。项目没有任何需要续费的依赖,这是有意的。
未完成事项
- 11 个检查缺第三方真实语料。入口在
.github/ISSUE_TEMPLATE/corpus-report.yml,负责人 zjukop3 docs/MONTHLY-RUNBOOK.md的月度重建,下一次是 12-01,负责人 zjukop3- 两个目录条目等合并,合并后核对覆盖率,负责人 zjukop3
- 没有一个"第二个人"。这件事没有负责人能指派——它需要有人愿意接
签字确认
无。目前没有接收人,所以这份交接单没有生效——按 dsh-handover-check 自己的判定,它现在缺的就是接收人。
dsh-handover-check 校验,唯一的 error 是"没有接收人"。