AI开源软件工具

Cline 同一天连发两版:一次修掉「文件只读到一半」,一次让一次性任务默认自己批自己

2026年11月22日2 次阅读Read in English
Cline 同一天连发两版:一次修掉「文件只读到一半」,一次让一次性任务默认自己批自己

3分钟看懂

2026 年 11 月 21 日,开源编程 Agent 项目 Cline 在同一天推了两个版本:编辑器扩展 4.1.27(UTC 06:05)和命令行工具 3.0.75(UTC 05:30)。两件事最值得注意:

  1. 扩展端修掉了一个隐藏的第二道截断。文件读取工具本来允许读到 2000 行、约 4.8 万字符,但结果在送往模型之前又被砍到 8000 字符,而且是从中间砍掉——Agent 能看到函数开头和结尾,却看不到中间那个分支。修复后,读文件走文件内容的完整配额。
  2. 命令行端的一次性任务默认进了 yolo 模式。以前跑 cline "帮我改这个 bug" 这种无人值守的任务,默认是 act 模式,需要人点确认;现在因为「键盘前没人」,默认不再等审批。

一句话:一个是「Agent 读的代码其实少了半截」,一个是「Agent 自己批自己」。两个都跟信任边界有关,只是方向相反。

本文基于 Cline 官方 GitHub Release Notes,以及 Freedom.Tech、Code×Radar、AIDev.news 等多家媒体的转述整理。

那个 8k 截断是怎么发生的

这是本次最容易被忽略、但对日常使用影响最直接的一条。

Cline 的 read_files 工具本身有明确上限:一次最多 2000 行,或大约 48000 字符。超了就分段读,工具还会告诉 Agent「你拿到了哪些行」,方便它接着要下一段。这部分设计没问题。

问题出在后面的环节:Cline 把消息整理好送给模型提供商时,把文件读取结果当成普通命令输出处理,套用了 8000 字符的工具结果预算,并且采用「保留头尾、砍掉中间」的截断方式。

一位修这个问题的贡献者用一份 751 行的 Markdown 文件做了验证:读取产生了 47384 个字符,但真正送到提供商的只有 7967 个。也就是说,Agent 名义上「读了整个文件」,实际只看到开头和结尾。

这对代码审查场景的杀伤力很具体:Agent 可能读到函数的入口和最后的 return,却漏掉中间那个 if 分支。它给出的结论看起来合理,但基于的是残缺的上下文。更麻烦的是,工具底部的提示行还在告诉你「这些行我看到了」,落差不会自己暴露。

修复方式是把文件读取改走已有的「文件内容」配额,让它按自己的上限完整送达。普通命令输出、搜索、MCP、自定义工具的结果仍然保留 8k 上限;显式配置的工具结果上限依然生效。

yolo 默认化:方便,但要知道边界

CLI 3.0.75 改的是默认行为:一次性任务(直接给一个 prompt 参数,或者把 stdin 管道进去)现在默认从 act 模式切到 yolo 模式。理由写在 release notes 里——「键盘前没人来批准工具调用」。

同时它保留了五种例外,这些情况仍然走 act 模式:

  • 关掉了自动批准(--auto-approve false,或者设置里存了关闭)
  • 显式传了模式 flag
  • 保存的是 plan 模式
  • prompt 是一个 /team 提示
  • 需要团队工具时(yolo 模式没有 team tools,得加 --act)

另外修了一个老问题:--timeout 和 Ctrl+C 以前打断不了一次性任务的第一轮,现在能了。还有一条不太显眼但和安全有关——CLI 不再从启动目录读取 .env 或 bunfig.toml,少了被工作目录里的文件悄悄影响行为的入口。

如果你在 CI 或脚本里调 Cline CLI,这两条要一起看:默认不再等审批,意味着出错时没有人在中途拦一下;而能被打断,意味着你至少还能靠超时兜底。

顺带改了什么

模型目录整体刷新。 从 models.dev 合并进来 94 个提供商,移除了 Lilac 和 Tempr。推荐列表加入 Muse Ember,免费列表移除了 Reflection Beam、Laguna S 2.1、Solar Mini 4。有 67 个提供商的默认模型发生变化,主要集中在 Kimi K3.1 Pro、Gemini 4 Neon 和 DeepSeek V4.1 Flash 1017。ClinePass 那边则下掉了一批模型。

推理档位的一串修复。 选「None」现在会被保存并真正发出去(之前 Azure 上的 GPT-6 会保留默认档位,然后拒绝工具调用);给自定义模型关掉推理也能生效了;原生 OpenAI 提供商会按每个模型实际支持的能力调整推理档位,max 和 Extra High 不再被 GPT-5.x 和 o 系列拒绝。Reflection Beam 在压缩上下文或切换模型后每轮都报 400 Missing required parameter 的问题也修了。

小改动。 LM Studio 设置里加了 API key 字段,给开了「Require Authentication」的本地服务器用;MCP 标签页会给声明为只读的工具加「read-only」徽标;账户页加了隐私设置入口;扩展包里补上了第三方许可证声明。CLI 端删掉了 CLINE_CAPTURE_* 这组会把完整提供商请求体写到磁盘的调试变量,undici 升到 7.30.1 修了两个进程崩溃问题。

同一天还发了桌面版 0.0.50 和 SDK 0.2.1,改动与上面基本同源。

适用场景:谁该马上更新

  • 经常让 Cline 读大文件做审查的人。 如果你以前遇到过「Agent 说这个函数没问题,但其实它没看到中间那段」,更新后重开一次读取,让它按范围重新读一遍,是最直接的收益。
  • 把 Cline CLI 放进脚本或 CI 的人。 默认进 yolo 模式是行为变化,不是 bug。要么接受它、用 --timeout 兜底,要么显式加 --auto-approve false 把审批拿回来。
  • 依赖第三方模型或本地模型的人。 模型目录刷新和推理档位修复,主要受益的是这类用户。

不适用场景与避坑

  • 不要指望这次更新解决「大文件读不全」。 2000 行 / 4.8 万字符的工具上限没变,超大文件仍然要分段要。这次修的只是「明明读到了却被二次截断」。
  • 不要在共享机器或生产环境里无脑接受 yolo 默认值。 无人审批意味着一条错误的 shell 命令可以直接执行。用 --auto-approve false,或者至少把工作目录和凭据隔离开。
  • 不要在需要团队工具的流程里漏掉 --act。 yolo 模式没有 team tools,脚本会静默地拿不到那些能力。
  • 注意成本变化。 文件读取不再被砍到 8k,意味着同样一次读取会送出更多 token,长文件场景的输入成本会上升。这不是涨价,是你以前在为「残缺上下文」省钱。

怎么用:三步上手

行动建议按下面三步走,十分钟能做完:

  1. 扩展更新到 4.1.27,CLI 更新到 3.0.75(npm i -g cline 或你惯用的安装方式),然后重启编辑器。
  2. 找一个以前审查漏过段落的长文件,重新发起一次读取,确认返回的字符数和文件规模对得上。
  3. 检查你的脚本:显式决定要 yolo 还是 act。加 --timeout,需要团队工具就加 --act。

参考来源

  • Cline 官方 Release v4.1.27:https://github.com/cline/cline/releases/tag/v4.1.27
  • Cline 官方 Release cli-v3.0.75:https://github.com/cline/cline/releases/tag/cli-v3.0.75
  • Freedom.Tech《Cline 4.1.27》:https://freedom.tech/posts/2026-11-21-cline-4-1-27/
  • Code×Radar《Cline 4.1.27 fixes a second cutoff that hid the middle of file reads》:https://codexradar.dev/changes/cline-4-1-27-file-read-truncation/
  • AIDev.news《Cline v4.1.27 Adds API Key Field, Expands Model Catalog, and Improves File Handling》:https://www.aidev.news/article/cline-v4-1-27-adds-api-key-field-expands-model-catalog-and-improves-f

参考来源

评论

0 条已公开
登录或注册后可以参与评论。

正在加载评论...