Skip to content

M10 详细设计:跨模块子目录治理与推荐视图通用化

这份详细设计文档用于描述 M10 的核心设计:如何把热点子目录治理从单模块试点推进到跨模块复用,并让治理页开始具备模块级与子目录级双层推荐视图。

设计目标

M10 主要解决三个问题:

  • 如何把子目录治理从单模块试点推进为跨模块可复制动作
  • 如何让治理页区分“累计治理”与“本轮治理”
  • 如何让下一轮推荐从模块级细化到子目录级

一、治理对象选择设计

本轮选择:

  • 00面试相关整理/interviewMap的阅读笔记
  • 05Nodejs/Node入门2

原因:

  • 两个子目录都位于当前治理热点模块中
  • 目录边界清晰,适合直接套用 fix-missing-h1
  • 同时覆盖“面试整理”和“Node.js 学习”两种不同内容结构,便于验证通用性

二、治理配置通用化设计

remediationConfigs 不再只记录模块名,而是补充:

  • title:展示在治理页上的治理范围名称
  • milestone:标记属于哪一轮治理
  • pathPrefix:用于描述子目录治理范围

这样可以同时支持:

  • 累计治理清单
  • 本轮已治理范围
  • 模块治理与子目录治理混合展示

三、推荐视图增强设计

治理页新增“下一批推荐子目录”区块。

这一块不直接依赖新的巡检脚本,而是基于现有 missingTitlePages 做聚合:

  • 模块 / 一级子目录 聚合
  • 统计每个子目录当前缺少一级标题的数量
  • 排除已完成治理配置的子目录
  • 输出最值得继续推进的推荐列表

四、本轮表达设计

治理页中的内容分层如下:

  • 累计治理清单:展示 M7 到 M10 累计做过的治理范围
  • 本轮已治理范围:只展示 milestone === M10 的治理对象
  • 下一批推荐模块:保留模块级治理入口
  • 下一批推荐子目录:给出更细粒度的下一步建议

这种表达方式可以避免“做过的都混在一起”,也能让每轮治理边界更清楚。

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