速查卡批量接入流程

适用场景

已有大量"一页一主题"的速查卡小文档（某域的速查/要点卡），需要整体接入系统可检索可展示，同时不能干扰主制度（编号制）的映射关系时。触发词：速查卡、批量接入、卡片页、/docs/cards。

操作步骤

1. 路由入口：app.py 分发器两条——/docs/cards → _docs_cards()（总览），/docs/card?code=<CODE> → _doc_card_view(code)（单卡详情）。
2. 数据源：卡片内容来自 Word 原件，统一经 instlib.word_cards()（返回 code→... 字典）与 instlib.word_card_html(code) 取 HTML；与主制度共用同一套 Word 读取层，不另写解析。
3. 独立命名空间（关键）：卡片按 code[:2] 取域键分组，用 ledgers.SPECS 查域中文名、用 db.institution_names() 把 code 映射成名称。卡片自己的编号空间独立于主制度编号，绝不与主文档共用编号——否则互相覆盖、主文档页 404。
4. 软映射、不反向改写：卡片只显示"来源：对应 Word 速查卡原件"，不当作权威源参与条款级改写（条款改写只认单制度 docx，见条款合并技能）。
5. 展示：T.docs_cards_page(by_dom) 渲染，按域分组展示卡片列表；单卡页 word_card_html 含表格，附"返回速查卡总览 / 家庭制度总册"两个跳转。
6. 写回走同一备份出口：卡片若需回写（修订），复用 docxio.write_back 的自动备份（_备份/<日期>/），不要另写一套写回逻辑。
7. 索引接入：接入后触发一次增量索引；先跑小样本验证命中质量，再全量——质量问题在小样本阶段发现返工成本最低。
8. 回归：全站冒烟 + 主制度 institution_names 的编号总数不变（证明没干扰主体系）。

注意边界

• 卡片是"摘要"，常不含完整条号，不要拿它当权威源去改条款。
• 卡片上不适用"必须恰好命中 1 处"校验（同主题表述重复多），别硬套条款改写那套规则。
• 取 db.institution_names() 失败要有兜底（用 code 本身显示），否则整页崩。

反例避雷

• 与主制度共用编号空间 → 映射互相覆盖，主文档页 404。
• 另写一套写回 → 备份口径不一致，出事无法恢复。
• 拿卡片当权威源改条款 → 改错文件，且卡片与主文档不同步。
• 不做小样本就全量索引 → 命中质量问题被放大，重建成本高。

关联笔记

• [[技能｜AI语义索引质量治理与去重SOP]]
• [[技能｜Word文档纯标准库读写与备份法]]
• [[技能｜全页面回归冒烟法]]

实战战绩

2026-09-28 首跑：79 张速查卡经 instlib.word_cards() 独立扫描接入，/docs/cards 按 code[:2] 分域展示，与主制度映射互不干扰；写回同走统一备份出口；接入后主制度编号总数不变、0 条被顶掉。

版本记录

> ⚠️ 历史归档说明：速查卡功能在系统重构中整体移除（路由 /docs/cards、instlib.word_cards / word_card_html 等已删除），原流程在现行代码中不再适用。按用户 2026-10-03 明确要求「速查卡批量按类别归类，别删除」，本技能从退役记录补回 04 开发正式分类，作为流程知识留存，不删除。 现行如需复用，须先恢复对应代码路由。