← 指南 · English · 日本語 · Português

更新于 2026-11-20

本页目录
  1. 它是什么
  2. 关键组件
  3. 可扩展性栈
  4. 三个值得抄的工作流
  5. 实录 —— 录制于 Devin CLI v3000.14
  6. Verify it
  7. 坑
  8. 自检
  9. Sources

指南 12 — Devin CLI 与可扩展性

目标: 终端里的本地 Devin——在你机器上跑 agent、把活交给 Devin Cloud,并用 skills、rules、plugins、hooks、subagents 扩展它。 级别: 中级 来源: Devin CLI docs — introducing、essential commands、extensibility

它是什么

Devin CLI 是住在你终端里、连着 Devin Cloud 的编码 agent。两种工作模式,威力在两者之间移动:

local repo ──/handoff──► Devin Cloud session ──/pickup──► local repo
     ▲                        │
     └──── devin ssh / forward (inspect its VM) ────┘

关键组件

面 作用
devin ssh / devin forward SSH 进云会话的 VM、转发端口、scp 文件
Subagents 委派给独立 agent(前台/后台),各自带配置和权限
Models 自适应路由按任务挑模型;Fusion 是前沿主力 + 廉价副手
ACP 通过 Agent Client Protocol 跑在 JetBrains、Zed、Xcode 里
Daemon v3000.13.4 起本地会话跑在后台进程——关掉应用不停会话,任何客户端可接回(devin daemon、devin ls 会话监视器)

daemon 还重写了多客户端语义:在别的终端或编辑器里打开的会话不再被锁——第二个客户端是加入它,每个客户端都能看到输出和提问。devin daemon start|stop|status 管理进程(最后一个会话和客户端退出约 10 分钟后自动退出);--process-model daemon|in-process 每次启动可选,config.json 或 /config 里的 process_model 设默认。一个实测例外:我们在 Desktop v3.14.30825 的录制中,第二个 Desktop 窗口仍看到锁定横幅 + Force open——join 语义在 CLI 侧成立(见第 17 篇第 9 帧)。

可扩展性栈

团队在这里把 CLI 变成自己的——和第 9 篇同样的分层,应用在本地:

层 文件/机制 用途
Rules AGENTS.md / rules 文件 每个会话都会读的常驻指令
Skills SKILL.md 可复用流程——斜杠调用或 agent 自选,可带独立权限/allowed-tools
Plugins plugin manifest 打包 skills + rules + hooks + MCP servers;经团队 marketplace分发
Hooks 生命周期 hooks 在 PreToolUse、PostToolUse、SessionStart、SessionEnd… 上跑 shell/LLM 逻辑——拦截或改写工具调用、注入上下文
MCP MCP 配置 外部工具服务器(stdio / HTTP / SSE)

导入路径: read_config_from 可从 Cursor、Windsurf、Claude Code、Copilot、Codex、Kiro、OpenCode、Zed 导入配置——迁移是一个开关,不是重写。

三个值得抄的工作流

1. 本地 → 云端扇出。 本地起任务、触到上限、/handoff 给一个在自己机器上继续跑的云会话——用 /pickup 把会话接回本机。

2. Skills 当记忆。 把任何重复流程(第 11 篇的迁移 skill、hotfix runbook、发版切割)写成 SKILL.md——CLI docs 建议把成功会话的记录回灌进 skill 来补缺。plugins 把它们打包分发给全团队。

3. Hooks 当护栏。 一个 PreToolUse hook 拦截 rm -rf 模式或对迁移强制评审——执行发生在 hook 里,而不是指望模型自觉。

实录 —— 录制于 Devin CLI v3000.14

真实跑出来的,不是示意图:Linux 上的 Devin CLI 3000.14.30821,Pro 套餐,一个临时 demo-repo(只有 app.py)。模型:改代码用 swe-2-flash-high,跑 skill 用 swe-2-high(devin models 里两个 SWE-2 档位都标着 Free)。

视频(67 秒,无声):下面整段会话,从登录一直到 handoff 报错。

2. 提示词:加一个 subtract 函数并写测试。Devin 先给出 diff 再请求权限——Allow / Accept edits mode / Bypass mode / Deny

1. devin --model swe-2-flash-high —— 登录确认后弹出“是否信任该目录” 1. devin --model swe-2-flash-high —— 登录确认后弹出“是否信任该目录”

2. 提示词:加一个 subtract 函数并写测试。Devin 先给出 diff 再请求权限——Allow / Accept edits mode / Bypass mode / Deny 2. 提示词:加一个 subtract 函数并写测试。Devin 先给出 diff 再请求权限——Allow / Accept edits mode / Bypass mode / Deny

3. 结果:改了 app.py、写了 test_app.py;环境里没有 pytest,Devin 改用 python -c 跑测试并如实说明 3. 结果:改了 app.py、写了 test_app.py;环境里没有 pytest,Devin 改用 python -c 跑测试并如实说明

4. /model —— Adaptive、Fusion(主模型 + 副手)和各模型家族;SWE-2 Flash 标 FREE,不耗额度 4. /model —— Adaptive、Fusion(主模型 + 副手)和各模型家族;SWE-2 Flash 标 FREE,不耗额度

5. /exit 会打印 devin -r <slug> 恢复命令;devin ls 是本地会话监视器 5. /exit 会打印 devin -r 恢复命令;devin ls 是本地会话监视器

6. devin --cloud 后输入 /list-sessions —— 列出账号下的云会话,最新在前 6. devin --cloud 后输入 /list-sessions —— 列出账号下的云会话,最新在前

7. .devin/skills/review/SKILL.md 变成 /review 斜杠命令,用 swe-2-high 审查未提交的改动 7. .devin/skills/review/SKILL.md 变成 /review 斜杠命令,用 swe-2-high 审查未提交的改动

8. 坑:仓库没配 git remote 时 /handoff 直接失败——“Handoff only works from git repos with a remote configured” 8. 坑:仓库没配 git remote 时 /handoff 直接失败——“Handoff only works from git repos with a remote configured”

第 7 步用到的 skill 原文:

---
name: review
description: Review recent changes in this repo and report issues
---

Review the working tree's uncommitted changes. List each changed file,
summarize what it does, and flag anything that looks wrong or risky.
Keep it under 10 lines.

Verify it

坑

自检

  1. 什么时候用 /handoff 上云而不是本地跑完?(工作需要云端并行、组织工具,或跑得比你笔记本开着的时间还长。)
  2. skill、rule、plugin 三者的区别?(skill 是任务规程,rule 是常驻上下文,plugin 是打包两者的容器外加 hooks。)
  3. 为什么 hooks + subagents 对团队采用重要?(hooks 在每个 CLI 会话强制执行组织策略;subagents 让一个操作员开一队 agent——两个方向同时扩。)

Sources