目录图
每张卡片代表一个目录。各列把目录分为 Occasional changes 和 Frequent changes,其中频繁指按变更的 pull request 数量排名前四分之一的目录。各行则按抽样函数是否被标记来划分目录。
每张卡片显示其 changed PRs,以及(如果有的话)其 linked fixes。在一个分组内,关联修复更多的目录排在前面。有历史记录但没有 JavaScript 或 TypeScript 抽样的目录,会列在地图之外的 Structure not measured 下;Find a directory 可筛选该列表。当仓库中没有任何文件可供抽样时,地图会改为显示 Function analysis is not available yet。
选择一张卡片可打开 Area detail:Changed PRs、JS/TS files checked、Linked fix PRs、该目录出现的原因、Files sampled 及其被标记的函数,以及 PR and issue evidence。证据列表中的每个 PR 都会标记为 Linked to a bug issue、Bug-fix wording in the title 或 Changed this area。
计算方式
- 历史: 已合并的 pull request。首次扫描覆盖前 30 天,之后新合并的 pull request 会延长该范围,最长一年。当某一周有 100 个或更多 pull request,或其中一些无法完整读取时,该标签页会显示 Sampled history (up to 100 PRs per week)。
- 刷新: 后台作业每两小时运行一次。在某个仓库的首次扫描完成之前,该标签页会显示 History scan in progress。
- 函数: Kodus 从默认分支读取最多 60 个 JavaScript 和 TypeScript 文件,每个目录最多三个,优先读取变更最多的。它会跳过超过 150,000 个字符的文件以及有语法错误的文件。当函数达到 80 行或更多、12 个或更多分支,或嵌套层级为 4 或更多时,会被标记。
- 关联修复: 变更了该目录、且其描述关闭了同一仓库中带有 bug、defect 或 regression 标签的 issue 的 pull request(例如
fixes #123)。它们增加了历史记录。它们并不显示缺陷从何处开始,也不预测未来的 bug。
命令行
kodus cockpit code-areas --repo org/repo 会在终端中显示此标签页。参阅 CLI 命令。