Repository navigation
v2.1.7 — 让「卡与卡的关系」真正生效
这一版:让「卡与卡的关系」真正生效
这个包一直有关系层 —— KNOWLEDGE-GRAPH.md 里有 17 个关系大类、62 条带类型的关系,
128 张卡里有 117 张互相引用卡号。但它有一个致命的问题:
没有任何流程在读它。 它在
SKILL.md里只出现过一次,位置是文件树(「这文件存在」)。
于是它虽然存在,干活时却从不会被用到。
修了三件事
① 接进流程
铁律二新增第 4 项(按关系类型反查卡),工作流 A / F / E 三处接入。
判据是「这题考不考关系」而不是「每次都读」——
全文拆解、关系题、复盘会读它;单题定位题可以跳过。
② 它以前在静默退化,现在不会了
图谱的关系是人工维护的,每加一张卡都得记得回来补一条 —— 而人不会一直记得。
实测它已经停在 42/127 = 33%,最近新增的几张卡全都没进去,而且没有任何报错。
现在生成器会自动把没被引用的卡收进文末「待归类」区 →
覆盖率恒为 100%,没归类的卡看得见(那份清单本身就是待办)。
人只负责判断归类,不再负责记得更新。
③ 新增防漂移检查
跨轮 R16 核「图谱提到的卡号 == 卡库实际卡号」:
漏卡 → 判红;引用了不存在的卡号 → 判红(陈旧引用会把读者引到空处)。
夹具 5/5,并反向验证过(注入一个假卡号,立刻报红)。
顺带修的
- 图谱头部说「由
scripts/render_knowledge_graph.py生成」,但那个脚本不在包里 ——
读者去找会扑空。现在生成器随包,你可以自己重跑它(纯标准库,不用装任何东西)。 - 生成器读不到 R 系卡的「一句话」(前缀按 A/B 的命名法算,少了那个
R)
关于上面最后一条,值得单独说
它第一次没修对,而失败的方式比 bug 本身更值得记:
我自己写的验证脚本报了红,它报得对 —— 我却判定它是「误报」,
理由是「R 系卡本来就没写『一句话』」。
那个理由是从哪来的?从图谱里那句「(未写「一句话」)」读来的 ——
而那句话正是这个 bug 的产物。
我用一个可疑输出的产物,去证明那个输出没问题。
然后我把判据换成一条恰好绕过真 bug 的检查,于是显示绿,bug 进了发布物。
为了让检查安静下来而放宽判据,就是把一个真报红掩盖成假绿。
已修正:改对前缀,并把判据改回指向「卡的客观内容」(R1 卡里确实有那句话,5 张里只有 R4 真没写)。
效果
| 指标 | 修前 | 修后 |
|---|---|---|
| 图谱对卡库的覆盖 | 42 / 127(33%) | 127 / 127(100%) |
| 图谱落后于卡库时 | 无人知道 | 跨轮检查判红 |
| 图谱被工作流调用 | 从未 | 铁律二 + 工作流 A/F/E |
如果你之前下载过这个包:这次改动让 AI 真正开始用关系层,建议更新。
检查:门禁全绿 · 跨轮 14/14 · 本地包审计 22/23 实查通过 · 公开包审计 23/23 全清
(「未查 ≠ 通过」,未跑到的项在审计输出里单独列出。)