docs: update image paths and README content

- Update image paths in documentation files to use relative paths
- Enhance README content with more detailed descriptions of chapters
- Fix sidebar link for CLI AI coding tools
This commit is contained in:
sanbuphy
2025-12-31 23:25:41 +08:00
parent 41ae6c181b
commit 229f8a6e92
123 changed files with 138 additions and 138 deletions
@@ -6,7 +6,7 @@
你可以把 IDE 理解成一种专门用来“编辑、管理、运行和调试”各种应用源代码的程序。在真正打包发布之前,不同语言写出来的程序本质上只是特定格式的代码文件而已,你可以用普通文本编辑器打开它们,也可以用 IDE 打开。早期的计算机几乎完全通过终端来操作(只用键盘就能完成所有操作,几乎不需要鼠标),所以早期的 IDE 外观也非常“原始”——除非你额外安装插件来实现简单的交互式界面。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image1.png)![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image2.png)
![](images/image1.png)![](images/image2.png)
终端界面(Terminal
@@ -14,7 +14,7 @@
一个非常知名、功能成熟的“内置 IDE”叫做 `Vim`。在很多服务器上,你都可以直接用它来编辑文件(服务器通常没有显示屏,只能通过键盘远程操作)。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image3.png)
![](images/image3.png)
现代 IDE 通常具有更加美观直观的图形界面,并提供更强大的编辑、运行和调试能力。一个典型的 IDE 通常包含以下核心组件:
@@ -24,7 +24,7 @@
除此之外,现代 IDE 往往还内置版本控制工具(如 Git)和项目管理工具等实用功能。当下最流行的 IDE 之一是微软出品的 **[Visual Studio Code (VS Code)](https://code.visualstudio.com/)**。它轻量、可扩展性极强,因此被广泛使用。当然,也有很多开发者推荐 JetBrains 家的专业 IDE,比如用于 Python 的 PyCharm、用于 C/C++ 的 CLion 等,它们对特定语言提供了更深入、更完整的支持。但从入门友好度和通用性角度出发,我们更推荐初学者优先选择 VS Code 作为主要开发工具。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image4.png)
![](images/image4.png)
# 现代 IDEVS Code
@@ -34,11 +34,11 @@ VS Code 的核心理念之一是“一切皆插件”。不同编程语言可以
VS Code 巧妙地通过“插件机制”解决了这一问题。比如,如果你要写 Python,就安装 Python 插件,它会提供 Python 专属的语法高亮、自动补全和代码导航功能;如果你要写 C/C++,则可以安装对应的 C/C++ 插件来获得相应支持。在不安装任何插件的情况下,VS Code 本质上只是一个“高级的文本文件管理器”;当你为某种语言安装了对应插件之后,它就会“变身”成该语言的理想开发工具。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image5.png)
![](images/image5.png)
除了编写代码以外,你甚至可以把 VS Code 当作编辑 Markdown 文档的工具来使用。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image6.png)
![](images/image6.png)
总之,你可以在 VS Code 的扩展市场中浏览和下载各类扩展,为不同类型的文件提供更好用的编辑体验,也可以根据需要搜索不同语言和调试工具的插件,尝试它们如何提升你的工作效率。
@@ -60,7 +60,7 @@ VS Code 巧妙地通过“插件机制”解决了这一问题。比如,如果
在最新版 VS Code 中,你可以点击右上角的侧边栏入口,打开 AI 功能区域,体验这些能力。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image7.png)
![](images/image7.png)
不过,VS Code 并不是 AI 能力最强的 IDE。对于需要大量 AI 辅助编码的场景,我们往往希望使用“更聪明、效率更高”的工具——好的 AI IDE 能显著节省写代码和改 Bug 的时间。下面我们会介绍几款目前比较流行的 AI IDE,重点讲解 Trae IDE。你可以根据个人喜好选择任意一款 AI IDE 使用。
@@ -70,7 +70,7 @@ VS Code 巧妙地通过“插件机制”解决了这一问题。比如,如果
## Trae
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image8.png)
![](images/image8.png)
Trae 是字节跳动推出的一款 AI 编程助手,支持 100 多种编程语言,并能集成到主流 IDE 中。它的功能包括:用自然语言生成代码、自动调试、把设计稿转换为 React/Vue 组件等。在 2025 年 8 月的更新之后,Trae 新增了智能依赖导入、重命名建议、任务清单管理等功能;SOLO 模式也开始支持后端代码生成和技术架构文档编辑。
@@ -80,33 +80,33 @@ Cursor 是 Anysphere 开发的一款 AI 代码编辑器,基于 VS Code 定制
目前,Cursor 可以说是“带前端界面的 AI IDE”中综合体验最好的一款之一,用户数量庞大,功能迭代频率也很高。它最大的缺点是价格较高——专业版大约需要每月 20 美元。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image9.png)
![](images/image9.png)
## Qoder
Qoder 是阿里巴巴推出的一款强调“透明协作”和“增强上下文工程能力”的 AI IDE。它通过 Action Flow 支持把任务拆解成多个步骤,并实时跟踪 AI 的执行过程;还支持多模型动态路由和任务状态机管理,非常适合在中大型项目中做架构治理和对遗留系统进行“反向工程”分析。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image10.png)
![](images/image10.png)
## CodeBuddy
CodeBuddy 是腾讯云推出的一款 AI 编程工具,强调对中文指令的支持以及企业级合规能力。它提供代码补全、批量代码审查和多模型切换等功能;其中的 Craft 智能体可以实现多文件代码生成和 API 集成。企业版支持私有化部署,并通过了三级等保认证,适合金融、医疗等对数据安全要求较高的行业。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image11.png)
![](images/image11.png)
## windsurf(已不推荐)
Windsurf 最初因其基于 Agent 的 AI 编程能力而受到关注。但由于 2024 年团队调整以及模型权限问题,它的稳定性大幅下降,目前已经不再推荐使用。尽管在前一年它还可以与 Cursor 分庭抗礼,但现在基本可以视为“被淘汰”的工具。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image12.png)
![](images/image12.png)
## VS Code + Cline
Cline 是 VS CodeVisual Studio Code)的一款 AI 编程 Agent 插件,可以通过配置不同的 API 端点来灵活切换所使用的大模型。Cline 支持多模态输入、MCP 工具扩展以及成本监控,所有操作都需要用户确认后才会执行。它非常适合用于快速验证想法,或与现有开发流程集成。基础功能是免费的,企业版则支持在私有环境中部署模型。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image13.png)
![](images/image13.png)
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image14.png)
![](images/image14.png)
# 什么是 Trae
@@ -122,38 +122,38 @@ Trae 分为国际版和中国版。国际版需要能够访问海外网络,但
https://www.trae.ai/
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image15.png)
![](images/image15.png)
中国版下载地址:
https://www.trae.cn/
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image16.png)
![](images/image16.png)
## Trae 界面简介
简单来说,Trae 和 VS Code 看起来几乎一模一样。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image17.png)
![](images/image17.png)
右侧的侧边栏就是 Copilot 交互窗口,也可以理解为 Agent 窗口。如果你暂时看不到它,可以点击 Trae 右上角的侧边栏图标将其打开。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image18.png)
![](images/image18.png)
打开侧边栏之后,你会看到一个 `Builder` 选项,这就是 Agent 模式。简单理解,它相当于 z.ai 的“本地版”,可以帮你操作本机环境,安装运行环境、打开网页等。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image19.png)
![](images/image19.png)
点击 “Builder” 后,你会看到 “Chat” 模式和 “Builder with MCP” 模式:
* **Chat 模式**:主要用于和当前文件夹里的代码对话,或者当作普通聊天模型来使用。(你可以通过左上角的 “File” 菜单打开一个文件夹,在这个文件夹中进行编辑操作。在这种情况下,Builder 创建或修改的文件都只会发生在这个文件夹内部。)
* **Builder with MCP 模式**:为 Agent 提供了更多可用工具(例如把语言模型和其他软件联通起来、查询天气等)。你可以简单理解为:MCP 能让语言模型更方便地调用各种外部工具。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image20.png)
![](images/image20.png)
在下面的区域,你还会看到模型选择选项,点击即可修改当前使用的大模型。在中国版中,你可以选择使用 Kimi k2 或 GLM 等国内模型;如果你使用的是国际版 Trae,还可以选择 ChatGPT 或 Claude 等海外模型。不过,由于国内大模型发展非常快,Kimi、Qwen、GLM 等在很多任务上的实际体验已经接近 Claude 3.5 或 3.7,对日常开发来说已经完全够用。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image21.png)
![](images/image21.png)
以上就是对 Trae 的一个简单介绍。接下来,我们可以回顾一下之前在 z.ai 中做过的操作,并尝试在 Trae 中做同样的事情。
@@ -161,9 +161,8 @@ https://www.trae.cn/
大多数情况下,我们的 Windows 笔记本电脑默认不会预装前端开发所需的 Node.js 环境,或用于后端 / 通用开发的 Python 环境。我们可以尝试直接在 Trae 的 Agent 模式中跟它对话,让它帮我们安装 Python 环境或 Node.js 环境。
![](../../../English/Extra/Extra%20Knowledge%204%20-%20What%20is%20AI%20IDE%20and%20Trae/images/image22.png)
![](images/image22.png)
## 📚 作业:用 Trae 写你的第一个程序
接下来,请尝试用 Trae 来完成你的第一个程序!你还记得之前的 AI 贪吃蛇游戏吗?把当时在 z.ai 中使用的那条提示词原封不动地输入到 Trae 的 Agent 模式中,看看会发生什么吧!