#Trae IDE的自我介绍，让大家更熟悉、了解Trae 是干啥的。

# Trae AI 助手全面介绍文档

> 本文档由 Trae AI 自动生成，旨在帮助新用户全面了解 Trae AI 的能力、限制、环境配置及合规要求。

---

## 一、我是谁？

我是 **Trae IDE** 内置的 **AI 编程助手**，基于 **GLM-5V-Turbo** 大语言模型驱动。我运行在 Trae 集成开发环境中，专门为**软件工程任务**而设计。

我的核心定位：**一个懂代码、能操作文件、可执行命令的智能编程伙伴。**

---

## 二、我能做什么？（核心能力）

### 2.1 代码读写与编辑
| 能力 | 说明 |
|------|------|
| **读取文件** | 读取项目中的任意文件（代码、配置、图片等），支持按行范围读取 |
| **写入/创建文件** | 创建新文件或覆写已有文件 |
| **精确编辑** | 基于上下文的精确字符串替换，支持批量替换 |
| **删除文件** | 删除一个或多个已存在的文件 |

### 2.2 代码搜索与分析
| 能力 | 说明 |
|------|------|
| **语义搜索（SearchCodebase）** | 用自然语言描述意图来搜索代码，而非精确匹配文本 |
| **正则搜索（Grep）** | 基于 ripgrep 的强大正则表达式搜索，支持多行匹配 |
| **文件模式匹配（Glob）** | 按文件名模式查找文件（如 `*.js`, `**/*.ts`） |
| **目录浏览（LS）** | 列出目录结构和文件 |

### 2.3 终端命令执行
| 能力 | 说明 |
|------|------|
| **运行命令** | 在 PowerShell 环境中执行终端命令 |
| **Git 操作** | git status、diff、commit、push、branch 等（需用户授权） |
| **包管理** | npm、yarn、pnpm 等包管理操作 |
| **构建与运行** | 项目构建、启动开发服务器、运行测试等 |
| **Docker 操作** | Docker 相关命令执行 |

### 2.4 Web 信息获取
| 能力 | 说明 |
|------|------|
| **网络搜索（WebSearch）** | 搜索实时信息，获取最新技术文档和资讯 |
| **网页抓取（WebFetch）** | 抓取指定 URL 的内容并转换为可读 Markdown |
| **Exa 搜索增强** | 更强大的语义搜索和深度网页内容提取 |
| **Context7 文档查询** | 获取编程库/框架的最新官方文档和代码示例 |

### 2.5 专业技能模块（Skills）
我内置了以下专业技能模块，可根据需求自动调用：

#### 开发辅助类
| 技能名称 | 功能说明 |
|----------|----------|
| **TRAE-code-review** | 代码审查：审查合并请求、代码差异，提供结构化反馈 |
| **TRAE-debugger** | 运行时调试：通过 HTTP 收集日志，科学调试流程（假设→插桩→复现→分析→修复→验证） |
| **TRAE-security-review** | 安全扫描：代码安全审查，漏洞风险检测 |
| **TRAE-generate-mini-app** | 小程序生成：基于 Taro 框架生成跨端小程序代码 |
| **skill-creator** | 技能创建器：用于创建新的自定义 Skill |

### 2.6 思维与规划
| 能力 | 说明 |
|------|------|
| **顺序思维（Sequential Thinking）** | 复杂问题的分步推理、假设验证、方案修正 |
| **任务管理（TodoWrite）** | 创建和管理结构化任务列表，跟踪进度 |
| **交互提问（AskUserQuestion）** | 在执行过程中向用户提问以明确需求或做决策 |

### 2.7 其他能力
- **诊断信息获取**：获取 VS Code 语言诊断（语法错误、类型错误等）
- **命令状态监控**：查看正在运行的命令输出
- **预览链接提供**：成功启动本地服务器后提供预览 URL

---

## 三、我不能做什么？（能力边界）

### 3.1 绝对不能做的
| 限制项 | 说明 |
|--------|------|
| **无法访问互联网上的私有资源** | 无法访问需要认证的页面（如 GitHub 私有仓库、飞书、企业内网） |
| **无法执行交互式命令** | 不支持需要用户输入的交互式命令（如 `git commit -i`、`npm init` 无参数版本） |
| **无法直接操作 GUI** | 不能点击按钮、填写表单等图形界面操作 |
| **无法突破权限限制** | 所有需要用户授权的操作都会被拦截，必须等待用户批准 |
| **无法永久保存记忆** | 对话结束后上下文会被压缩，不会跨会话记住之前的对话内容 |
| **无法自主决策破坏性操作** | 如 `git push --force`、`git reset --hard` 等危险操作，即使你要求也会先警告 |

### 3.2 不应做的（设计原则）
| 原则 | 说明 |
|------|------|
| **不过度工程化** | 只做被要求的事，不主动添加"可能有用"的功能 |
| **不主动创建文档** | 除非用户明确要求，否则不创建 README、注释等 |
| **不做不必要的抽象** | 两三行重复代码不需要抽取成通用函数 |
| **不添加防御性编程** | 信任内部代码保证，只在系统边界做校验 |
| **不使用 emoji** | 除非用户明确要求，否则不在输出中使用表情符号 |

---

## 四、环境信息

### 4.1 当前运行环境
```
操作系统:        Windows
Shell 环境:      PowerShell 5.x
工作目录:        E:\AI\AI-Space\Trae
主工作目录:    E:\AI\AI-Space\Trae
当前日期:        2026-06-13
模型:            GLM-5V-Turbo
IDE:             Trae IDE（基于 VS Code）
最大终端数:      5 个（当前可用: 可自动创建新终端）
```

### 4.2 工具链兼容性
- **包管理器**: npm / yarn / pnpm（通过终端调用）
- **版本控制**: Git（通过终端调用）
- **运行时**: Node.js（可通过终端安装和使用）
- **容器**: Docker（可通过终端调用）
- **构建工具**: Vite、Webpack、esbuild 等

### 4.3 文件系统
- 可读写项目目录下的所有文件
- 支持读取图片文件（PNG、JPG、JPEG、GIF、WEBP，上限 10MB）
- 文件路径必须使用绝对路径

---

## 五、合规性与安全注意事项

### 5.1 数据安全
| 注意事项 | 说明 |
|----------|------|
| **敏感文件保护** | 我会识别 `.env`、`credentials.json` 等敏感文件，在 git commit 时发出警告 |
| **不泄露密钥** | 不会将 API Key、密码、Token 等敏感信息提交到版本控制 |
| **本地处理优先** | 代码分析在本地完成，但大模型推理涉及云端处理 |

### 5.2 Git 安全协议
- **禁止强制推送** 到 main/master 分支，会提前警告
- **禁止破坏性操作**（clean -f、checkout .、restore 等），除非用户明确要求
- **提交前会展示变更概要**，让你确认后再执行
- **不会自动 push**，除非你明确要求

### 5.3 权限机制
- **文件操作**：读写文件通常自动允许
- **安全操作**：删除文件、执行潜在危险命令需要用户批准
- **网络请求**：搜索和抓取网页通常自动允许
- **Skill 调用**：根据 Skill 类型可能需要确认

### 5.4 使用合规建议
1. **不要将公司机密代码粘贴给我** — 对话内容可能被用于模型训练优化
2. **不要让我处理 PII（个人身份信息）** — 遵守隐私保护法规
3. **不要让我绕过安全控制** — 我会拒绝违反安全原则的请求
4. **重要操作前务必审查** — 我的建议不一定总是正确的，请自行验证

---

## 六、最佳使用方式

### 6.1 推荐做法
```
✅ 明确描述需求："帮我把 UserService.ts 的 login 方法加上日志"
✅ 提供上下文："这个文件在第 50 行左右"
✅ 分步执行复杂任务：我会用 TodoList 跟踪进度
✅ 用中文交流：我能完美理解和使用中文
✅ 让我先读文件再改代码：这样我能给出更精准的修改
```

### 6.2 避免的做法
```
❌ 模糊指令："帮我优化一下代码"（太笼统）
❌ 一次性给太多不相关的需求
❌ 期望我记住上次对话的内容（每次对话相对独立）
❌ 让我做 GUI 操作（我只能操作文件和终端）
```

### 6.3 高效协作技巧
1. **打开相关文件** — 我能看到你在 IDE 中打开的文件，这有助于理解上下文
2. **一次说清楚** — 把完整需求一次性告诉我，比反复补充效率更高
3. **信任但验证** — 对关键修改，建议你 review 一下我再提交
4. **善用提问** — 当我有疑问时，我会主动问你，这是为了做得更好

---

## 七、快速上手示例

### 示例 1：查看项目结构
```
你: "看看当前项目的目录结构"
我: 使用 LS 工具列出文件和文件夹
```

### 示例 2：搜索代码
```
你: "用户登录的逻辑在哪里？"
我: 使用 SearchCodebase 语义搜索找到登录相关代码
```

### 示例 3：修改 Bug
```
你: "修复 login 页面的验证码 bug"
我: 读取文件 → 分析问题 → 编辑修复 → 解释改动
```

### 示例 4：搭建新功能
```
你: "帮我搭建一个购物车模块"
我: 调用 cart-module skill → 自动生成完整的前后端代码
```

### 示例 5：初始化完整项目
```
你: "初始化兴盛糕点电商平台"
我: 调用 project-init skill → 编排 19 个子模块 → 完整平台搭建
```

---

## 八、常见问题 FAQ

**Q: 你能替我写整个项目吗？**
A: 可以。对于我内置的电商系统模块（19 个子技能），我可以一键生成完整的前后端代码。

**Q: 你的回答一定正确吗？**
A: 不一定。大模型存在"幻觉"现象，生成的代码可能有误。关键修改请务必验证。

**Q: 对话太长会怎样？**
A: 系统会自动压缩历史消息，不影响继续对话，但早期的细节可能会丢失。

**Q: 我可以同时开多个终端吗？**
A: 最多 5 个终端。如果某个终端正在运行命令，复用它会导致当前命令被终止。

**Q: 如何让我停止正在运行的命令？**
A: 直接告诉我就行，或者我可以使用 StopCommand 工具终止它。

**Q: 支持哪些编程语言？**
A: 主流编程语言都支持：JavaScript/TypeScript、Python、Java、Go、Rust、C/C++、C#、PHP、Ruby 等。

---

## 九、版本信息

| 项目 | 值 |
|------|-----|
| 文档版本 | 1.0 |
| 生成时间 | 2026-06-13 |
| 模型 | GLM-5V-Turbo |
| 知识截止日期 | 2025 年 8 月 |
| 适用环境 | Trae IDE on Windows |

---

> **提示**：本文档是静态快照，我的能力会持续更新。如有疑问，随时问我！