01WHAT IT SOLVES
这个项目解决什么问题?
Cline 定位为开源的自主编程代理,采用 TypeScript 构建,将同一套核心引擎包装为命令行工具、原生桌面应用、VS Code 与 JetBrains 插件,以及可编程的 SDK,并以 Apache 2.0 协议开源。它既能在编辑器内协作改动文件、执行命令、监控编译错误,也能在 CI/CD 中以无头模式运行,还能通过定时任务或 Slack、Discord 等聊天工具远程触发。相较于仅做补全的 AI 编程工具,它强调多步规划、文件级 diff 审批、MCP 与插件扩展、跨多家模型提供商的开放接入,以及多 Agent 协作,介于轻量代码助手与全自主 Agent 框架之间。
02CORE CAPABILITIES
核心能力
跨文件协同编辑
读取项目结构、跨多文件协调改动,并实时捕获 lint 与编译错误
终端命令执行
在本地终端直接运行构建、测试、部署与长进程,捕获实时输出
Plan 与 Act 双模式
先规划再执行,每步编辑与命令需用户审批,也可切换自动批准
多模型开放接入
支持 Anthropic、OpenAI、Google、AWS Bedrock、Ollama 等众多提供商
插件与 MCP 扩展
通过 SDK 注册插件或接入 MCP 服务器,扩展数据库、云等外部能力
03适合谁
- 想要在 IDE 内直接让 AI 改文件、跑命令的独立开发者
- 同时使用 VS Code 与 JetBrains 并希望统一 AI 体验的团队
- 希望把代理能力通过 SDK 或无头 CLI 接入 CI/CD 的工程团队
- 需要用聊天平台或定时任务触发编码与运维工作的平台工程师
04典型使用场景
- 在 IDE 中完成多文件重构、修复编译错误与运行调试
- 通过无头 CLI 把代理接入 CI/CD 做自动修复或脚本生成
- 用定时任务生成日报 PR 摘要、依赖巡检等周期性工作
- 通过 Slack、Discord 等聊天工具远程委派编码或运维任务
05为什么值得关注
- 同一核心引擎覆盖 SDK、CLI、桌面、VS Code 与 JetBrains,形态在同类项目中较少见
- 不绑定单一模型提供商,可灵活切换本地或多家云端模型
- 桌面端迭代节奏快,仓库近一周内多次发版,反映团队投入
- 已开始向多 Agent 协作与定时调度平台化方向演进
06采用前要注意
- JetBrains 插件目前未开源,只能使用官方发行版
- 大量能力依赖用户自行配置模型 API、审批规则与 MCP,存在上手门槛
- 桌面端版本号仍处于 0.0.x,行为与界面可能在后续版本中调整
- 当前 README 与 release notes 均为英文,中文文档与本地化资料相对有限
07RELEASE INTELLIGENCE
近期版本变化
cline desktop-v0.0.26:Composer 集成 GitHub PR 信息
桌面端编辑器面板新增当前分支对应 GitHub PR 的展示,包括编号、合并状态、变更行数与 CI 检查;Customize 视图的 Tools、Skills、Rules 标签统一为列表样式并调整顺序;签出 ChatGPT 凭据会真正清除、发送图片附文本为空时改为提示补全、不支持的图像格式在附件阶段即被拒绝。需要本机已安装并登录 GitHub CLI,以及配置 GitHub.com origin 远程的仓库。
- Composer 展示当前分支 PR 的状态、变更行数与 CI 检查,可跳转浏览器
- Customize 的 Tools、Skills、Rules 标签统一为列表样式并调整顺序
- ChatGPT 退出登录会真正清除凭据,失败时也会明确提示
- HEIC、TIFF、SVG 等模型无法读取的图像格式在附件阶段即被拒绝
cline desktop-v0.0.25:ChatGPT 模型清单收紧与 Windows 安装修复
桌面端将 ChatGPT 订阅可见的模型限定为套餐实际可用项,调整默认模型并修正上下文上限;修复 Windows 上后台守护进程持有旧版文件导致升级失败的问题;本地 CLI 认证方式(Claude Code、Codex CLI、OpenCode)现在可不填 API Key 直接启动会话;推荐与订阅模型列表在首次启动即可用。影响使用 ChatGPT 订阅、Windows 安装或多提供商切换的用户。
- ChatGPT 模型清单只展示套餐内模型,并按实际上下文上限展示
- Windows 安装器在升级前会先停止旧版后台进程,避免文件占用
- 本地 CLI 认证的提供商不再强制要求 API Key 即可启动会话
- 推荐与订阅模型列表内置到安装包,首次启动无需联网拉取
cline desktop-v0.0.24:修复聊天流重复与长任务卡顿
桌面端修复了实时聊天流重复渲染并丢失消息的缺陷,以及排队的用户消息在回复前被清掉的问题;当模型陷入重复工具调用时不再静默停止,会询问用户是换方案还是停止;editor 工具的错误信息新增文件名与 old_text 状态说明,Cline Pass 模型选择在新建会话时不再被静默覆盖。影响所有使用桌面端长任务与定时任务的开发者。
- 修复聊天流重复渲染与消息丢失,会话中途不再丢消息
- 模型陷入重复调用时会主动询问是换方案还是停止
- editor 工具错误信息补充文件名与 old_text 缺失说明,便于模型自纠
- Cline Pass 模型选择在新建会话时不再被目录覆盖
cline desktop-v0.0.23:Hub 统一管理插件并收敛升级提示
桌面端把 Agent Plugins 的发现与运行交给共享 Hub,并把 Customize 中的插件、技能、规则、MCP 与 Hooks 重新整理;修复了 Hub 版本一致时每次启动都弹出升级提示的问题,以及单个 MCP 服务器卡住导致其他进程无法关闭的资源泄漏;登录流程新增设备码在应用内显示,语音输入失败可直接跳转到设置。
- Agent Plugins 由 Hub 统一发现,并自动启动其 stdio、HTTP 与 SSE MCP 服务器
- 当 Hub 与应用核心版本一致时不再每次启动都弹升级提示
- 登录时设备码在应用内可见,便于与浏览器确认码比对
- 修复单个 MCP 服务器卡住导致其他进程无法关闭的泄漏问题
cline desktop-v0.0.23-beta.1:可选加入图像生成功能
桌面端 Beta 在 Customize 的 Tools 中加入图像生成配置,提供方凭据保留在服务端,生成结果保留在会话历史;调度任务按运行时环境分组,本地与同名 SSH 调度不再互相覆盖,SSH 环境下的媒体生成设置说明也已补充。同时包含截至 0.0.22 的稳定改进,例如可恢复的会话导入与 Hub 升级修复。需要关注图像生成功能的凭据归属与隐私策略。
- Customize 的 Tools 中新增图像生成配置,提供方凭据保留服务端
- 调度任务按本地与 SSH 运行环境分组,避免同名调度互相覆盖
- SSH 环境下媒体生成设置明确说明只作用于本地运行时
- 包含 0.0.22 的稳定改进,如可恢复的会话导入与 Hub 升级修复
cline v4.1.17:修复后台进程内存膨胀与凭据粘贴异常
本次更新通过 SDK 生效,重点修复 Hub 长会话内存膨胀、钩子脚本崩溃导致任务中断、模型目录能力误判丢工具等问题,并改进 API key 粘贴与 Codex OAuth 错误提示。影响所有使用 SDK bundle 的窗口客户端。
- Hub 会话状态改为增量广播,避免长任务内存膨胀到数十 GB
- 修复 Dify、SAP AI Core、opencode、Codex CLI 等模型工具被错误禁用
- 粘贴的 API key 自动剔除零宽字符等不可见字符,错误信息明确指向凭据
- 取消任务时同步停止其派生的子代理与团队成员
cline desktop-v0.0.22:桌面端支持三方会话导入与默认模型调整
桌面端支持从Claude Code、Codex、opencode导入历史会话,调度任务合并为可折叠分组,macOS语音输入与Web搜索默认开启,Hub升级加入会话数提示,模型目录新增8家供应商并调整36家默认模型,其中Anthropic改为Claude Fable 5.1。影响所有桌面用户,使用默认模型的团队需注意模型变更。
- 支持从Claude Code等三款外部工具导入历史会话
- 调度任务合并为可折叠分组并附带运行计数
- macOS语音输入权限补齐并默认开启Web搜索
- 模型目录新增8家供应商并调整36家默认模型
Cline cli-v3.0.61:缩短远程 MCP 故障恢复时间
CLI 版本对启用的远程 SSE 或流式 HTTP MCP 服务器设置 10 秒连接预算,避免不可达服务拖垮会话;同时修复 Dify、SAP AI Core、opencode 与 Codex CLI 的工具调用和图片输入。老版本 Hub 替换前会提示将中断的活动会话,Windows 二进制也改为 Authenticode 签名。凭据诊断、Langfuse、检查点安全、定时任务持久化及子代理取消均有改进。模型目录说明末尾被截断,官方说明未提供更多细节。
- 旧 Hub 替换前会显示中断数量,完成运行排空后才执行替换,无法排空的 Hub 不会被终止
- 不可达的远程 MCP 服务器具有 10 秒连接预算,不再触发整个会话启动超时
- 修复部分模型的工具调用和图片输入,并恢复发布构建中的 Langfuse 追踪
cline sdk/sdk/v0.0.82:版本变化解读
本 SDK 版本修复了网关模型工具调用被静默禁用的问题,影响 Dify、SAP AI Core、opencode、Codex CLI 等提供方,原因是不同来源的能力描述漂移导致空列表被当作否定;修复 Langfuse 在压缩构建中无法启用的问题;新增 SessionImportService,可从 Claude Code、Codex、opencode 导入会话历史;修复 Hub 在运行中工作被强制替换的问题;恢复检查点改为 compare-and-swap;远程 MCP 服务器连接设 10 秒超时;apply_patch 保留 CRLF 换行;全局规则新增读取 ~/Cline/Rules。面向
- 修复网关模型工具调用被静默禁用
- 新增 SessionImportService 跨工具导入历史
- Hub 替换改为带排空屏障的安全模式
- 远程 MCP 服务器连接设 10 秒超时
cline desktop-v0.0.22-beta.1:版本变化解读
桌面内测版为通过认证的内部账号开通 Composio 连接器,工具直接注册到打包后的桌面运行时,并改进 OAuth 撤销与连接重连的稳健性。新桌面会话默认开启 web 检索,同时引入此前 0.0.21 稳定版的全部改进,包括双栏 Marketplace 浏览、子代理稳定取消、完整附件拖拽、模型目录实时刷新与更明确的 provider 鉴权错误。仅供内测账号使用,需等待正式版以获取相同能力。
- 内测账号可在桌面端直接使用 Composio 连接器
- 新桌面会话默认开启 web 检索
- 包含 0.0.21 稳定版的全部改进