CC 搭配Understand Anything 理解代码

Understand Anything安装：https://github.com/Egonex-AI/Understand-Anything.git

Understand Anything 使用技巧大全

一、核心命令速查表

基础命令

# 基础分析（默认英文）
/understand

# ✅ 生成中文分析报告（必加参数）
/understand --language zh

# 只分析指定目录
/understand --path ./src/components

# 增量更新（只分析修改的文件）
/understand --incremental

# 打开可视化图谱面板
/understand-dashboard

# 查看所有可用参数
/understand --help

二、必学高级技巧

1. 中文输出 + 深度分析（黄金组合）

# 🔥 推荐日常使用：中文 + 深度 + 业务逻辑提取
/understand --language zh --depth deep --extract-business

参数	作用
`--language zh`	输出全中文
`--depth shallow/medium/deep`	分析深度
`--extract-business`	额外提取业务逻辑
`--no-graph`	不生成图谱，只输出文字总结

2. 大型项目性能优化（关键！）

# 排除 node_modules、dist 等目录（大幅提速）
/understand --language zh --exclude node_modules,dist,build,.git

# 只分析核心源码目录
/understand --language zh --path ./src --exclude *.test.js,*.spec.js

# 增量模式（修改代码后不用重新分析全部）
/understand --incremental

3. 针对性分析特定模块

# 只分析 API 接口层
/understand --language zh --path ./src/api

# 只分析组件
/understand --language zh --path ./src/components

# 分析数据库模型
/understand --language zh --path ./src/models

三、Dashboard 可视化面板使用技巧

运行 /understand-dashboard 后打开浏览器：

图谱操作

滚轮缩放：放大缩小图谱
拖拽节点：移动模块位置
点击节点：查看该模块详情
双击节点：展开子模块
搜索框：快速定位函数/类/文件

实用视图切换

视图模式	适用场景
架构总览	新人接手项目，快速看整体结构
调用链	排查接口调用、函数依赖问题
技术栈	了解项目用了哪些第三方库
风险点	自动标记复杂度过高的文件

四、不同场景最佳实践

场景1：接手陌生老项目

# 第一步：快速总览
/understand --language zh --depth shallow

# 第二步：看核心业务
/understand --language zh --extract-business

# 第三步：打开图谱看架构
/understand-dashboard

场景2：阅读开源项目源码

# 先看整体架构
/understand --language zh

# 重点分析核心目录
/understand --language zh --path ./packages/core

# 排除示例、文档、测试
/understand --language zh --exclude examples,docs,test

场景3：Code Review 前快速了解

# 增量分析本次修改涉及的模块
/understand --incremental --language zh

# 重点看依赖关系，防止改坏其他地方
/understand-dashboard → 查看调用链视图

场景4：排查 Bug 定位

# 分析报错相关目录
/understand --language zh --path ./src/services/payment

# 在图谱中搜索报错函数，看它被谁调用

五、节省 Token 的技巧

1. 合理排除文件

# 这些一定要排除！
--exclude node_modules,dist,build,.git,*.md,*.json

2. 分层分析，不要一次全量

# ❌ 不要：10万行代码一次全分析
/understand

# ✅ 推荐：分模块分析
/understand --path ./src/api
/understand --path ./src/components
/understand --path ./src/utils

3. 使用浅度模式快速预览

# 先快速看大概
/understand --depth shallow

# 需要深入时再用 deep
/understand --depth deep

六、常见问题解决方案

❌ 分析太慢 / 卡住

解决：

1. 加 --exclude 排除无用目录
2. 用 --path 指定只分析核心目录
3. 关闭其他占用内存的程序

❌ 生成的图谱太乱看不清

解决：

Dashboard 中点击「自动布局」按钮
拖拽整理核心模块到中心
右键隐藏不重要的节点
用搜索框定位你关心的模块

❌ 中文乱码 / 还是英文

解决：

# 必须显式指定语言参数
/understand --language zh

❌ 分析结果不准确

解决：

# 使用深度分析模式
/understand --depth deep

# 清理缓存后重新分析
/understand --clear-cache

七、配合 Claude Code 使用的进阶技巧

1. 基于分析结果提问

基于刚才 /understand 的分析结果，请告诉我：
1. 这个项目的核心数据流是怎样的？
2. 如果我要加一个XX功能，应该改哪些文件？
3. 这个项目有哪些技术债？

2. 让 AI 基于图谱生成文档

根据 Understand Anything 分析的架构图，帮我生成：
1. 项目 README 文档
2. 模块设计说明
3. 新人上手指南

3. 重构建议

基于分析结果，帮我评估：
1. 哪些模块耦合度太高需要拆分？
2. 哪些函数复杂度过高需要重构？
3. 整体架构有什么优化建议？

八、记住这 5 条黄金法则

✅ 永远加 --language zh —— 中文才是你的母语
✅ 大型项目必加 --exclude —— 排除无用文件提速 10 倍
✅ 先 shallow 后 deep —— 先看整体再深入
✅ 多用 --incremental —— 增量分析省时间省 Token
✅ 分析完必开 /understand-dashboard —— 一图胜千言

掌握这些技巧，Understand Anything 能帮你节省 80% 的代码阅读时间！