Cline SDK

Cline SDK 是什么？

Cline SDK（@cline/sdk）是从 Cline 中提取的 TypeScript 智能体运行时基础，旨在为多个界面（包括 IDE 和 CLI）的代理式编码工作流提供支持。其核心目的是提供模块化、可复用的“agent harness”与架构，让团队能够构建和扩展智能体，而无需绑定到单一应用的 UI 生命周期。

Cline 的重新设计将运行时视为共享服务，而非将智能体循环与 VS Code 扩展耦合。这使得长时间运行的任务能够独立于 UI 重启继续执行，并支持在不同界面间移动会话，同时保持底层智能体循环的可复用性和无状态特性。

主要功能

• 共享智能体运行时架构：将运行时与特定 IDE 实现分离，使工作更少依赖于 UI 重启。
• 可复用智能体 harness（无状态循环）：保持底层智能体循环无状态且可复用，同时外围运行时可实现持久化和可移植性。
• 分层 TypeScript 技术栈：采用分层设计，每层职责单一，可根据需求选择完整栈或单独包。
• 运行时层插件系统：插件可注册工具、观察生命周期事件、添加规则/命令，并影响模型所见内容。
• 灵活的插件加载与打包：插件可从配置路径或工作区位置加载，支持从本地 .ts/.js 模块起步，后续通过 cline.plugins 清单演进为打包模块。
• Provider 层 LLM 支持（开放选择）：Provider 层支持多种提供商和 OpenAI 兼容端点，切换提供商可通过配置驱动。

如何使用 Cline SDK

1. 安装 SDK：通过 npm i -g @cline/sdk 安装完整栈。
2. 选择界面：使用 Cline SDK 为 VS Code、JetBrains 和 CLI 中的智能体提供支持（Cline 自身界面均基于该 SDK 构建）。
3. 通过运行时插件扩展行为：创建插件模块（或打包为模块），以注册工具并响应生命周期事件。
4. 配置模型/Provider 访问：通过 Provider 层配置选择智能体应调用的模型/提供商。

使用场景

• 跨重启的长时间智能体任务：运行智能体任务时，即使 UI 重启也不会中断，因为运行时设计为持久化且不绑定单一 UI 生命周期。
• 跨多界面的持久化智能体构建：在不同界面（如 IDE 和 CLI）间移动会话，同时保持智能体循环无状态且可复用。
• 通过插件实现团队专属智能体定制：通过加载插件添加领域特定行为（如额外工具、规则或命令），无需分叉运行时。
• 本地原型开发，后续打包：先以本地 .ts/.js 模块实现插件，待团队通过 cline.plugins 清单固化功能后，再打包为可复用目录。
• 无服务器或可组合智能体运行时：当需要将智能体行为嵌入其他运行时模型时，可使用分层栈中的较小部分（如 Provider 逻辑或无状态循环）。

常见问题

• Cline SDK 是否仅绑定 VS Code 扩展？ 否。该 SDK 旨在为 VS Code、JetBrains 和 CLI 上的 Cline 提供支持，并设计为让团队能够基于运行时构建，而非仅复用 IDE 特定实现。

• 智能体循环中的“无状态”指什么？ 重新设计保持底层智能体循环无状态且可复用，同时外围运行时提供持久化和可移植性。

• 插件如何影响模型行为？ 插件可在执行前或执行期间注册工具、观察生命周期事件，并影响智能体所见内容（包括规则和命令）。

• 是否可在不重写智能体的情况下切换 LLM 提供商？ Provider 层支持配置驱动，兼容多种提供商和 OpenAI 兼容端点。

• 是否需要安装完整 SDK 栈才能开始使用？ 该 SDK 采用分层设计：可安装完整栈，也可使用单个包（如 Provider 层或无状态循环）以适配较小界面。

替代方案

• 使用现有智能体框架搭配自定义运行时：如果需要完全掌控会话持久化和工具编排，且已维护自己的运行时，现有智能体框架方案可能更合适。
• 基于 IDE 专属智能体扩展模型构建：部分方案将智能体循环保留在 IDE 插件内，起步更简单，但运行时行为可能与 UI 生命周期更紧密耦合。
• 使用通用 LLM 工具编排层：与智能体 harness + 运行时架构不同，工具编排方案侧重调用模型和工具，通常将会话持久化和生命周期管理交给应用代码处理。