M10 详细设计:跨模块子目录治理与推荐视图通用化
这份详细设计文档用于描述 M10 的核心设计:如何把热点子目录治理从单模块试点推进到跨模块复用,并让治理页开始具备模块级与子目录级双层推荐视图。
设计目标
M10 主要解决三个问题:
- 如何把子目录治理从单模块试点推进为跨模块可复制动作
- 如何让治理页区分“累计治理”与“本轮治理”
- 如何让下一轮推荐从模块级细化到子目录级
一、治理对象选择设计
本轮选择:
00面试相关整理/interviewMap的阅读笔记05Nodejs/Node入门2
原因:
- 两个子目录都位于当前治理热点模块中
- 目录边界清晰,适合直接套用
fix-missing-h1 - 同时覆盖“面试整理”和“Node.js 学习”两种不同内容结构,便于验证通用性
二、治理配置通用化设计
remediationConfigs 不再只记录模块名,而是补充:
title:展示在治理页上的治理范围名称milestone:标记属于哪一轮治理pathPrefix:用于描述子目录治理范围
这样可以同时支持:
- 累计治理清单
- 本轮已治理范围
- 模块治理与子目录治理混合展示
三、推荐视图增强设计
治理页新增“下一批推荐子目录”区块。
这一块不直接依赖新的巡检脚本,而是基于现有 missingTitlePages 做聚合:
- 按
模块 / 一级子目录聚合 - 统计每个子目录当前缺少一级标题的数量
- 排除已完成治理配置的子目录
- 输出最值得继续推进的推荐列表
四、本轮表达设计
治理页中的内容分层如下:
- 累计治理清单:展示 M7 到 M10 累计做过的治理范围
- 本轮已治理范围:只展示
milestone === M10的治理对象 - 下一批推荐模块:保留模块级治理入口
- 下一批推荐子目录:给出更细粒度的下一步建议
这种表达方式可以避免“做过的都混在一起”,也能让每轮治理边界更清楚。
