描述

背景

大型工程中存在"枢纽文件"（聚合再导出的 Index.ets、公共类型、底层工具模块等），被大量文件传递依赖。修改这类文件时增量构建会把整个传递依赖锥拖入重查/重编，"改一个文件、重编上万"，增量退化为接近全量。事后从构建耗时只能知道"发生了大范围重编"，无法直接回答哪些文件是雷。

方案

新增环境变量门控的诊断打点 LINT-HUB-RANK：设 ARKTS_LINT_HUB_RANK=1 跑一次全量构建，利用 builder state 的完整依赖图（referencedMap）输出按传递依赖锥大小排名的枢纽文件清单（每文件含直接依赖者数、精确锥大小、锥内样例），为依赖治理（拆分再导出面/降耦合）提供量化目标清单。

• 算法两阶段控制成本：O(V+E) 统计全部文件直接依赖者数，仅对 Top-K（ARKTS_LINT_HUB_RANK_TOP，默认 20）做反向 BFS 求精确锥；4.3 万文件工程估算一次性 2~6 秒；
• 1.0/1.1 两个 linter 均接入，每次 linter 运行输出一行单行 JSON；
• 纯只读打点：try/catch 包裹，不改变任何编译/lint 行为，不读写 .tsbuildinfo，默认（未设环境变量）零开销；
• 设计文档：docs/design/arkts-lint-hub-rank.md（用法/算法/兼容性/测试）。

已验证

• 链式依赖 harness（a←b←c、a←d）：a.ts 直接依赖 2/锥 3，b.ts 1/1，无依赖文件不入榜——数值与拓扑精确一致（打包产物实测）；
• 未设环境变量零输出；ARKTS_LINT_HUB_RANK_TOP=1 仅输出榜首；
• 两文件 tsc 类型检查 0 错误。

Issue

Issue: None

自测试用例

一、tsc测试套

1. tsc原生测试

• 已通过
• 不涉及，无需验证
  纯新增打点，不影响编译行为

2. ts_extra_test

• 已通过
• 不涉及，无需验证

二、ArkTSLinter测试套

1. 三方库测试

• 已通过
• 不涉及，无需验证

2. Cookbook+issue测试

• 已通过
• 不涉及，无需验证

3. ArkTest测试

• 已通过
• 不涉及，无需验证
  建议CI跑一遍确认无回归（改动为纯增量日志，预期无影响）

三、 编译测试

1. 端到端测试

• 已通过
• 不涉及，无需验证
  建议在大型工程全量构建时设 ARKTS_LINT_HUB_RANK=1 验证输出与耗时（预估 2~6s）

CheckList

1. 是否影响abc文件

• 影响abc文件，已验证运行时功能
• 不涉及，无需验证