Roo Code
已停止维护的多模式 VS Code 自主编码 Agent。
项目概述
Roo Code 曾以 Custom Modes、Boomerang Tasks、代码库索引、MCP 和细粒度工具分组著称;官方扩展已于 2026 年 5 月 15 日停止,仓库现为只读归档。
Roo Code 是从 Cline 生态发展出的开源 VS Code 自主编码 Agent,采用 Apache-2.0 许可证。它把 Code、Architect、Ask、Debug、Orchestrator 和 Custom Modes 组织成可分工的“AI 开发团队”,并提供文件读写、终端、浏览器、MCP、Checkpoint、代码库索引、上下文压缩与任务编排等能力。需要特别注意:Roo Code 官方扩展已在 2026 年 5 月 15 日停止运营,最终版本为 v3.54.0,官方仓库已归档为只读,不再提供模型更新、缺陷修复或安全补丁。现有用户应导出配置并迁移到活跃维护的 Cline 或社区延续项目 Zoo Code。
主要特点
以下内容记录 Roo Code 最终版本曾提供的代表性能力,用于理解项目历史、审计旧环境和规划迁移。
内置多种工作模式
Code 负责日常实现,Architect 规划系统,Ask 解答问题,Debug 定位故障,Orchestrator 则把复杂目标拆分给其他模式。
高度可定制的 Modes
可在 .roomodes 中定义角色、使用时机、模型、指令和工具组,并用文件正则把编辑能力限制到特定类型。
Boomerang Tasks
Orchestrator 可以创建子任务、选择合适模式并汇总返回结果,使研究、实现、测试和文档形成分工流程。
代码库索引
通过 Embedding 与向量检索为大型仓库建立语义索引,帮助 Agent 找到与自然语言问题相关的代码区域。
文件、终端与浏览器工具
能够读取和编辑文件、搜索代码、运行 Shell,并操作浏览器验证页面,同时在界面中展示工具动作。
MCP 集成
可连接本地或远程 MCP Server,把数据库、浏览器自动化、项目管理和其他外部服务暴露为 Agent 工具。
Checkpoint 与上下文管理
保存任务过程中的文件快照以便比较和恢复,并通过智能上下文压缩延长复杂会话。
团队规则与技能
可使用 .roo 目录、模式专用规则、Skills、Slash Commands 和 .rooignore 共享行为约束与上下文范围。
适用场景
不建议用于新项目;主要适用于识别遗留配置、迁移既有工作流,或研究多模式 Agent 的产品设计。
迁移遗留工作区
盘点 .roomodes、.roo、.rooignore、MCP、Provider 和自动批准设置,再映射到 Cline 或 Zoo Code。
恢复历史任务配置
从版本库或备份中读取旧的模式、规则和技能,理解当时的 Agent 分工与项目约束。
研究多模式 Agent
参考 Code、Architect、Debug 和 Orchestrator 的角色拆分,以及工具组和文件范围限制设计。
审计归档版本
固定 v3.54.0 源码,检查依赖、历史安全公告、数据流和本地配置,不依赖已经停止的在线服务。
维护内部 Fork
具备足够 TypeScript、VS Code Extension 和安全维护能力的团队,可在自有 Fork 中承担依赖与漏洞修复。
迁移自定义工作流
把只读审查、文档编写、测试工程和任务编排等 Custom Mode 转换到目标 Agent 的规则与模式系统。
优点与注意事项
技术选型不仅要看能力,也要理解它带来的团队成本。
主要优点
Roo Code 擅长的地方
- Custom Modes 对角色、工具和可编辑文件范围提供较细控制
- Orchestrator 与 Boomerang Tasks 展示了清晰的多模式分工方式
- 代码库索引、MCP、浏览器和终端覆盖完整开发上下文
- 项目级规则与模式文件便于将工作流保存在版本库中
- Apache-2.0 源码仍可用于研究、审计和维护自有 Fork
- 社区 Fork Zoo Code 为既有配置提供了相对直接的延续路径
需要注意
采用前应考虑的问题
Roo Code 官方明确表示扩展于 2026 年 5 月 15 日关闭;仓库已经归档,不能期待原团队继续发布功能、模型支持或兼容性更新。
未来出现的依赖漏洞、Provider API 变化、VS Code 兼容问题和 Agent 安全缺陷都不会由原项目修复,不适合继续用于敏感环境。
最终 VSIX 可以启动,只说明当前环境尚可兼容;它可能连接变化中的模型与外部服务,并继续拥有文件、命令和 MCP 权限。
原有账号、计费、Marketplace 或远程功能可能不可用或不再受支持;迁移时应把本地配置与托管服务依赖分开核对。
导出 Provider 和 MCP 设置前应检查 API Key、Token、Header 与服务器地址,不要把包含凭据的备份提交到仓库。
Zoo Code 延续了代码和配置结构,但属于新的维护主体;迁移前仍应核对许可证、发布签名、依赖、安全策略和数据处理方式。
任务快照不能替代独立 Git 分支、远程仓库与文件备份。迁移或卸载旧扩展前应另行保存代码和必要配置。
自行维护意味着持续跟进编辑器 API、模型接口、MCP、依赖漏洞和跨平台测试;大多数团队更适合迁移到活跃项目。
快速开始
这里不提供新的生产安装步骤,而是固定最终源码版本、备份 Roo 配置并准备迁移到仍在维护的替代项目。
bashgit clone --branch v3.54.0 --depth 1 \
https://github.com/RooCodeInc/Roo-Code.git
cd Roo-Code
git log -1 --onelinebashrg --files -g '.roomodes' -g '.rooignore' -g '.roo/**'bashmkdir -p ../roo-config-backup
# 按实际存在的文件执行
cp .roomodes ../roo-config-backup/
cp .rooignore ../roo-config-backup/
cp -R .roo ../roo-config-backup/yaml# .roomodes
customModes:
- slug: security-review
name: Security Reviewer
roleDefinition: 只审查安全问题,不修改文件。
whenToUse: 用于合并前安全审查。
groups:
- readmarkdown# Roo Code 迁移清单
- [ ] 导出全局设置和 API Profiles
- [ ] 备份 .roomodes、.roo 和 .rooignore
- [ ] 删除备份中的 API Key 与 Token
- [ ] 映射 Custom Modes、Rules、Skills 和 MCP
- [ ] 在测试仓库验证替代扩展
- [ ] 禁用并卸载 Roo Code
- [ ] 轮换旧扩展曾访问的敏感凭据bash# 使用 GitHub CLI 时
gh repo view RooCodeInc/Roo-Code \
--json isArchived,latestRelease,url下一步:请不要把归档仓库或最终 VSIX 当作仍受支持的软件。即使旧版本当前还能运行,模型 API、依赖、编辑器接口和安全环境都可能继续变化;优先完成迁移。
类似项目
这些项目延续了相近的 IDE Agent 工作流,并仍有公开维护活动;Zoo Code 是由社区继续开发的直接 Fork。
Roo Code vs Cline
Roo Code 源自 Cline 生态,并在 Custom Modes、Orchestrator 和代码库索引等方向形成自身特色;但 Roo Code 已停止维护,而 Cline 仍在持续发布,因此当前选型的首要差异是维护与安全状态。
| 比较维度 | Roo Code | Cline |
|---|---|---|
| 维护状态 | 已于 2026-05-15 停止,仓库只读归档 | 仍在活跃开发并持续发布 |
| 核心模式 | Code、Architect、Ask、Debug、Orchestrator | Plan / Act、Custom Agents 与只读 Subagent |
| 任务编排 | Boomerang Tasks 由 Orchestrator 分派模式 | 主 Agent 配合并行只读 Subagent |
| 定制方式 | .roomodes、.roo Rules、Skills、Slash Commands | .cline Rules、Skills、Hooks、Agents、Plugins |
| 代码上下文 | 文件搜索、Context Mentions 与向量代码库索引 | 目录、AST、搜索、文件引用与 Subagent 探索 |
| 工具边界 | Mode Tool Groups、文件正则与 Auto Approve | 逐项审批、分类 Auto Approve 与 Checkpoints |
| 回退机制 | Checkpoint 与主 Git 工作区分离 | Shadow Git Checkpoint,可分别恢复文件和任务 |
| 当前建议 | 仅用于历史审计、迁移参考或自维护 Fork | 可作为新项目的候选,但仍需安全评估 |
新项目不应再选择 Roo Code。现有用户若希望获得相近但持续维护的 Agent 体验,可以评估 Cline;若希望最大程度保留 Roo 的配置、Modes 和操作习惯,可评估社区 Fork Zoo Code。迁移前请备份并清理凭据,在隔离测试仓库验证全部模式、MCP 和自动批准规则。
资料核验
版本、维护信息与本页采用的官方资料来源。
本页依据 Roo Code 最终 README、归档仓库、Release、Custom Modes、Boomerang Tasks 与 Codebase Indexing 文档整理。GitHub 官方 API 确认仓库已归档,最终发布和最后代码活动均为 2026 年 5 月 15 日。
官方仓库已归档为只读状态,最后可见活动日期为 2026 年 5 月 15 日。项目不会再从原维护方获得功能更新或安全修复,仅适合历史研究、迁移参考或在充分评估后维护自有 Fork。