用途：technical-debt-visualizer 提供数据驱动的软件质量视图，帮助工程负责人和开发者识别既复杂又频繁变更的文件，即“高利息”技术债，从而优先安排重构工作。
主要能力：基于代码复杂度、测试覆盖缺失程度以及 TODO/FIXME 密度生成热力图和指标报告；输出可包含“热点”文件，即复杂度高且测试覆盖低的文件。
使用方式：输入 source_path（如 ./src）和 output_format（如 markdown），生成 markdown 报告。分析完全在本地内存中进行，采用静态分析，不会运行被分析的代码。
适用场景：冲刺规划前识别高投资回报率的重构目标；架构评审中可视化遗留系统对整体代码库健康的影响；尽职调查中快速评估新仓库或收购仓库的健康状况。
限制：不适用于性能基准测试，因为衡量的是代码结构与可维护性而非运行时性能；复杂度指标（如圈复杂度）只是指示器而非绝对规则，某些复杂逻辑不可避免。若在非 git 目录运行，变更频率指标不可用；复杂度分析依赖语言，未知扩展名会以较低置信度报告。