（2534期）Understand-Anything – 代码库智能可视化分析引擎

代码库智能可视化分析引擎 深度代码库分析工具，自动生成交互式知识图谱，可视化项目架构、组件关系与分层结构，支持增量更新与智能导览。 使用说明 核心用法 /understand 是一个多阶段代码库分析引擎，通过七个结构化阶段将源代码转化为可交互的知识图谱： 预检阶段 — 智能检测是全量重建还是增量更新，基于 Git commit hash 比对避免重复分析 扫描阶段 — 子代理遍历项目，识别语言、框架、文件清单与复杂度估算 分析阶段 — 并行子代理批量处理文件（5-10个/批，最多3并发），提取函数、类、模块等节点及18种关系边 组装阶段 — 合并批次结果，清理悬空引用与重复节点 架构阶段 — 识别分层结构（UI/API/Service/Data等），支持 React、Express、Django、Go 等框架专属规则 导览阶段 — 基于 README 和入口文件生成学习路径，将文档叙事映射为代码探索路线 审核阶段 — 交叉验证完整性，自动修复缺失字段，最终输出标准化 JSON 输出产物 knowledge-graph.json 包含：项目元数据、节点（file/function/class/module/concept）、边（18种类型含权重）、分层定义、学习导览。配套 /understand-dashboard 可启动可视化界面。 显著优点 智能增量更新：Git 感知机制避免全量重分析，大型项目秒级响应 框架原生理解：内置 React/Next.js、Express、Django、Go 等目录语义，自动推断架构分层 并行可扩展：批量+并发设计支持大型代码库，200+文件时主动提示范围限定 防御性工程：多重降级策略——子代理失败重试、部分结果保存、自动修复、警告透传 标准化输出：严格 Schema 约束，支持下游工具链集成 潜在局限 资源消耗：多阶段子代理调用对 token 消耗较大，超大型项目需分目录分析 框架覆盖有限：当前仅硬编码 4 种框架规则，小众框架依赖通用启发式 黑盒分析：基于静态代码扫描，运行时行为（动态路由、依赖注入等）可能遗漏 审核自动化边界：approved: false 时自动修复能力有限，复杂结构问题需人工介入 适合人群 新成员快速熟悉陌生代码库 技术负责人进行架构审计与债务评估 开源项目维护者生成可视化文档 需要进行代码迁移或重构前的影响面分析 常规风险 | 风险类型 | 说明 | 缓解措施 ||---------|------|---------|| 数据泄露 | 分析过程读取完整源代码 | 本地执行，输出隔离在 .understand-anything/ 目录 || 不完整图谱 | 子代理超时或失败导致节点缺失 | 失败重试+部分保存+审核报告 || 架构误判 | 非标准目录结构导致分层错误 | 支持 --full 强制重建与目录范围限定修正 || 存储膨胀 | 中间文件累积 | Phase 7 自动清理 intermediate/ 目录 | 安全等级 S（本地分析、无外部调用、自动清理临时文件），来源可信度 T1（官方工具链原生技能）。 原始说明 Analyze a codebase to produce an interactive knowledge graph for understanding architecture, components, and relationships