至少输入两个字母,即可搜索文档的所有页面。

↑ ↓ 导航 ↵ 打开 esc 关闭

使用 rdev

AI 智能体

rdev 自带现成的 AI 智能体配置,让您的智能体从第一天起就了解环境的运作方式。

支持的智能体

智能体 支持级别
Claude Code 完整
Codex 完整
opencode、Qwen Code、GitHub Copilot CLI、Gemini CLI 完整
Cursor CLI、Antigravity CLI 标准
其他读取 AGENTS.md 并支持 MCP 的智能体 标准,由您自行安装

完整支持是指安装程序、配置、托管设置、通知、会话状态和更新都覆盖该智能体。标准支持是指智能体获得共享规则和 MCP 访问,但没有智能体专属的附加功能。面板的智能体标签页会在每个智能体旁显示支持级别。

安装智能体

在侧边栏的服务器中打开服务器,然后进入智能体。AI 智能体卡片列出 rdev 已知的所有智能体、是否已安装及其版本,以及启动它的命令(用旁边的按钮复制)。安装用于添加智能体,⋯ 菜单用于更新或移除。Codex 是环境镜像的一部分,无法移除。更改在服务器上运行,需要几秒到一分钟;完成后卡片会显示结果。

智能体按环境区分:在 Team 套餐中,每位成员为自己的环境选择智能体,在此安装不会影响其他人。这需要 rdev 0.2.0-beta.36 或更高版本;在服务器运行该版本之前,卡片会提示您更新。

更新智能体

智能体不会在你的服务器上自行更新,你也不会在智能体里看到“更新已安装,请重启”的提示。请通过 ⋯ 菜单或 rdev agents update 更新(单个智能体:rdev agents update claude)。版本变化后,rdev 会用新版本重新打开该智能体所有空闲的会话:同一个终端窗口、同一段对话,历史记录都在。智能体正在工作或在等你回复的会话绝不会被打断,它会保持旧版本,直到你重新启动它。Claude Code, Codex, opencode, Qwen Code, GitHub Copilot CLI、Gemini CLI 的会话会被重新打开;Cursor CLI 和 Antigravity CLI 的会话会继续以旧版本运行,直到你重新启动。需要 rdev 1.1.5 或更高版本。

其他模型:服务商密钥和快捷方式

智能体也可以运行在其他服务商的模型上。在同一标签页的模型服务商密钥下,添加密钥可保存 Anthropic、OpenAI、Google Gemini、DeepSeek、Kimi(Moonshot)、GLM(Z.ai)、MiniMax、Qwen(阿里巴巴)、OpenRouter、Groq、xAI 或 Mistral 的 API 密钥。对于 Ollama,则填写您的 Ollama 服务器地址(http://… 或 https://…),而不是密钥。密钥会在您的浏览器中针对此服务器加密:面板永远看不到它,无法再次显示,只知道哪些服务商有密钥。为已有密钥的服务商再次添加密钥会替换原密钥。

设置密钥后,可使用现成的快捷方式在项目中用该服务商的模型启动智能体:

快捷方式 服务商
claude-deepseek、claude-kimi、claude-glm、claude-minimax、claude-qwen 在 DeepSeek、Kimi、GLM、MiniMax 或 Qwen 模型上运行的 Claude Code
codex-deepseek、codex-openrouter、codex-groq、codex-xai、codex-ollama 在 DeepSeek、OpenRouter、Groq、xAI 或 Ollama 模型上运行的 Codex
qwen-<provider>,例如 qwen-openrouter 在其他服务商模型上运行的 Qwen Code

卡片会列出您的密钥所对应的可用快捷方式。使用 Claude 以外模型的 Claude Code 未获得 Anthropic 官方支持:它适用于大多数任务,但某些功能的表现可能有所不同。

共享规则

所有智能体遵循的规则集中在一处,即 AGENTS.md。Codex、Gemini CLI 和 opencode 直接读取它,Claude Code 则通过自己的 CLAUDE.md 引入它。智能体专属的部分,例如 Claude Code 的技能和钩子,建立在这些共享规则之上。

您能获得多少配置内容取决于您的套餐:

  • Single: 基础规则。
  • Pro: 完整配置,包含技能、智能体和模型路由。
  • Team: 完整配置,外加团队共享规则。

完整配置会添加:适用于 Laravel、WordPress、调试和在此环境中部署的 Claude Code 技能;一个 frontend 子智能体,在更快、更便宜的模型上完成视觉工作,而主会话保留困难的部分(这就是模型路由);以及一个 reviewer 子智能体,在更改完成前进行独立审查。团队规则在团队页面编写。如果您切换到 Single,除非您修改过,否则完整配置的文件会被移除。

rdev 命令指南

每个套餐都会为您使用的每个编码智能体安装一个 rdev 技能。它是一份简短的指南,告诉智能体哪个 rdev 命令或 rdev MCP 工具负责哪项任务:添加和运行项目、安装语言、PHP 和 Node 版本、数据库和服务、保持 worker 和计划任务运行、预览、检查点、Git 访问、备份、部署、错误跟踪、通知以及许可证。智能体会在任务需要时自行加载,所以您直接提出要求即可,例如“给 shop 添加一个 Postgres 数据库”或“运行 blog 的队列 worker”。

它安装在 ~/.claude/skills/rdev(Claude Code)和 ~/.agents/skills/rdev(Codex、opencode、Qwen Code、GitHub Copilot CLI、Gemini CLI 和 Cursor)中;如果安装了 Antigravity,还会安装在 ~/.gemini/config/skills/rdev 中。rdev 会保持这些文件为最新;请把您自己的技能放在其他文件夹中。

MCP 访问

智能体可通过 MCP 访问您的站点和数据库。这样,智能体可以自行创建站点、为项目添加 Redis、数据库、搜索或 S3 存储,在 composer 需要时安装 mongodb 之类的 PHP 扩展,查询数据库或读取捕获的邮件,而无需请您来做。

从 rdev 0.2.0-beta.34 起,智能体还会管理每个项目的进程和计划任务:写完队列任务后,智能体会自行设置队列工作进程或 Laravel 的调度器,在修改其运行的代码后重启工作进程,并读取进程的输出。请求失败时,它会读取 Laravel 日志的末尾或其最后一个错误,列出、创建和恢复检查点(见下文),在您要求时将站点分享为预览,并告诉您夜间备份是否已运行。与任何其他 MCP 工具一样,Claude Code 在首次使用某个工具前会先询问您。

您自己的账户

您需连接自己的 Anthropic 或 OpenAI 账户,或使用上述服务商密钥。智能体的使用费用由这些服务商计费,不包含在 rdev 订阅中。我们不会看到您的提示词或用量。

全天候运行智能体

把提示词交给智能体,让它在您的服务器上运行;您合上笔记本电脑,享受您的一天。智能体运行在您的服务器上,而不是笔记本电脑上,所以需要几个小时的任务在您离开后也会继续。

每次通过 SSH 登录您的服务器,都会打开同一个名为 main 的持久会话:笔记本电脑应用中的 Terminal on the server、ssh rdev,或手机、平板上的 SSH 应用。您无需自己启动它(rdev 1.0.1 或更高版本)。

在笔记本应用中点击项目的 Open in Terminal,或运行 rdev open <项目>,则会打开该项目自己的持久会话:会话以项目命名,并在项目文件夹中启动。这样每个项目都保留自己的窗口和代理,在不同项目上的两台设备也不会切换彼此的画面(rdev 1.3.1 或更高版本)。

  1. 在该终端中启动智能体并交给它任务。
  2. 合上盖子、关闭应用或任由连接断开,智能体都会在服务器上继续工作。想主动离开时,先按 Ctrl-b,再按 d。
  3. 可从任何设备回来:重新登录,您就在同一个会话中,停在离开时的位置。面板中的智能体会话和您的通知会告诉您工作何时完成或在等您处理。

几个按键会很有用:Ctrl-b c 打开新窗口(用于第二个智能体),Ctrl-b n 和 Ctrl-b p 在窗口之间切换,也可以用鼠标或触控板滚动。要关闭持久会话,请在服务器上运行 rdev session persist off(on 可重新开启;需要 rdev 1.0.5 或更高版本);编辑器的远程终端(VS Code、Cursor)和文件同步从不使用它。

会话结束后,可以用智能体自己的命令继续同一段对话,例如 claude --continue(或用 claude --resume 选择一个)和 codex resume。对话保存在您服务器的主目录中,更新和重启后依然保留。

rdev host update 会重启环境,这会停止所有智能体和持久会话。当智能体正在工作或在等您处理时,它会等待并告诉您;rdev host update --force 则会照常更新。

面板上的智能体会话

面板中的智能体会话会列出您服务器上的 Claude Code 和 Codex 会话,以及每个会话正在做什么:工作中、等待您处理(权限提示或提问)、已完成或因错误停止。它每隔几秒刷新一次,并支持手机,因此您可以随时随地查看长任务。等待您处理的会话排在最前。

只有智能体、会话、项目文件夹的名称和状态会到达面板;绝不会包含您的提示词、智能体的回答或您的代码。会话保留一周。Codex 报告工作中和已完成;其审批提示暂时不会显示。

会话上的 ⋯ 菜单可停止正在运行的会话:服务器会在几秒内结束智能体的进程(已更改的文件会保留,可通过会话开始时的检查点撤销;这需要 rdev 0.2.0-beta.36 或更高版本)。运行在持久终端中的会话会显示 持久 徽标,其菜单中的 关闭终端窗口 会在智能体仍在工作时将其停止,并关闭服务器上的终端窗口,智能体已结束时同样可用(rdev 1.0.1 或更高版本)。从列表中移除会隐藏单个会话,清除已结束会一次性移除所有已结束、失败或不活跃的会话;再次报告的会话会重新出现。 在网页终端中打开 会从你 tailnet 中的设备,在服务器的网页终端中打开该终端窗口(仅限你自己的服务器,rdev 1.4.5 或更高版本);如果窗口已关闭,则打开你平常的持久会话。

检查点:撤销智能体所做的操作

在 git 项目中,智能体的一轮操作开始时,rdev 会先保存项目文件的检查点:包括已跟踪的文件和新文件,不包括被忽略的文件。它是位于您的分支之外的一个提交,因此 git status、您的历史记录和暂存区看起来都不变。每个项目保留最近 20 个检查点;没有任何更改的一轮不会新增检查点。

每一轮之前的自动检查点来自代理的 hook,因此 Claude Code、Codex、opencode、Qwen Code、GitHub Copilot CLI 和 Gemini CLI 会自动获得。Cursor CLI 和 Antigravity CLI 没有这类 hook;通过 rdev 启动时它们才会获得检查点,此时会话也会显示在面板上,结束时会通知你:

rdev agents run cursor

Antigravity CLI 请使用 rdev agents run antigravity。

要撤销,请在面板中打开您的服务器,在撤销并恢复下选择一个检查点,或在服务器上操作。列出项目的检查点:

rdev checkpoint list

然后按 id 恢复其中一个:

rdev checkpoint restore 1793603600

恢复会将文件还原为原来的样子,并删除之后新增的文件;当前状态会先保存为新的检查点(除非它与最新的检查点相同),因此恢复本身也可以撤销。rdev checkpoint create 可手动保存一个检查点。检查点需要 rdev 0.2.0-beta.16 或更高版本。