Roo Code — 多角色 AI 编码代理¶

# VS Code 安装
# 1. 打开 VS Code → Extensions（Ctrl+Shift+X）
# 2. 搜索 "Roo Code"
# 3. 点击 Install

# 也支持：Cursor、Windsurf、Zed 等编辑器

1. 点击侧边栏 Roo Code 图标
2. 选择 API Provider：
   - Roo Code Cloud（官方，即将关闭）
   - Anthropic / OpenAI / Google（自带 Key）
   - OpenRouter（汇集所有模型）
   - Ollama（本地模型，完全离线）
3. 输入 API Key
4. 选择模型

Roo Code 最大的创新是角色化的 Agent 模式：

1. 🏗️ Architect 模式（架构师）
   - 规划复杂改动、设计系统架构
   - 只看不动手，给出设计方案
   - 用途：开始大任务前先规划

2. 💻 Code 模式（编码员）
   - 实际编写和修改代码
   - 支持多文件编辑、重构、优化
   - 用途：日常编码任务

3. 🐛 Debug 模式（调试员）
   - 诊断问题、追踪错误来源
   - 提出针对性修复方案
   - 用途：代码报错时使用

4. 🧪 Test 模式（测试员）
   - 创建和改进测试代码
   - 不会修改功能代码
   - 用途：补充测试覆盖

5. 🤔 Ask 模式（问答）
   - 解释代码功能和行为
   - 不会修改任何东西
   - 用途：理解别人写的代码

6. 🎯 Orchestrator 模式（总指挥）
   - 协调大型任务，委派给其他 Agent
   - 可以跑几个小时完成复杂任务
   - 用途：大型功能开发

# 场景：给一个项目加用户认证功能

步骤1 — 用 Architect 模式规划：
输入："设计一个 JWT 用户认证系统"
→ AI 给出架构方案、文件结构、API 设计

步骤2 — 用 Code 模式实现：
输入："按照上面的设计开始实现"
→ AI 创建文件、写代码

步骤3 — 用 Test 模式补充测试：
输入："给认证模块写单元测试"
→ AI 只写测试，不改功能代码

步骤4 — 用 Debug 模式排查问题：
输入："登录接口返回 500 错误，帮我排查"
→ AI 分析日志、定位问题、给出修复方案

# 你可以创建自己的 AI 角色

# 示例：安全审查员
模式名称：Security Reviewer
指令：你是一个安全审查专家，检查代码中的安全漏洞
允许的工具：读文件、搜索代码（不允许修改文件）

# 示例：文档撰写员
模式名称：Doc Writer
指令：你是技术文档专家，为代码生成文档
允许的工具：读文件、写文件（只能写 .md 文件）

# 示例：数据库管理员
模式名称：DBA
指令：你是数据库专家，优化 SQL 查询和数据库设计
允许的工具：读文件、搜索代码、执行终端命令

Roo Code 的自动修复能力：
1. AI 修改代码
2. 自动运行测试
3. 如果测试失败：
   - 读取错误信息
   - 分析失败原因
   - 提出修复方案
   - 应用修复
   - 再次运行测试
4. 循环直到测试通过或需要人工介入

# 启动 Ollama
ollama serve  # 启动本地模型服务

# 在 Roo Code 中配置 Ollama
# Provider: Ollama
# Model: deepseek-coder-v2 或 qwen2.5-coder

# 这样你的代码完全不会发送到外部服务器
# 适合处理公司内部代码或敏感项目