Skip to content

M4详细设计:JavaScript跨域子目录治理深化

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

设计目标

M3 已验证 03JavaScript 模块可按子目录稳定治理后,继续推进同模块的第二轮治理,让当前策略从“单点成立”走向“连续成立”。

为什么选择 03JavaScript/前端跨域

根据 03JavaScript 内部热点分布:

  • 前端跨域正则表达式 并列第一梯队热点,均为 9 篇缺少一级标题
  • 它与上一轮同属 03JavaScript 模块,但内容主题不同,能够验证方法是否具备横向适配性
  • 目录本身结构集中,适合保持本轮边界清晰

业务流程

主流程

  1. 确认 前端跨域 为本轮治理对象
  2. 补充专用脚本入口
  3. 执行批量标题修复
  4. 执行 docs:sync
  5. 执行 docs:check
  6. 回写开发记录、开发笔记和基线
  7. 完成 Dao Commit 提交

分支流程

如果治理对象仍然以缺少一级标题为单一主要问题,则继续沿用现有批量修复方式。

异常流程

如果修复后出现以下任一情况:

  • 构建失败
  • 指标回归
  • 页面异常

则必须在当前子任务内修复,直到再次通过校验。

结构设计

本轮涉及资产:

  • package.json
  • scripts/docs-quality-baseline.json
  • 03JavaScript/前端跨域/**/*.md
  • M4 里程碑文档组

模块边界

  • 本轮只治理 03JavaScript/前端跨域
  • 不切入 05Nodejs,避免影响当前用户本地改动区域
  • 不扩展到底层脚本重构

自测设计

本轮自测顺序固定为:

  1. npm run docs:fix-h1:js-cors
  2. npm run docs:sync
  3. npm run docs:check

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

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