AGENTS.md - 项目工作手册
项目概述
本项目为 VitePress 教程站点（常州国医堂中医馆相关 + PHP/前端技术教程），内容涵盖 VSCode、Linux、PHP、数据库、AI 工具等。
写作规范
- 使用 VitePress 容器语法：
::: tip、::: warning、::: danger、::: details、::: info - frontmatter 格式：
title + titleTemplate: vscode 教程 - 中文写作，实用导向，语言简洁直接
- 代码块使用
::: code-group 做多标签切换 - 表格用于对比类内容
- 树状结构用
plaintext 代码块
文件定位
editor/vscode/aiTools.md 是 VSCode 教程下 AI 工具的 深度对比与选型指南，与 /ai/tools/ 下的安装指南互补，不重复安装步骤，聚焦于 VSCode 插件体验 的横向对比。
内容大纲
editor/vscode/aiTools.md
├── 开篇引言
│ └── 说明本文定位：VSCode 内 AI 插件的使用体验和对比，安装指南链接到 /ai/tools/
│
├── 一、VSCode 内置 AI 能力
│ ├── IntelliCode（微软 AI 辅助）
│ ├── Copilot Chat（内置于新版 VSCode）
│ └── Inline Chat / 内联对话（Ctrl+I）
│
├── 二、AI 编程插件概览
│ └── 用一张表格列出所有工具的：
│ 开发者、产品形态、补全能力、对话能力、中文支持、
│ 自定义 API、定价、VSCode 插件 ID
│
├── 三、各插件详细分析
│ ├── 1. GitHub Copilot
│ │ ├── 补全能力（英文/中文注释补全）
│ │ ├── Copilot Chat / Agent 模式
│ │ ├── 自定义 API（不支持，锁定 OpenAI/Anthropic）
│ │ ├── 定价（$10/月，$100/年，学生免费）
│ │ └── 优缺点
│ │
│ ├── 2. Claude Code（Anthropic）
│ │ ├── 插件形态：CLI + VSCode 扩展
│ │ ├── Agent 模式（文件读写、终端执行）
│ │ ├── 无内联补全（走 agent 路线）
│ │ ├── 自定义 API（支持 CC-Switch 中转）
│ │ ├── 定价（按 token 计费，Claude Pro $20/月）
│ │ └── 优缺点
│ │
│ ├── 3. Codex（OpenAI）
│ │ ├── 插件形态：CLI + Desktop + VSCode 扩展
│ │ ├── Agent 模式
│ │ ├── 无内联补全
│ │ ├── 自定义 API（支持 CC-Switch 中转）
│ │ ├── 定价（按 token 计费，ChatGPT Plus 可用）
│ │ └── 优缺点
│ │
│ ├── 4. TRAE（字节跳动/抖音）
│ │ ├── 插件形态：VSCode/JetBrains 插件 + 独立 IDE
│ │ ├── 内联补全 + 对话 + Agent 模式
│ │ ├── 中文补全能力（国内最佳之一）
│ │ ├── 自定义 API（支持添加自定义模型）
│ │ ├── 定价（国内免费）
│ │ └── 优缺点
│ │
│ ├── 5. Qoder CN（原通义灵码，阿里巴巴）
│ │ ├── 插件形态：VSCode/JetBrains 插件
│ │ ├── 内联补全 + 对话 + Agent 模式
│ │ ├── 中文补全能力（阿里系模型，中文优秀）
│ │ ├── 自定义 API（企业版支持）
│ │ ├── 定价（个人免费，企业版付费）
│ │ └── 优缺点
│ │
│ ├── 6. WorkBuddy（腾讯）
│ │ ├── 插件形态：VSCode 插件 + 独立桌面端
│ │ ├── 内联补全 + 对话 + Agent 模式
│ │ ├── 中文补全能力（腾讯混元模型）
│ │ ├── 自定义 API
│ │ ├── 定价（免费为主）
│ │ └── 优缺点
│ │
│ ├── 7. OpenCode（开源）
│ │ ├── 插件形态：CLI + Desktop + VSCode 插件
│ │ ├── Agent 模式（无内联补全）
│ │ ├── 自定义 API（开源，支持任意模型）
│ │ ├── 定价（免费开源）
│ │ └── 优缺点
│ │
│ └── 8. Continue（开源框架）
│ ├── 插件形态：VSCode 插件
│ ├── 补全 + 对话（依赖接入的模型）
│ ├── 自定义 API（核心卖点，支持任意模型/本地 Ollama）
│ ├── 定价（免费开源，自带 API key）
│ └── 优缺点
│
├── 四、维度对比
│ ├── 4.1 自动补全能力对比
│ │ └── 哪些有内联补全、补全速度、上下文理解
│ ├── 4.2 中文补全能力对比
│ │ └── 中文注释触发、中文变量名、中文对话质量
│ ├── 4.3 自定义 API 能力对比
│ │ └── 能否用自己的 key、支持哪些模型、能否接本地模型
│ ├── 4.4 定价对比
│ │ └── 免费/付费/按量/包月
│ └── 4.5 国内可用性
│ └── 网络限制、国内镜像、注册门槛
│
├── 五、选型建议
│ ├── 纯免费方案
│ ├── 最佳补全方案
│ ├── 最佳 Agent 方案
│ ├── 最佳自定义方案
│ └── 国内开发者推荐组合
│
└── 六、与 AI 工具安装指南的关系
└── 链接到 /ai/tools/ 各工具的安装页面
覆盖的对比维度
| 维度 | 说明 |
|---|
| 自动补全 | 是否有内联补全、补全质量、速度、上下文感知 |
| 中文补全 | 中文注释触发补全的能力、中文对话质量、中文变量名理解 |
| 自定义 API | 能否用自己的 API key、支持哪些模型提供商、能否接本地 Ollama |
| 定价 | 免费/付费/按量计费/包月 |
| Agent 能力 | 文件读写、终端执行、多步骤任务 |
| 国内可用性 | 是否需要翻墙、国内注册难度、国内网络稳定性 |
涉及的工具清单
| 工具 | 开发者 | 类型 |
|---|
| IntelliCode | 微软 | 内置 |
| GitHub Copilot | GitHub/微软 | 插件 |
| Claude Code | Anthropic | CLI + 插件 |
| Codex | OpenAI | CLI + 桌面 + 插件 |
| TRAE | 字节跳动 | 插件 + IDE |
| Qoder CN | 阿里巴巴 | 插件 |
| WorkBuddy | 腾讯 | 插件 + 桌面 |
| OpenCode | SST 团队 | CLI + 桌面 + 插件 |
| Continue | 开源社区 | 插件 |
审核记录（2026-06-16）
| # | 问题 | 严重度 | 修正措施 |
|---|
| 1 | 第一章「VSCode 内置 AI 能力」把 Copilot Chat 列为内置，但它需要付费订阅，VSCodium 用户不可用 | 高 | 区分「免费内置」（IntelliCode）和「付费集成」（Copilot Chat），并标注 VSCodium 兼容情况 |
| 2 | 缺少 Cline（原 Claude Dev），这是 VSCode 上下载量很大的开源 AI Agent 插件 | 中 | 在工具清单和详细分析中增加 Cline |
| 3 | 缺少 Codeium，package.md 已提到但未纳入对比 | 中 | 纳入对比，标注国内可用性 |
| 4 | 没有标注 VSCodium 兼容性，而项目推荐使用 VSCodium | 高 | 每个工具增加「VSCodium 兼容」字段 |
| 5 | 缺少多插件冲突说明（多个 AI 补全插件同时启用会打架） | 中 | 新增「使用注意事项」章节 |
| 6 | WorkBuddy 产品形态待验证，不确定是否有 VSCode 插件 | 中 | 创作前需验证，若无插件则说明其定位 |
| 7 | Qoder CN 收费政策变动中（原通义灵码从免费转向收费），需标注最新动态 | 中 | 定价部分注明「政策调整中」 |
| 8 | 没有时间标注，AI 工具更新快 | 低 | 正文开头加「最后更新」时间 |
| 9 | 选型建议应结合项目场景（PHP + 前端 Vue + 远程开发） | 低 | 选型建议增加「PHP/前端开发者推荐」 |
修正后的工具清单
| 工具 | 开发者 | 类型 | VSCodium 兼容 |
|---|
| IntelliCode | 微软 | 内置 | 否 |
| GitHub Copilot | GitHub/微软 | 插件 | 否（用 Codeium 替代） |
| Claude Code | Anthropic | CLI + 插件 | 是 |
| Codex | OpenAI | CLI + 桌面 + 插件 | 是 |
| TRAE | 字节跳动 | 插件 + IDE | 待验证 |
| Qoder CN | 阿里巴巴 | 插件 | 是 |
| WorkBuddy | 腾讯 | 插件 + 桌面 | 待验证 |
| OpenCode | SST 团队 | CLI + 桌面 + 插件 | 是 |
| Continue | 开源社区 | 插件 | 是 |
| Cline | 开源社区 | 插件 | 是 |
| Codeium | Codeium | 插件 | 是（有替代包） |
关联修改
package.md 第六章「AI 智能体」末尾添加指向 aiTools.md 的链接.vitepress/sidebar/editor/vscode.mts 添加 { text: 'AI 工具', link: '${path.main}aiTools' }
