M9详细设计:部署知识子目录治理深化
这份文档用于说明 M9 的详细设计。
设计目标
在 M8 完成面试模块连续治理后,顺势切入当前新的高价值安全目标 09构建、运维、后端等/部署相关知识,在不触碰用户本地 Node 工作区的前提下继续降低全站缺少一级标题规模。
为什么选择 09构建、运维、后端等/部署相关知识
- 当前质量报告显示该子目录仍有
17篇文档缺少一级标题,收益明显 - 当前全站热点已经切换到
05Nodejs,但用户本地正在修改Node入门2,本轮需要优先避开该区域 - 该目录包含
linux-centos、ubuntu相关、nginx、pm2等多层分类,适合验证运维/部署类目录的统一命名策略 - 已提前识别到
note、nginx、准备工作等弱语义标题风险,便于本轮一次性收口
业务流程
主流程
- 读取当前质量报告,确认
部署相关知识为本轮治理对象 - 补充
package.json脚本入口 - 执行批量标题修复
- 对修复结果做二次检查,并统一改为
部署知识:<主题>命名 - 执行
docs:sync - 执行
docs:check - 回写开发记录、开发笔记和质量基线
- 完成 Dao Commit 提交
分支流程
如果批量修复后未出现重复标题和指标回归,仍执行统一前缀命名收口,以提升检索语义稳定性。
异常流程
如果出现以下任一情况:
- 标题重复数量增加
- 构建失败
- 校验指标回归
则必须在当前轮次内继续修复,直至 docs:check 重新通过。
结构设计
本轮涉及资产:
package.jsonscripts/docs-quality-baseline.json09构建、运维、后端等/部署相关知识/**/*.mddocs/dao-milestones/01-M9任务拆解-部署知识子目录治理深化.mddocs/dao-milestones/02-M9详细设计-部署知识子目录治理深化.mddocs/dao-milestones/03-M9开发记录-部署知识子目录治理深化.mddocs/dao-milestones/04-M9里程碑开发笔记-部署知识子目录治理深化.md
模块边界
- 仅治理
09构建、运维、后端等/部署相关知识 - 不触碰
05Nodejs/Node入门2及其相关本地改动 - 不修改
scripts/fix-missing-h1.mjs本身 - 不把本轮扩展成跨模块批量治理
自测设计
本轮自测顺序固定为:
npm run docs:fix-h1:deployment-opsnpm run docs:syncnpm run docs:check
全部通过后,才算 M9 当前轮次完成。
