Skip to content

M9详细设计:部署知识子目录治理深化

这份文档用于说明 M9 的详细设计。

设计目标

M8 完成面试模块连续治理后,顺势切入当前新的高价值安全目标 09构建、运维、后端等/部署相关知识,在不触碰用户本地 Node 工作区的前提下继续降低全站缺少一级标题规模。

为什么选择 09构建、运维、后端等/部署相关知识

  • 当前质量报告显示该子目录仍有 17 篇文档缺少一级标题,收益明显
  • 当前全站热点已经切换到 05Nodejs,但用户本地正在修改 Node入门2,本轮需要优先避开该区域
  • 该目录包含 linux-centosubuntu相关nginxpm2 等多层分类,适合验证运维/部署类目录的统一命名策略
  • 已提前识别到 notenginx准备工作 等弱语义标题风险,便于本轮一次性收口

业务流程

主流程

  1. 读取当前质量报告,确认 部署相关知识 为本轮治理对象
  2. 补充 package.json 脚本入口
  3. 执行批量标题修复
  4. 对修复结果做二次检查,并统一改为 部署知识:<主题> 命名
  5. 执行 docs:sync
  6. 执行 docs:check
  7. 回写开发记录、开发笔记和质量基线
  8. 完成 Dao Commit 提交

分支流程

如果批量修复后未出现重复标题和指标回归,仍执行统一前缀命名收口,以提升检索语义稳定性。

异常流程

如果出现以下任一情况:

  • 标题重复数量增加
  • 构建失败
  • 校验指标回归

则必须在当前轮次内继续修复,直至 docs:check 重新通过。

结构设计

本轮涉及资产:

  • package.json
  • scripts/docs-quality-baseline.json
  • 09构建、运维、后端等/部署相关知识/**/*.md
  • docs/dao-milestones/01-M9任务拆解-部署知识子目录治理深化.md
  • docs/dao-milestones/02-M9详细设计-部署知识子目录治理深化.md
  • docs/dao-milestones/03-M9开发记录-部署知识子目录治理深化.md
  • docs/dao-milestones/04-M9里程碑开发笔记-部署知识子目录治理深化.md

模块边界

  • 仅治理 09构建、运维、后端等/部署相关知识
  • 不触碰 05Nodejs/Node入门2 及其相关本地改动
  • 不修改 scripts/fix-missing-h1.mjs 本身
  • 不把本轮扩展成跨模块批量治理

自测设计

本轮自测顺序固定为:

  1. npm run docs:fix-h1:deployment-ops
  2. npm run docs:sync
  3. npm run docs:check

全部通过后,才算 M9 当前轮次完成。

共 20 个模块,1301 篇 Markdown 文档。