文档库系统性审计报告(2026-09-09 00:3x)

🕐 时效标注(2026-09-13 文档治理):近期设计件,口径以 TASKS 现行与契约 v1.3 为准。
⛔ 更正(2026-09-09 19:4x · 小冈):本报告两处作废——①缺口第 5 条(membership 状态倒挂)作废:该体系已被决议 23 砍除(09-01 拍板),「缺口不存在」;②缺口第 3 条中「33 处污染」为 v0.9 作废口径,规范 v1.0 已实测校正为 17 处且 G10 第一批已清理。四张清单其余条目维持有效。逐条整改见小齐 WIP-236 复验收(00:5x 批)。
方法:gpt-6-astra 六卷定位图(213 文档骨架,low 档批处理)+ 小冈跨域分析合并。
范围:docs/ 全树 213 份 md(178 万字符)。产出四张清单+治理建议。

一、矛盾清单(现行文档互相冲突)

#冲突涉及文档建议
1福钥数字口径:福钥财务模型 v0.1 的示例数字 vs 福钥真实结算规则 v0.3「数字仅示例以可配置参数为准」福钥财务模型-v0.1(已标过时)/ 福钥真实结算规则 v0.3财务模型标「过时」✓(已标)——但 NOW-REVIEW 确认两文档仍会被同时检索,建议在 v0.1 头部加「已废止跳转 v0.3」横幅
2小程序订阅消息配置指南 vs 消息域站内信框架:前者订阅消息路线已废止,后者「站内信为唯一主触达」archive/小程序订阅消息配置指南 / 消息域站内信框架前者在 archive ✓ 但前端实施手册/状态条文档仍引用其配置步骤——引用方需清引
3退款规则 v0.2 vs 退款插槽终稿 v1.0:v0.2 标「过时」但插槽终稿声称「关联退款规则样板」退款规则样板-v0.2 / 退款插槽终稿-v1.0终稿里的关联链接指向过时文档——改指向 v1.0 自身或删链
4G07 素材标准 v1.1/v1.2 并存:v1.1「数字及删图建议均不可执行」但文件仍在 plans/ 主目录(非 archive)G07-v1.1 / G07-v1.2v1.1 移入 archive/ 或头部加废止横幅(同 1)
5线上收费真实落地方案 v1.0 过时但仍标「现行」的部分条款:与两条收款路径口径有重叠区线上收费真实落地方案 / 两条收款路径实施口径收费方案标过时 ✓——但其「三分法」概念仍被试点作战手册引用——手册改引两条路径口径

二、过时/存档项风险(可能被误引)

#文档风险
1archive/数据库设计.md(34 表旧设计)已被 109 表替代——但新 agent 若先读它会产生错误心智;建议头部加「⚠️ 34 表为旧架构,现库 109 表,以 schema-snapshot.md 为准」
2archive/项目总纲.md vs 项目总纲.md(v1.5 现行)同名文档双份(一存档一现行)——文件名无法区分版本,建议改名 archive 版为 项目总纲-v0.x-存档.md
3plans/2026-09-04-C端接线批次1-接口规格(过时)与「全量接口规格」同名前缀相邻排序——易误读;移 archive/
4C端接线总表与批次规划(存档)同上——「总表与批次规划」名与全量规格易混
5长线计划-C端接线收官表内状态「完成/待执行」并列(astra 定位图自己都标了「需以台账复核」)——该文档状态字段已失真,建议标注「历史计划,状态以 TASKS 为准」

三、缺口清单(应有而缺失)

#缺口影响
1归因/佣金结算规则文档(分销 v2.2/2.3 草案标「待评审」,但 C 端 my-guests/commission-ledger 已接真渲染佣金字段)前端展示的佣金口径无已拍板文档背书
2场景引擎实施细则标「待派工」(迁移 036 已落地、C 端 J 域已接线)——实施细则与实际实现的对齐状态未闭环场景域「文档待派工 vs 代码已实现」状态倒挂
3视觉设计规范 v0.9/v1.0 与 33 处污染清单的处置记录(G10 第一批修 12 处、WIP-233 退回三项的闭环文档)视觉债的台账不在规范文档内,分散在 TASKS
4福钥 L2 配置键的 site_config 三键落地文档(机制 v0.3 定了键名,后端未落库,无跟踪条目)NOW.md 架构待决项之一无工单挂靠
5会员与留存体系(待评审)落点 membership 页已存在 B 类——「待评审」文档与已建页面的状态对齐同 2 的状态倒挂模式
6测试版上传后「种子用户反馈收集」文档(G 系列终点缺一环:上传→分发→反馈→迭代闭环的最后一环无文档)体验版发出去之后的数据/反馈如何回流的流程空白

四、治理建议

  1. 废止横幅制度:所有标「过时/存档」的文档头部加一行 > ⛔ 已废止/存档(YYYY-MM-DD),现行以 XXX 为准——检索时一眼可辨,成本极低
  2. 同名版本分离:项目总纲等「存档版与现行版同名」的文档,存档版改名带版本号(防误读)
  3. 状态倒挂扫描入 verify-c:verify-c.sh 增加第五项——扫描「待派工/待评审」标记的文档对应的代码是否已实现(场景引擎模式),自动产出状态倒挂清单
  4. 引用完整性检查:文档间「关联/依据/取代」链接指向过时文档的,随废止横幅一并清理(本次发现 2 处)
  5. receipts 双文件治理:xiaoyu.md(旧中文)与 xiaoyu.md(活跃)并存已处理(README 说明+扫描器跳过)——建议同样规则写进 receipts/README 供后续新成员查阅

五、方法说明