Cline SDK v0.2.0 改了一个看着技术、实则要命的行为:重开一个已经在跑的会话。旧版本里,这会另起一个 runtime,原来的 run 还在背后跑,但你已经够不着它了,它写的 transcript 落到一份过期的快照上。v0.2.0 改成复用那个 live session,直接附上去。这篇讲这个改动、源码里的判断,还有 SDK 和 CLI 到底怎么选。

我先给结论。这次改动最有价值的地方,是它把「会话」和「runtime」这两个概念掰开了。会话是你要对话的那条线,runtime 是背后真在跑模型的那个进程。以前重开会话会误伤 runtime,现在不会。这是本质。

会话生命周期,两种行为

这次改动的核心就一句,我照 release 原文说:重开一个已经有 run 在跑的会话,现在会 reattach 到 live session,而不是替换它的 runtime。原来的 run 继续跑,你重新连上它,看到的是实时状态,不是一份过期快照。

配套还有一条硬规则,你重开的时候带了一个 prompt 而那个 run 还在跑,这个重开会被拒。这很好理解:一个已经在跑的 run 不能同时接受两个指令,与其让它跑乱,不如明确拒绝。这个拒绝行为,我认为是对的。先装再看。

我装了它,核对版本

我没只看 release 文字。我装了 @cline/sdk@0.2.0,本机 Node v22.22.2。先看包结构,@cline/sdk 的 main 是 ./dist/index.js,内容只有一行 export * from "@cline/core"。它是个薄封装,真东西在 @cline/core,而 @cline/core 又依赖 @cline/llms。

{
  "name": "@cline/sdk",
  "version": "0.2.0",
  "deps": ["@cline/core"]
}

我打开 @cline/llms 的 package.json 看版本,ai 写的是 ^7.0.136,@ai-sdk/provider-utils 是 ^5.0.58。这两个数字和 release 里「AI SDK updated to ai 7.0.136」完全对得上。我核对这一步,是为了确认 release 里写的版本,包里的依赖是真的这么升了,不是文案。别只看文案。先装,再看源码,这个顺序别反。

复用逻辑在 hub 里

会话复用的逻辑在 @cline/core/dist/hub/index.js 里。我 grep 出两个关键片段。一个是报错类:

SessionRuntime.shutdown called while a run is in progress
  code = session_run_in_progress
  name = SessionRunInProgressError

另一个是会话开始的判断路径,我抽出关键一段:

Session ${n} already has a run in progress; queue the prompt instead.
  return await this.liveSessionStartResult(r)

这两段拼起来就是完整行为,run 在跑时关 runtime,抛 SessionRunInProgressError,不许强杀;重开会话撞上在跑的 run,不替换,改走 liveSessionStartResult 复用。我判断这个设计是对的:runtime 和会话解耦之后,多个客户端能同时连一个会话,谁发起、谁复用,hub 统一调度。

重试从 5 降到 3

这次还动了模型请求的重试,release 写「首次尝试后最多重试 3 次,从 5 降下来」。我查 @cline/llms/dist/index.js 里重试的默认常量,grep 到一行:

var y6=3,w6=250,T6=2000,b6=8

y6 是 maxAttempts 的默认值 3,w6 是 retryDelayMs 默认 250 毫秒,b6=8 是退避因子。降到 3 的意图我理解是少让失败请求在线上占坑,代价是瞬时抖动的容错少了。这个取舍适合线上,不适合弱网本地。

这次还改了哪些地方

除了会话复用和重试,release 里还有几条我挑着说,都有信息量。hub 现在记录每个为会话注册了 capability 的 client,包括中途加入一个已经在跑的 task 的 client,请求发给第一个还连着的那个,全断了就快速失败,报一个用户能处理的错,而不是干等。

还有一条改 compaction 的。auto-compaction 不再在模型输入上限未知的时候跑;首次 compaction 之后,大小估计改用真实发送的消息、工具结果按截断算。之前它高估约 7 倍,导致每几次工具调用就重跑一次 compaction。7 倍这个数我照 release 原文记的。这坑值得记。

第三条是性能。checkpoint diff 改用单次 git cat-file --batch 进程读文件内容,而不是每个文件最多两次 git show。仓库里未跟踪文件多的时候,之前会 spawn 上千个 git 进程。上千个,release 原话。模型目录也从 7041 个缩到 6457 个,新增 Liquid Inference、Munito AI 两个 provider,删了 CrofAI、iFlow 和 Llama。这几个改动加起来,指向同一件事:这个版本在收敛行为,不在加新功能,把「跑乱的」和「跑慢的」都修了一轮。

SDK 和 CLI,选哪个

给个明确分界。你要在一个 Agent 产品里以编程方式开会话、接管 session 生命周期、做多客户端并发,用 SDK,这次改动的会话复用就是为这种场景准备的。你只是想在终端里让 Cline 改个代码,用 CLI 就够,SDK 那套 session 抽象你碰都不碰,白背复杂度。别硬上 SDK。

一句话。v0.2.0 这个改动不大,但它把「重开会话」从一个数据损坏风险,变成了一次干净的复用。接 Agent 运行时的人,值得把这条记进自己的会话管理里。