📝

「每天读一个开源项目」第 47 期：拆解 Cline（65K⭐）的五层 SDK 分离架构——从打磨两年的 Agent 运行时提炼出 @cline/sdk，让任何应用都能嵌入自主编程能力；Plan/Act 双模式把安全性内建于架构而非后加。

Cline 架构封神：64K Star 的 AI 编程助手如何把 Agent 运行时抽象成 SDK

原文：小红书 @毎日AI开源情报🐙《做AI编程的注意了，Cline这架构封神》·「每天读一个开源项目」系列第 47 期 · 项目：cline/cline

64,728 ⭐（API 实测 65,324），Apache-2.0，VSCode 最受欢迎的 AI 编程助手——但 Cline 真正的野心远不止于此。

📌 一句话：Cline 把打磨了两年的 Agent 运行时抽象成了独立 SDK，让任何应用都能嵌入自主编程能力。

核心架构：五层分离

Cline 的仓库被组织成五个 @cline/* 包，每一层只依赖它下面的层：

@cline/shared — 共享契约层：零依赖的类型定义，跨包通信的「宪法」
@cline/llms — LLM 抽象层：20+ 模型厂商统一接入，支持 Gateway 路由和计费
@cline/agents — 无状态 Agent 运行时：纯循环逻辑（工具 → Hook → 扩展 → Team），没有持久化
（上两层）：产品形态层（CLI / VS Code 扩展 / JetBrains 插件 / Kanban）与 SDK 导出层

README 的产品索引印证了这套「一个引擎、多形态」的组织方式：

产品	说明	位置
SDK	Node.js 程序化 Agent API 与扩展导出	`sdk/`
CLI	终端 UI、headless 模式、shell 命令	`apps/cli/`
VS Code 扩展	Marketplace 扩展与宿主集成	仓库根目录
JetBrains 插件	共享 Agent 核心的 JetBrains 客户端	暂不开源
Kanban	网页版多 Agent 任务看板	`cline/kanban`
Docs 站点	公开文档	`docs/`

深入一个设计：Plan/Act 双模式

Cline 用一个巧妙的工具切换实现了安全与能力的平衡：

Plan 模式：Agent 只能用 plan_mode_respond 工具——只能讨论、提问、做计划，完全不能碰文件
Act 模式：Agent 拥有完整工具集——但每次文件修改前都要经过审批门（ApprovalGate）

这不是安全插件，而是架构的有机组成——安全性内建而非后加。

SDK 化的玩法

import { Agent, createTool } from "@cline/sdk"

const deployTool = createTool({
  name: "deploy",
  description: "Deploy the current branch to staging.",
  inputSchema: { type: "object", properties: { env: { type: "string" } }, required: ["env"] },
  execute: async (input) => {
    // your deployment logic
  },
})

const agent = new Agent({ tools: [deployTool], /* ... */ })

安装：npm install @cline/sdk（或全局 CLI：npm i -g cline）。

模型无关 + 生态扩展

Works With Every Model：Anthropic、OpenAI、Google、OpenRouter（200+ 模型）、Vercel AI Gateway、AWS Bedrock、Azure/GCP Vertex、Cerebras/Groq、Ollama/LM Studio、任意 OpenAI 兼容 API
规则与技能：.clinerules 文件定义项目规范，skills 按需加载
插件 + MCP：SDK 注册工具和生命周期 Hook（日志、审计、策略执行），或接 MCP 服务器
Multi-Agent Teams：coordinator agent 拆解任务委派 specialist，团队状态跨会话持久
Scheduled Agents：cron 定时跑（每日 PR 摘要、每周依赖检查）
消息平台接入：Telegram、Slack、Discord、Google Chat、WhatsApp、Linear，每条会话线程映射一个 agent 会话

GitHub 数据验证

指标	值
仓库	cline/cline
Stars	65,324（2026-08-01 API 实测；笔记称 64,728）
Forks	7,020
语言	TypeScript
协议	Apache-2.0
创建	2024-07-06
最近更新	2026-07-31
Fork？	否（原创仓库）

适合谁

后端架构师 → 学「SDK 化」方法论（从产品提取平台）
AI 应用开发者 → 理解 Agent 循环设计
开源贡献者 → 570K LOC 大仓的组织方式

📌 「每天读一个开源项目」系列第 47 期。下期预告：CopilotKit；上期回顾：LangGraph（38K⭐）。

💬 本文评论区已开启，但暂无读者留言。