用途：为单个仓库构建确定性、机器可读的代码图，作为 LLM 维护的仓库 wiki 或上下文枢纽的底层数据，而非仅终端报告。适用于需要可提交的 graphs/code-graph.json、文件与符号映射、导入/调用/继承/测试关联分析、爆炸半径与最小审查上下文、图论风险信号（割点、桥、环、拓扑序、替代路径）、基于个性化 PageRank 的热点符号上下文检索，以及由代码图数据生成的有依据的仓库或模块描述。不适用于跨仓库组合发现、多仓库架构或迁移规划、无代码图生成的纯文档清理。
主要能力：扫描并分类源文件、测试、配置；用确定性或启发式解析器提取符号；构建节点与边（repo、file、class、function、method、test、external_symbol；contains、defines、imports、calls、inherits、references、tests）；校验模式、悬空引用、孤儿节点、重复 ID、循环导入、解析状态与置信度；查询邻域、影响、路径、PPR、社区与结构风险；导出 Markdown、Mermaid、HTML 报告。
使用方式：标准输出包括 code-profiles/<repo>.json、graphs/code-graph.json，以及可选的校验、报告、查询结果、HTML 与 Mermaid 文件。流程为扫描、构建、校验、查询、发布、增强。常用命令：python3 scripts/validate_code_graph.json graphs/code-graph.json --output reports/code-graph-validation.json；python3 scripts/query_code_graph.py graphs/code-graph.json --node <id> --hops 1；--impact <id> --hops 2；--from <id> --to <id> --k 3；--ppr --seed <id> --top 30；--communities --resolution 1.4；--articulation-points、--bridges、--cycles、--topo-sort；--diagram --output reports/code-graph.mmd；python3 scripts/export_code_graph_report.py graphs/code-graph.json --output-dir reports/。
适用场景：单仓库代码审查、变更影响分析、测试覆盖映射、模块描述生成、仓库知识库构建。
限制：v1 解析器确定性且保守，Python 用 ast 完整解析，JavaScript、TypeScript、TSX、C#、Swift 为启发式解析，不支持的语言仅生成文件节点并显式标记；不提供语义嵌入、监视模式或 IDE 同步、SQLite 持久化、全程序类型推断，也不保证动态代码的完美调用解析。代码图是路由与爆炸半径的底层数据，不能替代阅读源码。生成描述须基于图证据并明确标注解析缺口，不得仅凭符号名推断所有权、运行时行为或架构角色。