← 指南 · English · 日本語 · Português
指南 12 — Devin CLI 与可扩展性
目标: 终端里的本地 Devin——在你机器上跑 agent、把活交给 Devin Cloud,并用 skills、rules、plugins、hooks、subagents 扩展它。 级别: 中级 来源: Devin CLI docs — introducing、essential commands、extensibility
它是什么#
Devin CLI 是住在你终端里、连着 Devin Cloud 的编码 agent。两种工作模式,威力在两者之间移动:
- 本地 —— 直接编辑你机器上已检出的 repo
- 云端 ——
devin --cloud创建/操控/恢复云会话;/handoff把本地任务交给云端 Devin,/pickup把云会话接回你本机(/open则是在网页端或 Devin Desktop 里打开它)
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 报错。
1. devin --model swe-2-flash-high —— 登录确认后弹出“是否信任该目录”
2. 提示词:加一个 subtract 函数并写测试。Devin 先给出 diff 再请求权限——Allow / Accept edits mode / Bypass mode / Deny
3. 结果:改了 app.py、写了 test_app.py;环境里没有 pytest,Devin 改用 python -c 跑测试并如实说明
4. /model —— Adaptive、Fusion(主模型 + 副手)和各模型家族;SWE-2 Flash 标 FREE,不耗额度
5. /exit 会打印 devin -r
6. devin --cloud 后输入 /list-sessions —— 列出账号下的云会话,最新在前
7. .devin/skills/review/SKILL.md 变成 /review 斜杠命令,用 swe-2-high 审查未提交的改动
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#
- [ ]
devin能跑本地会话;devin --cloud能列出/创建云会话 - [ ] 一个
/handoff的任务在云端完成、经/pickup接回了本机 - [ ] 斜杠命令调用
SKILL.md跑通了你的流程 - [ ] (企业版)团队 marketplace 能把你的 plugin 发给另一个成员
坑#
- 并行活用云端。 CLI 是终端里的单个 agent——并行切片请用云会话或 Bot;CLI 是亲手干的那一面。
- Rules 蔓延。
AGENTS.md+ 项目 rules + 全局 rules 按优先级相互作用——每条规则只放一层,否则会打架。 /handoff需要 remote。 仓库没配 git remote 会直接失败——先把仓库推到 Devin Cloud 能 clone 的地方。
自检#
- 什么时候用
/handoff上云而不是本地跑完?(工作需要云端并行、组织工具,或跑得比你笔记本开着的时间还长。) - skill、rule、plugin 三者的区别?(skill 是任务规程,rule 是常驻上下文,plugin 是打包两者的容器外加 hooks。)
- 为什么 hooks + subagents 对团队采用重要?(hooks 在每个 CLI 会话强制执行组织策略;subagents 让一个操作员开一队 agent——两个方向同时扩。)
Sources#
- Devin CLI docs — quickstart、命令、云集成、可扩展性、ACP、模型
- 相关:第 9 篇 — Playbooks 与知识层(同一套约定层,组织级)
