技能｜制度体系版本升版SOP
适用场景
整套文档体系要升版本号（如 v1.4 → v1.5）时。触发词：升版、版本号递增、改名会不会失效、正文版本标记。核心矛盾：文件名带版本号，但数据库里存着这些文件的绝对路径——改名会把链接全部打断。
操作步骤
- 先判断能不能改名：查库里有没有字段存"绝对路径"。有的话，升版不重命名文件，只改正文里的体系版本标记（形如「版本：vX.Y 日期：…」），并同步改日期。
- 精确扫描版本标记：用"版本：vX.Y"这样的模式全库扫描，统计命中处数与命中文件数。典型结果：总册 + 速查 + 各域汇编各 1 处；单篇文档正文通常没有版本标记（只有发文号之类），不要误改。
- 导出基准清单再改：先导出当前版本标记的原文，改完逐条比对，确认"改了且只改了该改的"。
- 干跑 → 执行：干跑打印每处命中与将要变成的文本；确认形态统一无歧义后才执行。改写走"自动备份 → 临时文件 → 原子覆盖"。
- 同步改缓存指纹（最易漏）：如果缓存指纹绑的是"某个源文件的修改时间"，而升版没动那个文件（或那个文件已被弃用），缓存将永不刷新——以后改文档页面也不更新。指纹必须绑定当前真实数据源（如源目录下文档总数 + 最新修改时间）。
- 触发索引重建 + 抽查页面：改完重建语义索引，并抽查总册页确实显示新版本号。
注意边界
- 不覆盖旧版靠"改写前自动备份到日期目录"实现，不必保留多份副本文件名。
- 正式版本号按体系自己规定的评审周期递增；是否提前升版由主人定，不擅自主张。
- 文件名版本与正文版本必须一起看。历史遗留常是"文件名升了、正文没升"，这种假升版最误导人。
反例避雷
- 只改文件名不改正文 → 出现"文件名 v1.4 / 正文 v1.3"的假版本，主人看到的是旧内容。
- 整套重命名 → 数据库路径全失效，页面 404、检索全挂。
- 漏改缓存指纹 → 升版后页面纹丝不动，以为没生效。
- 不导出基准就批量替换 → 无法证明没有误改无关版本号（被引用的其他文件版本）。
- 改完不重建索引 → 问答仍按旧版本答。
关联笔记
- [[技能｜制度条款冲突合并与多文件同步改写SOP]]
- [[技能｜废弃数据源清理三步法]]
实战战绩
2026-09-28 首跑：发现历史遗留"文件名已升 v1.4、正文仍标 v1.3"。本次改为只动正文：12 处标记统一升到 v1.5 并同步日期，导出基准比对后编号与名称零差异；同步把缓存指纹从"废弃副本的修改时间"改为"源目录文档总数+最新修改时间"；事后抽查总册页正确显示 v1.5。
版本记录
| 版本 | 日期 | 变更 |
|---|---|---|
| v1.0.0 | 2026-09-28 | 首版实战固化：判断能否改名→扫标记→基准比对→指纹同步→索引与抽查 |
