返回项目目录
开发工具精选项目

Roo Code

已停止维护的多模式 VS Code 自主编码 Agent。

主要语言TypeScript
开源许可Apache-2.0
项目类型开发工具
维护状态已归档
OVERVIEW

项目概述

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。

最终版本v3.54.0
项目状态2026-05-15 停止并归档
推荐后续迁移至 Cline 或 Zoo Code
FEATURES

主要特点

以下内容记录 Roo Code 最终版本曾提供的代表性能力,用于理解项目历史、审计旧环境和规划迁移。

01

内置多种工作模式

Code 负责日常实现,Architect 规划系统,Ask 解答问题,Debug 定位故障,Orchestrator 则把复杂目标拆分给其他模式。

02

高度可定制的 Modes

可在 .roomodes 中定义角色、使用时机、模型、指令和工具组,并用文件正则把编辑能力限制到特定类型。

03

Boomerang Tasks

Orchestrator 可以创建子任务、选择合适模式并汇总返回结果,使研究、实现、测试和文档形成分工流程。

04

代码库索引

通过 Embedding 与向量检索为大型仓库建立语义索引,帮助 Agent 找到与自然语言问题相关的代码区域。

05

文件、终端与浏览器工具

能够读取和编辑文件、搜索代码、运行 Shell,并操作浏览器验证页面,同时在界面中展示工具动作。

06

MCP 集成

可连接本地或远程 MCP Server,把数据库、浏览器自动化、项目管理和其他外部服务暴露为 Agent 工具。

07

Checkpoint 与上下文管理

保存任务过程中的文件快照以便比较和恢复,并通过智能上下文压缩延长复杂会话。

08

团队规则与技能

可使用 .roo 目录、模式专用规则、Skills、Slash Commands 和 .rooignore 共享行为约束与上下文范围。

USE CASES

适用场景

不建议用于新项目;主要适用于识别遗留配置、迁移既有工作流,或研究多模式 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 的规则与模式系统。

EVALUATION

优点与注意事项

技术选型不仅要看能力,也要理解它带来的团队成本。

主要优点

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 与服务器地址,不要把包含凭据的备份提交到仓库。

社区 Fork 需要重新评估

Zoo Code 延续了代码和配置结构,但属于新的维护主体;迁移前仍应核对许可证、发布签名、依赖、安全策略和数据处理方式。

Checkpoint 不是正式备份

任务快照不能替代独立 Git 分支、远程仓库与文件备份。迁移或卸载旧扩展前应另行保存代码和必要配置。

内部 Fork 的成本很高

自行维护意味着持续跟进编辑器 API、模型接口、MCP、依赖漏洞和跨平台测试;大多数团队更适合迁移到活跃项目。

QUICK START

快速开始

这里不提供新的生产安装步骤,而是固定最终源码版本、备份 Roo 配置并准备迁移到仍在维护的替代项目。

1固定最终源码用于审计
bash
git clone --branch v3.54.0 --depth 1 \
  https://github.com/RooCodeInc/Roo-Code.git

cd Roo-Code
git log -1 --oneline
2查找项目级 Roo 配置
bash
rg --files   -g '.roomodes'   -g '.rooignore'   -g '.roo/**'
3备份现有项目配置
bash
mkdir -p ../roo-config-backup

# 按实际存在的文件执行
cp .roomodes ../roo-config-backup/
cp .rooignore ../roo-config-backup/
cp -R .roo ../roo-config-backup/
4识别自定义模式
yaml
# .roomodes
customModes:
  - slug: security-review
    name: Security Reviewer
    roleDefinition: 只审查安全问题,不修改文件。
    whenToUse: 用于合并前安全审查。
    groups:
      - read
5记录迁移清单
markdown
# Roo Code 迁移清单

- [ ] 导出全局设置和 API Profiles
- [ ] 备份 .roomodes、.roo 和 .rooignore
- [ ] 删除备份中的 API Key 与 Token
- [ ] 映射 Custom Modes、Rules、Skills 和 MCP
- [ ] 在测试仓库验证替代扩展
- [ ] 禁用并卸载 Roo Code
- [ ] 轮换旧扩展曾访问的敏感凭据
6检查归档与最终发布状态
bash
# 使用 GitHub CLI 时
gh repo view RooCodeInc/Roo-Code \
  --json isArchived,latestRelease,url

下一步:请不要把归档仓库或最终 VSIX 当作仍受支持的软件。即使旧版本当前还能运行,模型 API、依赖、编辑器接口和安全环境都可能继续变化;优先完成迁移。

ALTERNATIVES

类似项目

这些项目延续了相近的 IDE Agent 工作流,并仍有公开维护活动;Zoo Code 是由社区继续开发的直接 Fork。

COMPARISON

Roo Code vs Cline

Roo Code 源自 Cline 生态,并在 Custom Modes、Orchestrator 和代码库索引等方向形成自身特色;但 Roo Code 已停止维护,而 Cline 仍在持续发布,因此当前选型的首要差异是维护与安全状态。

比较维度Roo CodeCline
维护状态已于 2026-05-15 停止,仓库只读归档仍在活跃开发并持续发布
核心模式Code、Architect、Ask、Debug、OrchestratorPlan / 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 和自动批准规则。

VERIFICATION

资料核验

版本、维护信息与本页采用的官方资料来源。

最后核验2026 年 7 月 28 日
核验版本Roo Code v3.54.0(最终版本)
内容维护Docs100 编辑整理
项目维护状态已归档

本页依据 Roo Code 最终 README、归档仓库、Release、Custom Modes、Boomerang Tasks 与 Codebase Indexing 文档整理。GitHub 官方 API 确认仓库已归档,最终发布和最后代码活动均为 2026 年 5 月 15 日。

维护状态核验2026 年 7 月 26 日 · 最近可见代码活动:2026 年 5 月 15 日

官方仓库已归档为只读状态,最后可见活动日期为 2026 年 5 月 15 日。项目不会再从原维护方获得功能更新或安全修复,仅适合历史研究、迁移参考或在充分评估后维护自有 Fork。

查看官方仓库