Understand Anything 的 README.zh-CN.md
命令
在 VS Code Copilot Chat 中输入 / 开头的命令。
构建知识图谱
/understand
扫描当前项目,提取函数/类/依赖,生成知识图谱并保存到 .understand-anything/knowledge-graph.json。默认增量更新,仅分析变更文件。
/understand --language zh # 生成中文内容(节点描述、Dashboard UI、导览路线)
/understand src/frontend # 限定分析范围到指定子目录
/understand --auto-update # 安装 post-commit 钩子,每次提交自动增量更新
--language 参数支持:en(默认)、zh、zh-TW、ja、ko、ru。
打开 Dashboard
/understand-dashboard
打开交互式网页看板。代码库以力导向图呈现,按架构层级颜色编码,可平移/缩放/搜索/点击节点,查看摘要、依赖关系和引导式学习路径。
对话查询
/understand-chat How does the payment flow work?
基于图谱回答代码库相关问题,支持语义搜索------如"哪些部分处理身份验证?"即可定位相关节点。
变更影响分析
/understand-diff
分析当前未提交的变更对系统的影响范围,查看连锁反应。
深入理解某个文件
/understand-explain src/auth/login.ts
生成新人学习指南
/understand-onboard
自动生成按依赖顺序的架构学习路径。
提取业务领域
/understand-domain
提取业务领域、流程、处理步骤,在 Dashboard 中以水平图展示领域→流程→步骤的映射。
分析 LLM Wiki
/understand-knowledge ~/path/to/wiki
分析 Karpathy 模式的 LLM Wiki,从 index.md 提取 wikilinks 和分类,发现隐式关系、实体和论断。
输出产物
.understand-anything/
├── knowledge-graph.json # 核心图谱数据
├── intermediate/ # 临时中间文件
├── diff-overlay.json # 增量差异覆盖
└── dashboard/ # 可视化 Dashboard
Dashboard 功能
| 功能 | 说明 |
|---|---|
| 交互式图谱 | 文件/函数/类是可点击、可搜索、可探索的节点 |
| 层级可视化 | 按 API / 服务 / 数据 / UI / 系统工具自动分组,颜色编码 |
| 语义搜索 | 模糊搜索 + 语义搜索,自然语言查找相关节点 |
| 学习路径 | 按依赖顺序生成引导式学习路线 |
| 领域视图 | 以水平图展示代码到业务流程的映射 |
| 影响分析 | 提交前查看变更的连锁影响范围 |
| 角色适配 | 根据角色(初级开发/项目经理/高级)调整详细程度 |
| 语言概念 | 12 种编程模式(泛型、闭包、装饰器等)自动标注并解释 |
支持的语言
Tree-sitter 静态分析支持:C、C#、C++、Go、Java、JavaScript、PHP、Python、Ruby、Rust、TypeScript。