2026年5月20日 (三) 13:00的最新版本

模板现代化官方推荐化改造进度

文档信息

文档名称：模板现代化官方推荐化改造进度
创建日期：2026-05-19
最近更新：2026-05-20
维护方式：每次改造后同步更新本页
当前状态：阶段 A/B/C/D 已完成（进入持续治理）

改造目标

对站点模板体系进行官方推荐化现代改造，形成可维护、可扩展、可测试、可协作的模板工程体系。
改造遵循 MediaWiki 官方实践：TemplateData、TemplateStyles、Scribunto（Lua）、/Doc、/sandbox、/testcases、noinclude/includeonly 规范。

分阶段路线（官方推荐化）

阶段 A：模板工程骨架统一（优先）

目标：完成主模板 + 文档 + 样式 + 沙盒/测试子页的标准骨架。
任务：
- 主模板仅保留输出逻辑。
- 文档统一到 `/Doc`。
- 样式统一到 `/styles.css` 并通过 `模板样式的src属性不得为空。` 引入。
- 核心模板补齐 `/sandbox` 与 `/testcases`。

阶段 B：TemplateData 全量补齐（优先）

目标：让 VisualEditor 与 TemplateWizard 自动提供模板参数表单。
任务：
- 为高频模板先补 `<templatedata>`。
- 参数补充：`required`、`suggested`、类型、示例、别名。

阶段 C：复杂逻辑模块化（中期）

目标：把复杂判断与格式化从 wikitext 迁移到 Lua 模块。
任务：
- 保留简单展示模板在 wikitext。
- 复杂分支改为 `#invoke` 调用。
- 控制 `#ifexist` 等昂贵解析函数用量。

阶段 D：治理与质量门禁（持续）

目标：建立持续巡检与发布规范。
任务：
- 建立模板规范页（命名、参数、分类、文档、样式、兼容性）。
- 月度巡检：未文档化模板、缺 TemplateData、分类外溢、核心模板改动告警。

当前优先级与执行顺序

月度巡检执行（SOP + 自动脚本）
关键模板稳定性观察（间歇性 parse rc=139）
新增/变更模板的规范门禁接入（Doc、TemplateData、sandbox、testcases）
持续优化：高复杂模板按需模块化（Lua）

进度看板

阶段	状态	进度	负责人	备注
阶段 A：模板工程骨架统一	已完成	100%	Maintenance script	主模板 27/27 已具备 sandbox + testcases
阶段 B：TemplateData 全量补齐	已完成	100%	Maintenance script	主模板 27/27 已具备 Doc + TemplateData
阶段 C：复杂逻辑模块化	已完成	100%	Maintenance script	四大核心模板模块化完成，三轮回归验收通过（含基线比对）
阶段 D：治理与质量门禁	已完成	100%	Maintenance script	已落地规范页、月度巡检SOP、自动化巡检脚本与月报机制

里程碑日志

2026-05-19

2026-05-20

已完成（阶段C第3轮验收）：项目:模板现代化阶段C调用页回归/2026-05-20-第3轮
- 参数边界验证通过（LanguageLinks、PageToolsLink、Navbox、SoftwareInfo）
- 基线哈希比对：147 样本中 SAME=130，CHANGED=17，最终解析失败=0
已完成（阶段D治理门禁落地）：
- 新增规范页：帮助:模板定义与结构规范
- 新增SOP：项目:模板现代化月度巡检SOP
- 新增月报：项目:模板现代化月度巡检/2026-05
- 脚本落地：`maintenance/template-modernization-monthly-audit.sh`
已完成：新建收尾巡检报告（2026-05-20）项目:模板现代化收尾巡检报告/2026-05-20
下一步：转入月度巡检与异常专项（间歇性 parse rc=139 持续观察）
已完成：数据库备份（含校验）
已完成：模板命名空间依赖关系、调用热度、语法使用情况巡检
已完成：建立本进度文档并写入分阶段改造路线
已完成（阶段A首批-第1批）：
- 更新 `Template:Navbox`、`Template:PageToolsLink`、`Template:SoftwareInfo` 主模板骨架
- 主模板补充 `项目:模板现代化官方推荐化改造进度/Doc` 挂载
- 新建 `sandbox` 与 `testcases` 子页：
  - `Template:Navbox/sandbox` 与 `Template:Navbox/testcases`
  - `Template:PageToolsLink/sandbox` 与 `Template:PageToolsLink/testcases`
  - `Template:SoftwareInfo/sandbox` 与 `Template:SoftwareInfo/testcases`
已完成（阶段B首批-第1批）：
- `Template:Navbox/Doc` 增加 TemplateData
- `Template:PageToolsLink/Doc` 增加 TemplateData
- `Template:SoftwareInfo/Doc` 增加 TemplateData
已完成（阶段A首批-第2批）：
- 更新 `Template:Working`、`Template:LanguageLinks` 主模板骨架
- `Template:Working` 调用页分类改为 `

@@ 第4行： / 第4行： @@
 * 文档名称：模板现代化官方推荐化改造进度
 * 创建日期：2026-05-19
-* 最近更新：2026-05-19
+* 最近更新：2026-05-20
 * 维护方式：每次改造后同步更新本页
-* 当前状态：执行中
+* 当前状态：阶段 A/B/C/D 已完成（进入持续治理）
 == 改造目标 ==
@@ 第41行： / 第41行： @@
 == 当前优先级与执行顺序 ==
+# 月度巡检执行（SOP + 自动脚本）
-# Flow/LQT 迁移模板组（分类外溢治理 + 文档规范化）
+# 关键模板稳定性观察（间歇性 parse rc=139）
-# 课程导航模板组（抽象复用）
-# 其余主模板的 TemplateData 补齐
+# 新增/变更模板的规范门禁接入（Doc、TemplateData、sandbox、testcases）
+# 持续优化：高复杂模板按需模块化（Lua）
-# 阶段 C：Lua 模块化切分
 == 进度看板 ==
@@ 第55行： / 第55行： @@
 |-
 | 阶段 A：模板工程骨架统一
+| 已完成
-| 进行中
-| 68%
+| 100%
 | Maintenance script
-| 核心首批 5 模板已完成主模板骨架 + sandbox/testcases
+| 主模板 27/27 已具备 sandbox + testcases
 |-
 | 阶段 B：TemplateData 全量补齐
+| 已完成
-| 进行中
-| 45%
+| 100%
 | Maintenance script
-| 核心首批 5 模板已补 TemplateData
+| 主模板 27/27 已具备 Doc + TemplateData
 |-
 | 阶段 C：复杂逻辑模块化
+| 已完成
-| 未开始
-| 0%
+| 100%
 | Maintenance script
+| 四大核心模板模块化完成，三轮回归验收通过（含基线比对）
-| 待进入 Lua 模块设计与迁移
 |-
 | 阶段 D：治理与质量门禁
+| 已完成
-| 进行中
-| 15%
+| 100%
 | Maintenance script
+| 已落地规范页、月度巡检SOP、自动化巡检脚本与月报机制
-| 已完成 Flow/LQT 模板组分类外溢治理首批
 |}
 == 里程碑日志 ==
 === 2026-05-19 ===
+=== 2026-05-20 ===
+* 已完成（阶段C第3轮验收）：[[项目:模板现代化阶段C调用页回归/2026-05-20-第3轮]]
+** 参数边界验证通过（LanguageLinks、PageToolsLink、Navbox、SoftwareInfo）
+** 基线哈希比对：147 样本中 SAME=130，CHANGED=17，最终解析失败=0
+* 已完成（阶段D治理门禁落地）：
+** 新增规范页：[[帮助:模板定义与结构规范]]
+** 新增SOP：[[项目:模板现代化月度巡检SOP]]
+** 新增月报：[[项目:模板现代化月度巡检/2026-05]]
+** 脚本落地：`maintenance/template-modernization-monthly-audit.sh`
+* 已完成：新建收尾巡检报告（2026-05-20）[[项目:模板现代化收尾巡检报告/2026-05-20]]
+* 下一步：转入月度巡检与异常专项（间歇性 parse rc=139 持续观察）
 * 已完成：数据库备份（含校验）
 * 已完成：模板命名空间依赖关系、调用热度、语法使用情况巡检
@@ 第107行： / 第118行： @@
 ** Flow/LQT 模板组 8 个模板完成分类外溢治理（分类收敛到 `<noinclude>`）
 ** 已校验上述模板调用区不再外溢 `[[Category:...]]`
-* 下一步：继续推进课程导航模板组与其余模板的 TemplateData 补齐
+* 已完成（阶段A/B第3批：课程导航模板组）：
+** 已规范化主模板并挂载 `/Doc`：`数据结构与算法`、`数据结构与算法(基础概念)`、`线性表`、`栈与队列`、`串、数组和广义表`、`认识 Linux`
+** 上述模板主题分类改为 `<includeonly>`（避免模板页本身被主题分类污染）
+** 已新建 `/Doc` 并补齐 TemplateData：共 6 页
+* 已完成（阶段A/B第4批：站点导航模板组）：
+** 已规范化主模板并挂载 `/Doc`：`Windows版本体系`、`KMS`、`站点帮助文档`、`知识掌握模型`
+** `Windows版本体系`、`KMS`、`站点帮助文档` 主题分类改为 `<includeonly>`
+** 已新建 `/Doc` 并补齐 TemplateData：共 4 页
+* 已完成（阶段A/B第5批：剩余主模板补齐）：
+** 已规范化主模板并挂载 `/Doc`：`2025jzci毕设(论文)`、`西宁 FIRST 随想`、`Welcome`
+** `2025jzci毕设(论文)`、`西宁 FIRST 随想` 主题分类改为 `<includeonly>`
+** 已新建 `/Doc` 并补齐 TemplateData：共 3 页
+* 已完成（阶段A/B第6批：系统模板组）：
+** 已挂载 `/Doc`：`Extension DPL`、`Flow提及` 及 7 个 LQT/Flow 迁移模板
+** 已新建 `/Doc` 并补齐 TemplateData：共 9 页
+* 已完成（阶段D第2批：收尾巡检）：
+** 新建巡检报告：[[项目:模板现代化收尾巡检报告/2026-05-19]]
+** 巡检结论：主模板 `27/27` 已具备 `Doc + TemplateData`
+** 待补 `sandbox + testcases`：22 个模板（已按调用热度排序）
+* 已完成（阶段C准备）：
+** 新建迁移清单：[[项目:模板现代化阶段C Lua模块化清单]]
+** 形成 P0/P1/P2 候选与迁移顺序（Navbox → SoftwareInfo → PageToolsLink → LanguageLinks）
+* 已完成（阶段A第7批：高热模板测试链路补齐）：
+** 已新增 `sandbox + testcases`：`站点帮助文档`、`Windows版本体系`、`数据结构与算法`、`2025jzci毕设(论文)`、`认识 Linux`
+** 当前 `sandbox + testcases` 覆盖率：10/27（37.0%）
+* 已完成（阶段C原型）：
+** 新建 `模块:Navbox`
+** `模板:Navbox/sandbox` 已切换到 `#invoke:Navbox|toolLinks`
+** 已用 `maintenance parse` 验证 sandbox 渲染正常
+* 已完成（阶段A第8批：测试链路补齐第二批）：
+** 已新增 `sandbox + testcases`：`KMS`、`西宁 FIRST 随想`、`Welcome`、`数据结构与算法(基础概念)`、`知识掌握模型`
+** 当前 `sandbox + testcases` 覆盖率：15/27（55.6%）
+* 已完成（阶段C原型第2批）：
+** 新建 `模块:SoftwareInfo`
+** `模板:SoftwareInfo/sandbox` 已切换到 `#invoke:SoftwareInfo|renderSandbox`
+** 已用 `maintenance parse` 验证 sandbox 渲染正常
+* 已更新：[[项目:模板现代化收尾巡检报告/2026-05-19]]（同步最新覆盖率，待补测试链路 12 个）
+* 已完成（阶段A第9批：测试链路补齐第三批）：
+** 已新增 `sandbox + testcases`：`线性表`、`栈与队列`、`串、数组和广义表`
+** 当前 `sandbox + testcases` 覆盖率：18/27（66.7%）
+* 已完成（阶段C原型第3批）：
+** 新建 `模块:PageToolsLink`
+** `模板:PageToolsLink/sandbox` 已切换到 `#invoke:PageToolsLink|renderSandbox`
+** 已用 `maintenance parse` 验证 sandbox 渲染正常
+* 已更新：[[项目:模板现代化收尾巡检报告/2026-05-19]]（同步第三批覆盖率）
+* 已完成（阶段A第10批：系统模板测试链路收尾）：
+** 已新增 `sandbox + testcases`：`Extension DPL`、`Flow提及` 及 7 个 LQT/Flow 模板
+** 当前 `sandbox + testcases` 覆盖率：27/27（100.0%）
+* 已更新：[[项目:模板现代化收尾巡检报告/2026-05-19]]（终版）
+** 巡检结论：阶段 A 与阶段 B 均已完成
+* 已完成（阶段C灰度切换第1轮）：
+** 主模板已切换到模块：`Template:PageToolsLink`、`Template:Navbox`、`Template:SoftwareInfo`
+** 模块路径：`模块:PageToolsLink`、`模块:Navbox`、`模块:SoftwareInfo`
+** 已通过 `maintenance parse` 验证主模板与 sandbox 渲染正常
+* 已完成（阶段C灰度切换第2轮）：
+** 新建模块：`模块:LanguageLinksData`、`模块:LanguageLinks`
+** 主模板与沙盒已切换到 `#invoke`：`Template:LanguageLinks`、`Template:LanguageLinks/sandbox`
+** 已通过 `maintenance parse` 验证主模板与 sandbox 渲染正常
+* 已完成（阶段C回归抽样第1轮）：
+** 抽样验证 `LanguageLinks`、`PageToolsLink`、`SoftwareInfo` 基础渲染链路
+** 发现并修复 `LanguageLinks` 参数兼容问题：模板调用场景改为优先读取 `parent.args.root`
+** 已通过 `maintenance parse` 复测：`{{LanguageLinks|root=示例条目}}` 正常生成 `示例条目/en` 等链接
+* 已新增回归报告：[[项目:模板现代化阶段C调用页抽样回归/2026-05-19-第1轮]]（样本 26，异常 0）
+* 已完成（阶段C回归抽样第2轮-全量）：[[项目:模板现代化阶段C调用页回归/2026-05-19-第2轮]]
+** 全量样本 147/147 成功；4 条样本出现首轮 rc=139，重试后全部通过
+** 已建立基线哈希明细：[[项目:模板现代化阶段C调用页回归/2026-05-19-第2轮/基线哈希]]
+* 下一步：阶段 C 第3轮回归（参数边界与视觉差异人工复核），并跟踪间歇性解析崩溃
 == 风险与注意事项 ==