图命令

codeknit 提供了两个强大的图命令，帮助您理解和改进代码库结构：graph show 用于交互式可视化，graph analyze 用于自动化结构分析。

graph show

生成代码库的交互式 HTML 图可视化。

codeknit graph show <input-path>

该命令解析代码库并生成一个独立的 HTML 文件，包含交互式图可视化。符号（函数、类、类型）显示为节点，它们的关系（调用、包含、实现）显示为边。可视化结果会自动在默认浏览器中打开。

标志

标志	默认值	描述
-o, --output	./skeleton/codeknit-graph.html	输出 HTML 文件路径
--collect-test	false	在分析中包含测试文件
--workers	NumCPU	最大并发解析 goroutine 数
--verbose	false	在处理过程中打印进度信息

示例

# 生成默认可视化
codeknit graph show ./myproject

# 自定义输出文件
codeknit graph show ./myproject -o graph.html

# 包含测试文件
codeknit graph show ./src --collect-test

graph analyze

对代码库运行结构图算法，并生成 LLM 可读的 .skt 报告，包含代码质量洞察。

codeknit graph analyze <input-path>

该命令检测常见的代码质量问题，如循环依赖、枢纽符号、死代码、god 类和架构瓶颈。

算法

分析包括 17 种结构图算法：

• 循环依赖（Tarjan 的 SCC）
• 枢纽检测（高扇入/扇出耦合）
• 孤立检测（死代码候选）
• god 类/函数检测（过多子节点）
• 不稳定性度量（Robert C. Martin 的 Ce/(Ca+Ce)）
• 深继承链
• 中介中心性（瓶颈检测）
• 关节点（单点故障）
• PageRank（递归重要性）
• 传递扇入（影响范围）
• 变更传播模拟
• 循环包依赖
• 层违反检测
• 从入口点的可达性
• 弱连通分量
• 依赖权重（包耦合强度）
• 距主序的距离（A+I 平衡）

标志

标志	默认值	描述
-o, --output	./skeleton/graph_analysis.skt	输出 .skt 文件路径
--collect-test	false	在分析中包含测试文件
--workers	NumCPU	最大并发解析 goroutine 数
--verbose	false	在处理过程中打印进度信息
--fan-threshold	10	标记枢纽符号的最小扇入或扇出数
--god-threshold	15	标记 god 类/函数的最小包含边数
--max-inheritance-depth	5	标记超过此深度的继承链
--top-n	30	限制排名输出部分；0 = 无限制
--betweenness-threshold	0.001	报告的最小中介中心性值
--propagation-cutoff	0.05	继续变更传播的最小概率

示例

# 使用默认设置运行结构分析
codeknit graph analyze ./myproject

# 自定义输出和阈值
codeknit graph analyze ./myproject -o analysis.skt --fan-threshold 15

# 每个部分显示更多结果
codeknit graph analyze ./myproject --top-n 50

# 包含测试文件
codeknit graph analyze ./src --collect-test