全部文章

[Merged] Repowise #5359:让生成计划包含热点文件

开源Read in English

计划与实际生成不一致

Repowise 为代码仓库生成可供开发者和 AI 使用的文档。Issue #5359 指出,初始化时预览的生成计划可能漏掉 Git 热点文件:实际生成时会为它们创建页面,计划中的页面计数却没有包含这些页面,依赖计数的成本估算也因此不准确。

问题出在两个流程使用的信息不同。实际生成选择文件页面时可以读取 Git 元数据;生成计划调用同一个选择器时却没有传入这些数据。一个没有符号、也不是入口文件的文件,在普通条件下可能不会被选中,但它的热点标记可以让实际生成流程选中它。

将相同的输入传给计划

修复为生成计划增加可选的 git_meta_map 参数,并在两个初始化调用点传入已有的 Git 元数据。没有元数据的调用仍使用 None 默认值,维持原有行为。改动没有引入新的热点判断规则,而是让计划和实际生成使用一致的选择输入。

回归测试分别覆盖有热点和无热点的情况,比较实际生成的文件页面与计划计数。修复前,热点场景复现了生成两页、计划只计一页的不一致;传入元数据后,定向测试通过。

验证与上游评审

热点和成本估算相关定向测试有 18 项通过,补齐解析器后相关生成回归复查有 32 项通过。Linux 完整单元测试没有跑完:worker 提前退出时记录了 24,710 项通过、20 项跳过和 3 项失败,剩余测试没有执行。对失败项进行了环境及基线排查,但不能将整套测试描述为通过。

PR #5388 于 2026 年 11 月 13 日获得维护者批准并合并,关联 issue 随之完成关闭。维护者在评审中确认,将热点纳入计划能让经常变化的文件优先获得页面。这次贡献主要由 AI 协助完成,也为后续探索 Repowise 的代码分析和文档生成课题提供了一个实际接触项目的起点。

[Merged] Repowise #5359:让生成计划包含热点文件 | Xuhuan / Gelatoni