个人学习小站 SIGNAL DESK 2026
LIVE --:--:-- 反馈
资讯 人工智能 cline cli-v3.0.75 release note、CLI Reference、3.0.74 本机实测

cline 定时任务默认 yolo:mode 写错就全自动

cline schedule 的 --mode 只认全小写。Plan、readonly、末尾带空格的 act 都不报错,只会静默落成 yolo。本文给出 7 次本机创建实测、回读校验、PreToolUse hook 与 worktree 隔离的四步收口,附夜间体检配置和 10 条急救。

2026年11月21日 8 小时前 作者 站长 约 12 分钟 9 阅读

给 cline 挂定时任务的人,大多是从文档抄一条命令起步:cline schedule create "每日体检" --cron "0 9 * * *" --prompt "…" --workspace /repo。文档里 --mode 的默认值写着 yolo,于是很多人顺手补一句 --mode plan,觉得这样就只读、安全了。

本机实测(cline 3.0.74、Windows 11、Node 22.22.2):--mode Plan(大写 P)、--mode readonly、--mode "act "(末尾多一个空格)都能创建成功,不报错、不警告,落库的 mode 字段一律是 "yolo"。

这不是排版问题,是权限问题。定时任务跑在你睡觉的时候,官方文档的措辞是:每个模式都自己批准自己的工具调用,因为没人在那儿批准。下面把实测矩阵、四步收口,和一份能直接抄的夜间配置一次写完。

先认清你跑的是哪一种“无人值守”

cline 有三个入口,批准逻辑不一样。3.0.75 只改了其中一个,但改的正好是最常用的那个。

入口谁在批准工具3.0.74 默认3.0.75 默认
cline(交互式)你,逐个点actact,没变
cline "prompt"自动批准,没人看act + 自动批准yolo
echo "prompt" | cline自动批准,没人看act + 自动批准yolo
cline schedule create它自己,跨终端存活yoloyolo,没变

3.0.75 的 release note 原文:one-shot(带 prompt 参数或管道输入)现在默认 yolo,因为没人在键盘前批准工具。以下四种情况仍然保留 act:auto-approve 被关掉(--auto-approve false 或保存的设置)、显式传了模式开关、保存的是 plan 模式、prompt 是 /team。

Yolo mode has no team tools, so pass --act when you need them.

注意这条:官方让你在需要 /team 时传 --act,但 3.0.75 的 CLI Reference 参数表里没有列出这个开关,3.0.74 的 --help 里也没有(实测)。升级后第一件事是 cline --help 对一遍参数,别把三个月前的 CI 脚本连同没验证过的开关一起搬过来。

另一个容易误会的点:3.0.74 的 -y, --yolo 文案是“Auto-approve a limited tool set for unsupervised runs (benchmarks, CI). DANGEROUS: use only in sandboxed environments.”,听起来像“只批有限工具”。但官方从没给出这个“limited tool set”的清单,3.0.75 也只说 yolo 没有 team 工具。所以别用“它应该只批了几个安全工具”来安慰自己。

为什么定时任务的 yolo 比终端里的 yolo 危险

同一个模式,放在不同场景,风险不是一回事。三个放大器:

  • 没人批准。交互式里你至少会看到 diff 和命令;定时任务里,批准这一步被跳过了。
  • 它活着的时间比你长。定时任务由 hub 托管,关掉终端、重启电脑都还在,出错时你不在现场。
  • 错误不会当场暴露。终端里跑坏一条命令,下一屏就红了;定时任务要等你想起去看 schedule history。
In every mode, a scheduled run approves its own tool calls, because nobody is there to approve them.
The CLI has no allow or deny list for shell commands. To block commands, use a PreToolUse hook that cancels run_commands calls you don’t allow.

第二句是全文最重要的前提:没有一个内置开关能限制它能跑哪些 shell 命令。你只能自己写 hook。

还有一个常见误解:plan 模式不是只读。官方对 plan 的描述是:拒绝 rm、git commit 这类“通常会改文件”的命令,其他命令照跑,其中一些(比如 python -c)可以写文件。plan 降低的是误触概率,不是权限边界。

交互式用 Cline(主流教程)定时任务 / CI 跑 cline(本文场景)
谁批准工具你它自己
出错谁先知道你,下一屏没人,直到翻 history
模式默认值actyolo
有没有命令黑名单没有没有
唯一硬闸门你的判断PreToolUse hook
出事后的回滚撤销一次编辑从 worktree 或备份恢复

这张表里最容易被忽略的是最后两行:交互式出错,撤销一次编辑就完了;定时任务出错,你得先找到它改了哪些文件,再决定从 worktree、备份还是远端恢复。

关键一步:--mode 写错不报错,静默落成 yolo

cline schedule 七种 --mode 写法与落库 mode 的实测对照,Plan、readonly、末尾带空格的 act 全部静默降级为 yolo

实测用的是同一个仓库、同一台机器,只改 --mode 的写法,7 次创建全部返回成功:

$ cline schedule create "夜跑体检" --cron "0 9 * * *" \
    --prompt "列出没有测试覆盖的文件" --workspace . \
    --mode Plan --disabled --json

{"scheduleId":"sched_c719…","mode":"yolo","enabled":false, …}

只有全小写的 act / plan / yolo 会被接受;Plan、readonly、"act "(尾随空格)都会落到默认值 yolo。3.0.75 的源码里这段逻辑没变:parseMode() 只匹配这三个字面量,其余返回 undefined,调用处写的是 parseMode(opts.mode) ?? "yolo"。

更让人放松警惕的是同一个 CLI 里其他参数都校验得很严:

参数写错时的行为实测输出
--cron硬报错Invalid cron value "25" for range [0-23]
--workspace硬报错required option '--workspace <path>' not specified
--mode静默落到 yolo无

同一个子命令,cron 写错会硬报错,workspace 漏了会硬报错,只有 mode 是宽容的。而且 schedule update 反而会校验:cline schedule update <id> --mode readonly 直接报 error: mode must be one of: act, plan, yolo,原值保持不变。create 和 update 两套标准,这是最容易踩空的地方。

这个坑在真实脚本里通常不是手打出来的,而是这四种来源:

  • 从文档或博客复制的示例写成 Plan、Readonly;
  • YAML / JSON 拼命令时多了空格或引号,变成 "act ";
  • 模板变量为空,命令变成 --mode "";
  • 想当然写 readonly、read-only、dry-run 这类“看起来对”的词。

正确姿势是创建后回读,不信自己写的那串字:

# 只认落库的 mode 字段
cline schedule list --json | jq -r '.[] | "\(.name)\t\(.mode)"'

# 没有 jq 的环境
cline schedule list --json | python -c "import sys,json;[print(x['name'],x['mode'],sep='\t') for x in json.load(sys.stdin)]"

如果已经建错了,用 cline schedule update <id> --mode plan 改回来——它校验,改完再回读一次。

第二个静默变化:3.0.75 起不再读工作目录的 .env

release note 里这句很短,但影响面不小:

The CLI no longer reads .env or bunfig.toml from the directory it is launched in.

以前很多人图省事,把 key、base URL、代理地址写进仓库根目录的 .env,cline 一启动就吃到了。升级后这些变量全部读不到,表现通常不是“报错说缺少 key”,而是 401,或者悄悄换成了默认 provider——任务照样跑,账单和结果都不对。

官方 CLI 文档给出的凭据入口只有两个:cline auth 预置,或运行时 -k 传 key。注意 -k 的 help 原文是 “API key for this run, also saved as the provider’s key”——它会把 key 落盘到配置目录,共享 runner 上要掂量。

# CI 里推荐:先落一次配置,再跑任务
cline auth -p anthropic -k "$ANTHROPIC_API_KEY" -m claude-sonnet-5-5

# 或每次显式传(会写进 providers.json)
cline -P anthropic -k "$ANTHROPIC_API_KEY" -m claude-sonnet-5-5 "修复 lint"

至于 ANTHROPIC_API_KEY 这类环境变量:某些 provider 的 SDK 会自己读,但官方 CLI 文档没把它列成通用入口。升级前如果你的脚本靠 .env 活着,先按上面两种方式改,再谈其他。

第三个变化:--timeout 现在真能掐断第一轮

release note 原文:--timeout 和 Ctrl+C 现在能停掉 one-shot 的第一轮;在此之前,两者都打断不了。

这意味着两件事。第一,你老脚本里的 -t 600 可能一直是装饰品,任务真卡住时会一直挂着。第二,升级后它真的会掐——掐在半个文件改完、依赖装到一半的位置。

场景3.0.743.0.75建议
第一轮卡在装依赖超时无效,一直挂着按秒中断配 --worktree
中断后的工作区没机会产生可能半成品删掉 worktree 重跑
脚本里的 -t 600装饰品真闸门按最慢任务留 1.5 倍余量

想让中断的代价小一点,用 --worktree:help 原文是“Auto-create a detached git worktree under ~/.cline/worktrees/ and run the task there”。任务在游离工作区里改,主仓库不被弄脏,超时了直接删掉那个 worktree 就行。

四步收口:把无人值守的权限压到最小

四步收口:mode 回读校验、PreToolUse hook 拦截 shell、worktree 与 data-dir 隔离、容器与最小权限 token

第一步:mode 写死小写,创建后回读

不要用变量直接拼 --mode,也不要在脚本里写“默认值兜底”。把三个合法值做成白名单,传错就让脚本失败,而不是让 cline 替你选 yolo。

# 创建时显式写全小写
cline schedule create "夜跑体检" \
  --cron "0 9 * * *" \
  --prompt "只读分析:列出没有测试覆盖的文件,输出 Markdown 表格" \
  --workspace /srv/repo \
  --mode plan \
  --timeout 900 \
  --json

# 创建后回读,确认不是 yolo
cline schedule get <schedule-id> --json | jq -r '.mode'

第二步:加 PreToolUse hook,拦掉不该跑的 shell

hook 放在工作区的 .cline/hooks/,文件名必须是事件名 PreToolUse.sh;全局放 ~/.cline/hooks/,或用 --hooks-dir 指定。定时任务落库的 cwd 等于 --workspace(实测),所以把 hook 放进仓库最稳。

#!/usr/bin/env bash
set -eu

payload=$(cat)
tool=$(printf '%s' "$payload" | jq -r '.tool_call.name // .preToolUse.toolName // ""')

# 只审 shell 命令,其他工具放行
[ "$tool" = "run_commands" ] || { echo '{"cancel": false}'; exit 0; }

input=$(printf '%s' "$payload" | jq -c '.tool_call.input // .preToolUse.parameters // {}')

# 先拦最危险的几个动作,跑一周看日志再收紧
if printf '%s' "$input" | grep -Eq 'git[[:space:]]+push|git[[:space:]]+reset|rm[[:space:]]+-rf|npm[[:space:]]+publish|curl|wget'; then
  jq -n --arg m "blocked by cline guard: $input" '{cancel:true, errorMessage:$m}'
else
  echo '{"cancel": false}'
fi
mkdir -p .cline/hooks
# 把上面的内容存成 .cline/hooks/PreToolUse.sh
chmod +x .cline/hooks/PreToolUse.sh

三个注意点:hook 拦到就整轮结束,不是“问问你要不要继续”;规则要窄,先只拦 push / reset / rm -rf / publish,跑一周看日志再收紧;hook 不是沙箱,editor 和 apply_patch 照样能改文件,要防写文件得一起拦。

第三步:--worktree 隔离现场,--data-dir 隔离状态

cline --data-dir ~/.cline/ci-state --worktree "修复 lint 并跑测试"

--data-dir 是全局参数,必须放在 cline 和子命令之间。放到后面会报 error: unknown option '--data-dir'(实测)。3.0.75 源码里的注释还写明:只要传了 --data-dir,就会隐式开启 sandbox 模式,状态目录也跟着换。

第四步:容器、只读挂载、最小权限 token

  • 只挂当前仓库,不要挂 home、不要挂 SSH 目录;
  • 只给仓库级 token,不要用个人 PAT;能用只读就别给写;
  • 出口只放模型 API,其余域名一律拒绝;
  • 跑完保留日志,--json 的 run_result 和 hook 日志都留下来,出事后才有得查。

一份能直接抄的夜间体检配置

cline schedule create "夜跑体检" \
  --cron "0 9 * * *" \
  --prompt "只读任务:1) 列出 src/ 下没有测试覆盖的文件;2) 列出超过 100 行的函数;3) 输出 Markdown 表格。不要修改任何文件;发现异常时只报告,不要尝试修复。" \
  --workspace /srv/repo \
  --mode plan \
  --timeout 900 \
  --max-parallel 1 \
  --tags nightly \
  --delivery-adapter telegram \
  --delivery-thread <thread-id> \
  --json

prompt 四要素:只读指令、输出格式、禁止修改、失败时只报告。少哪一条,模型都会自己找活干。投递结果需要对应的 connector 正在运行,--delivery-thread 的值可以先在聊天里发 /whereami 拿到。

上线顺序:先 schedule trigger <id> 手动跑一次,看 schedule history 的耗时与 token,再看 schedule stats 的成功率。别拿凌晨三点的仓库做首测。

还有一句要重复:plan 模式仍然能跑 python -c 写文件,所以第二步的 hook 不能省。夜间任务改出来的代码,第二天仍然要过验证;这套证据链的做法见《AI 写的代码不敢直接合并:照抄 Claude Code 团队验证三件套》,重构类的改动可以对照《1572 行函数交给 AI 拆成 150 行:6471 个测试全绿,为什么还不能合并》。

同一周的另外三个版本雷

项目症状截至 11-21 的状态你要做的
goosegoose update 在 1.60.x 上 panic:no sigstore-crypto CryptoProvider installed修复 PR #13686 于 11-20 14:29Z 合并;1.60.2 发布于同日 06:18Z,未包含先别跑 update,等下一个版本或从 main 构建
OpenHands Canvas连 1.59–1.62 的 agent-server 时 Experimental 页空白;1.63.0 配 litellm 1.109 在 import 时崩PR #19923 已把最低版本从 1.59.0 抬到 1.63.1固定 agent-server==1.63.1
gemini-cli--resume latest 以前按开始时间排序,长会话会被新开的短会话顶掉PR #30389 改为按最近活跃排序升级后确认恢复的是哪一条

goose 这条值得单独说:根因是 sigstore-verify 从 0.11 升到 0.16 后,crypto provider 被拆进了 sigstore-crypto,而 goose-cli 关掉了默认 features,于是验证发布证明时直接 panic。修复只是把 sigstore-verify/aws-lc-rs 加进 update feature,但没赶上 1.60.2 的发布窗口。

OpenHands 的报错更直白:Agent Canvas requires agent-server 1.63.1 or newer; this backend is running 1.62.0. 看到这句就去升 agent-server,别去翻 Canvas 的代码。

常见翻车报错与急救清单

报错或现象原因处置
error: unknown option '--data-dir'全局参数写在子命令后面放到 cline 与子命令之间
required option '--workspace <path>' not specifiedcreate 漏了工作区补绝对路径
Invalid cron value "25" for range [0-23]cron 时/分越界用标准 5 段 cron,按本机时区
创建成功,但 "mode":"yolo"大小写、尾随空格、非法值schedule update <id> --mode plan 后回读
error: mode must be one of: act, plan, yoloupdate 的校验比 create 严改成全小写三选一
升级后 401,或走了默认 provider不再读工作目录的 .envcline auth 预置或 -k 传 key
hook 完全不触发路径、文件名或可执行位不对.cline/hooks/PreToolUse.sh + chmod +x
jq: command not foundhook 依赖 jq装 jq,或把脚本改成 node 实现
超时后工作区半成品第一轮现在真会被掐断用 --worktree,失败直接删 worktree
npm i -g cline 装完还是 3.0.74npm 的 latest 还没发 3.0.75用 GitHub tag 构建,或等 npm 发布

最后一条是我写这篇时最意外的地方:3.0.75 的 GitHub Release 是 11-21 13:30(北京时间)发的,但截至当天 20:30,npm view cline version 仍然返回 3.0.74(10-26 发布)。也就是说,你现在 npm i -g cline 装到的还是旧默认值。想复现新行为,得从 tag 构建。

什么情况下别挂定时任务

  • 改动需要人审。合并、发布、改生产配置,这些环节本来就要一个人签字,交给凌晨的 agent 只是把风险挪到你看不见的地方。
  • 仓库里有明文密钥。hook 能拦命令,拦不住模型把 .env 读进上下文;先把密钥挪出去再谈自动化。
  • 任务要跨多个仓库或提权。权限越大,hook 越难写对;这种场景更适合人手动跑。
  • 团队没有回滚习惯。没有 worktree、没有备份、没有回滚脚本,出事后只能靠记忆恢复。
  • 只是为了省一次点击。一次性的小任务,交互式跑完看一眼,比配 cron、写 hook、调超时便宜得多。

cline 的定时任务不是不能用,是要把它当成一个“没有上司、没有同事、也没有监控的夜班员工”:权限给到刚好够用,现场隔离好,出事能一键还原。这三件事做完,yolo 也没那么可怕;做完之前,plan 也不是保险箱。

你给 cline 挂的定时任务跑在哪个模式?把 cline schedule list --json | jq -r '.[] | .mode' 的输出贴到评论区,我帮你看有没有静默降级。

登录后可点赞、收藏与反馈。

继续阅读 NEXT

更多 →