以下是关键点的摘要。详情请参阅应用程序中的"Render Pattern Spec"。

摘要面板

• File: 分析文件的路径
• Lines: 总行数
• Functions: 函数数
• Max depth: 树的最大深度
• Language: 检测到的编程语言（JavaScript, TypeScript, Java, C++, Go, Rust, Python等）
• Categories: 主要类别的统计信息（显示前3个类别）

选择摘要

• Nodes / Blocks / Functions
• Total lines 和 排除重复的唯一行数
• Avg cc（平均圈复杂度），Avg nest（平均嵌套深度）
• Score sum（可见性的复合指标），Max depth（最大深度）
• Category breakdown（类别别的详细统计）
• 重复去除算法: 合并连续行范围以计算准确的唯一行数

在内部，应用程序将分析结果转换为统一格式（XML v2）并在渲染期间重建它们。

summary

• totalLines, filePath, functionCount, maxDepth, deadCodeCount

node

• 属性: id, kind, category, name
• loc: start, end, lines
• complexity: cyclomatic, nestingDepth
• layout: depth, angle, radius
• metrics（扩展）: 语句数、分支数、循环数、调用数、return语句数、异常处理数、switch语句数等
• language: 检测到的编程语言
• category: 函数、类、接口、特征、结构体、枚举、块、控制流、数据结构、宏、模板、装饰器、lambda、协程、测试等

edge

• 属性: id, kind（hierarchy / call），from, to

详情请参阅应用程序中的"XML Spec (XML_FORMAT.md)"。

内部数据格式

• XML格式: 应用程序内部以统一格式（XML v2）管理分析结果。
• 分析结果保存: 当前版本中，分析结果仅在会话期间保持。
• 外部导出: 作为未来功能扩展，正在考虑分析结果的外部保存。

技术规格

• AST分析: 基于各语言语法分析树的结构化数据
• 指标计算: 复杂度、嵌套深度、行数等统计信息
• 布局信息: 根据渲染模式的坐标、角度、半径数据

• 对于非常大的节点数，使用 v6（网格） 或 v9（类别带） 进行概览→放大感兴趣的领域。
• 样式v2~v4包含装饰。它们根据缩放和节点数量自动优化（保持可见性）。
• 当有很多调用线时，切换到 v10 以外的其他内容使其更容易查看。
• TypeScript文件时，v11（TypeScript支持）或v13（扩展黄金角）是最佳的。应用TypeScript特定的优化。

• 没有显示任何内容：源代码结构很少/解析失败。尝试使用不同的文件。
• 慢：在整体显示期间优化装饰。切换到 v6 或 v9 并放大以检查详细信息。
• 中心偏移（v6）：最新版本修复网格以在原点居中。
• TypeScript文件分析不完整：尝试MultiLang或Category-Aware分析器。TypeScript特定语法元素将被正确识别。
• 渲染慢：切换到v1或v6等轻量模式。v11-v13由于TypeScript支持可能稍慢。

Q. 什么是score？

这是一个整合行数、复杂性等的可见性指标。较大的值被绘制为突出的节点并成为焦点候选。

Q. 我应该使用XML还是JSON？

JSON便于在应用程序外部重用分析。XML是内部标准格式，适合检查规范。

Q. 我应该选择哪个模式？

从v1/v9开始概览→如果密度或关系令人担忧，尝试v10→对于详细比较，使用v2/v6→TypeScript支持使用v11/v13，这个流程很流畅。需要TypeScript特定优化时优先使用v11/v13。

本应用程序由以下开源软件支持。我们深深感谢提供社区和贡献者。

Basic分析器

执行基本的AST分析，计算函数、类、块的层次结构和复杂度（圈复杂度、嵌套深度）。最轻量且高速的分析。包含语言检测和类别确定。

CallGraph分析器

分析函数间的调用关系，构建依赖图。提供函数的入度·出度、扇入·扇出等指标。生成层次边和调用边。

MetricsExt分析器

计算详细指标。语句数、分支数、循环数、return语句数、异常处理数、switch语句数等，将代码质量指标数值化。检测语言特定语法元素。

MultiLang分析器

执行TypeScript支持分析，正确识别TypeScript特定语法元素（接口、泛型、装饰器、枚举、类型别名等）。支持JavaScript和TypeScript的语言特性。

Category-Aware分析器

执行类别感知的智能分析，提供考虑节点重要性和相关性的分析结果。包含类别统计自动计算和JavaScript/TypeScript特定类别映射。

完全支持语言

当前支持的语言特定特性

• JavaScript: ES6+功能、动态类型、基于原型的继承、异步处理、箭头函数、展开/剩余运算符、解构赋值
• TypeScript: 静态类型、高级类型系统、接口、泛型、装饰器、异步处理、TS特定语法、类型注解

技术债务

基于复杂性、嵌套深度、函数长度和参数数量计算技术债务。总量随代码库增长，自动分类为 info / minor / major / critical 级别以指导优先级：

• info: 0.00–1.99 — 观察阶段
• minor: 2.00–4.99 — 中等优先级改进
• major: 5.00–9.99 — 应尽快解决
• critical: ≥10.00 — 需要立即行动

代码异味

自动检测以下代码异味：

• 长函数: 50+ 行 (S138)
• 复杂函数: 圈复杂度 10+ (S1541)
• 深度嵌套: 嵌套深度 5+ (S134)
• 参数过多: 5+ 个 (S107)
• 魔法数字: 硬编码数字 (S109)
• 未使用变量: 定义但未使用 (S1481)

可维护性指数

基于 Halstead Volume、复杂性、函数长度、函数数量和类别多样性的 0-100 可维护性指数。更高的值表示更好的可维护性。

其他指标

• 代码重复率: 基于函数名和行的重复检测
• 耦合度: 模块间依赖关系的强度
• 内聚性: 模块内关系的强度
• 安全分数: 危险函数名和模式检测

📊 测试结果概述

🔧 测试环境和库

🔍 测试类型和内容

📊 测试结果详情

🧪 E2E测试详情

🔄 质量改进挑战

⚠️ 质量保证限制

🔮 质量保证持续挑战

此应用程序为了向用户提供可靠服务，持续挑战质量保证。通过825个测试用例全面验证，主要功能高质量保证，重视实际使用场景稳定性。