知识库维护与扩展

你为一篇文章补了一条新规则，正文更新了，案例与模板却还让人按旧流程做。为什么单页正确，整本手册仍可能把读者带向错误决定？

维护的对象是从问题、推理到实际行动的整条关系。通用方法、平台条件和项目证据变化速度不同，应按影响范围更新，保留每次改选的理由。

从变化的后果推导复核时机

主体、能力、商业模式或正式版本变化，可能改变发布与权益条件；平台公告、SDK、材料驳回和异常也可能提示旧假设失效。立项、申请能力、审核、上线与切换商业模式前复核对应资料，不能只在固定日期机械刷新。

日常可按月整理，但本项目没有自动抓取或定时任务。记录标题、URL、读取日期与范围、变化、适用账号系统、未知项和责任人。资料不可达时保留最后证据并说明状态，寻找官方迁移；不可达既不证明规则消失，也不应被写成已重查。

“建议减少认知负担”还没告诉读者为什么要这样做。应先写新手同时记规则、学操作、选路线时发生什么，再比较全部解释、拆开教学与直接提示的后果，最后说明熟练玩家或探索型玩法为何可能改选。

新章节应让懂开发、未学过相关领域的人跟上：帮助哪个决定；问题如何产生；有哪些不同解释；为什么选该方法；观察什么会支持或推翻；何时不适用。新术语首次出现用普通语言说明，工程类比用于搭桥，不能代替该领域依据。

不强制所有页面使用同样标题。案例展示决策过程，模板解释字段与填写示范，来源和术语保留查阅功能；不应为形式把它们都写成长论文。篇幅服从推导，不用同义句填满段落。

流程与状态可用 Mermaid，路径、布局和时间窗口可用示意图；统计图的比例、单位和区间必须与计算一致。先决定读者需要看清什么关系，再选择图形，避免只把一段话装进很多框。

图放在对应推理旁边，说明它是流程、机制假设还是数据结果；箭头不自动证明因果。虚构图示明确标注，来源只覆盖其实际支持的部分。提供图片替代文本、Mermaid 标题描述，检查手机字号、布局与深浅色；关键状态不只靠颜色区分。

图片放 static，引用可构建路径；正文互链用相对 .md 链接，改名同步引用。侧栏由目录和 _category_.json 排序，不为一个插图另造渲染框架。

核对公式、单位、分母、时间窗、成熟条件与版本。尤其不要把人数和尝试数、毛额和净额、相关和因果混在一起。例子算对只证明推演一致，不能把模拟材料写成真实验证。

真实项目单独保存，标研究同意与访问范围，公开总结去除不必要个人信息，敏感原始材料不进公开站。引入真实数据后保留清洗规则、口径和旧结论修订，才能理解当时为何合理、后来哪个前提改变。

运行 npm run check 核对结构、引用与模拟数据，再运行 npm run build 检查编译和站内链接。但通过构建不能证明推导充分或 Mermaid 在浏览器无误；还需阅读审查，并用 npm run serve 检查生产页面。

抽查或按本次影响遍历图表、长表格、代码、手机导航、深浅色与搜索；核对实际图片、图中文字和可读宽度。部署子目录时依 README 同时设置站点与基础路径，部署后复查深层路由、资源、索引和下载。

改了五十页，就要核对五十页的内容目的与渲染；只检查一篇不能推出全书正确。工具能发现链接与语法问题，不能替你判断每个关键选择是否真的讲了为什么。

练习：挑一条平台或方法结论，写明来源支持范围与自己的推论。若前提变化，列出正文、案例、模板、指标和图中需要同步的地方；无变化也记录实际复核范围，不写“全部已更新”。