适用于 Trae IDE + Windows 环境 | 面向测试/开发团队

---

一、工具简介

Understand-Anything 是一个 AI 代码理解工具，通过静态分析 + 大语言模型，将代码库转换成交互式知识图谱，帮助团队成员快速理解代码结构、分析变更影响。

对测试团队的价值：

场景	价值
接手陌生项目	快速定位核心模块，梳理业务流程
代码变更分析	评估影响范围，精准回归测试
补充测试场景	AI 辅助发现遗漏的分支和边界条件

---

二、环境要求

项目	要求
操作系统	Windows 10 / 11
IDE	Trae（国内版或国际版）
网络	能访问 GitHub
权限	普通用户即可（无需管理员）

---

三、安装步骤

3.1 执行安装命令

1. 打开 PowerShell（无需管理员）

2. 复制并执行以下命令：

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
iwr -useb https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.ps1 | iex

说明：第一行是解决 Windows 默认 SSL/TLS 协议过低的问题，如不执行可能报错。

3. 在菜单中输入 11（选择 Trae 平台）

4. 等待安装完成，看到以下提示即成功：

Installed Understand-Anything for trae

3.2 重启 Trae

必须完全关闭 Trae 再重新打开（不是只关闭标签页）。

---

四、使用指南

4.1 首次分析项目

1. 在 Trae 中打开你的项目文件夹

2. 按 Ctrl+U 打开 AI 对话框，输入：

/understand --language zh

3. 等待分析完成（首次分析大型项目可能需要数分钟）

4. 分析完成后，项目根目录会生成 .understand-anything/knowledge-graph.json

4.2 生成可视化报告

在对话框中输入：

/understand-dashboard

执行成功后，会自动生成 code-analysis-dashboard.html 并在浏览器中打开。

🎉 看到这个 HTML 文件，说明工具已可正常使用。

4.3 常用命令速查

命令	功能
/understand --language zh	全量分析项目（中文描述）
/understand-dashboard	生成可视化报告
/understand-diff	分析当前代码变更的影响范围
/understand-chat "你的问题"	自然语言问答
/understand-explain src/xxx.ts	解释指定文件或函数
/understand-onboard	生成新人学习路径
/understand src/模块名	只分析指定子目录（大型项目推荐）

---

五、测试工程师使用场景

场景一：变更影响分析

开发提交代码后，在对话框中执行：

/understand-diff

工具会输出：

• 变更文件列表
• 受影响的上游调用方
• 受影响的下游依赖
• 建议补充的测试场景

用途：判断需要回归哪些测试用例。

场景二：快速上手陌生项目

接手老项目或无文档项目时，执行：

/understand-onboard

生成按依赖顺序排列的学习路径。

场景三：补充测试场景

/understand-chat "这个支付回调函数有哪些异常分支需要测试？"

AI 结合代码图谱回答，帮助发现可能遗漏的测试点。

---

六、常见问题

Q1：安装时报错"未能创建 SSL/TLS 安全通道"

原因：Windows 默认 SSL 协议版本过低。

解决：安装前先执行：

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Q2：/understand 命令无响应

检查项：

• 是否已完全重启 Trae？
• Trae 是否打开了正确的项目文件夹？
• 检查 %USERPROFILE%\.trae\skills\ 目录下是否有 understand 开头的文件

Q3：首次分析太慢或 Token 消耗大

建议：先分析核心子目录：

/understand src/核心模块名

Q4：生成的描述不准确怎么办？

注意：

• 工具提取的调用关系（谁调用了谁）是确定性的，可信任
• LLM 生成的业务描述可能有偏差，关键模块建议人工确认

Q5：如何卸载？

删除以下内容即可：

• %USERPROFILE%\.trae\skills\understand* 所有文件
• %USERPROFILE%\.understand-anything 文件夹
• %USERPROFILE%\.understand-anything-plugin 文件

---

七、团队协作建议

共享知识图谱

knowledge-graph.json 可以提交到 Git 仓库，团队成员无需重复分析：

git add .understand-anything/knowledge-graph.json

建议忽略的本地文件：

.understand-anything/intermediate/
.understand-anything/diff-overlay.json

若图谱文件超过 10MB，建议使用 git-lfs 管理。

---

八、与其他工具的定位

场景	推荐工具
AI 实时查询调用链	CodeGraph（MCP 集成，响应更快）
手动探索业务架构	Understand-Anything Dashboard
新人学习项目	Understand-Anything /understand-onboard

两者可配合使用，不冲突。

---