9.1 KiB
Note
本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
Cline
在你的 IDE 和终端中运行的开源编码智能体。
CLI在终端中运行 Cline。 支持交互式聊天,也可在 CI/CD 和脚本中完全无头(headless)运行。 |
Kanban通过基于 Web 的任务看板并行运行多个智能体。每张卡片拥有独立的工作树(worktree)、自动提交和依赖链。 |
VS Code Extension编辑器中的 AI 编程助手。 创建文件、运行命令、浏览网页,并在人机协同(human-in-the-loop)审批下使用工具。 |
JetBrains Plugin在 IntelliJ IDEA、PyCharm、WebStorm、GoLand 及整个 JetBrains 产品家族中享受相同的 Cline 体验。 |
SDK基于驱动 CLI、Kanban、VS Code 扩展和 JetBrains 插件的同一引擎,构建你自己的 AI 智能体与集成。支持自定义工具、多智能体团队、连接器、定时自动化等更多能力。 |
索引
| 产品 | 描述 | 位置 | CHANGELOG |
|---|---|---|---|
| SDK | Node.js 程序化智能体 API 与扩展导出。 | sdk/ |
CHANGELOG.md |
| CLI | 终端 UI、无头模式、Shell 命令及 CLI 专属流程。 | apps/cli/ |
CHANGELOG.md |
| VS Code Extension | Marketplace 扩展及扩展宿主集成。 | / (WIP migrating) |
CHANGELOG.md |
| JetBrains Plugin | 与共享智能体核心通信的 JetBrains 托管客户端。 | 目前我们尚未开源 JetBrains 插件 | - |
| Kanban | 基于 Web 的多智能体任务看板。 | cline/kanban |
CHANGELOG.md |
| Docs site | 公开文档页面。 | docs/ |
- |
跨项目编辑代码
Cline 会读取你的项目结构,理解文件之间的关系,并在整个代码库中进行协同修改。它在工作时监控 linter 和编译器错误,在你察觉之前就修复缺失导入、类型不匹配和语法错误等问题。在 VS Code 和 JetBrains 中,每次编辑都会以 diff 形式呈现,供你审阅、修改或撤销。所有更改都通过检查点(checkpoint)追踪,因此你可以轻松撤销智能体的工作。
运行 Bash 命令
Cline 会直接在你的终端中执行命令并实时监视输出。安装软件包、运行构建脚本、执行测试、部署应用、管理数据库。对于开发服务器等长时间运行的进程,Cline 会在后台继续工作,并在新输出出现时作出响应,及时捕获编译错误、测试失败和服务器崩溃。
规划与执行
在 Plan 模式与 Act 模式之间切换。在 Plan 模式下,Cline 会探索你的代码库、提出澄清问题并制定策略。双方达成一致后,切换到 Act 模式,Cline 便会执行计划。每次文件编辑和终端命令都需要你的批准,因此你始终掌控实际发生的变化。也可以开启自动批准,让 Cline 自主运行。
规则与技能(Skills)
在 .clinerules 文件中定义项目专属规则,指导 Cline 在你的代码库中如何工作:编码标准、架构约定、部署流程、测试要求等。CLI、VS Code 扩展和 JetBrains 插件会自动加载这些规则。使用 skills 让模型在需要时加载特定规则。
适配各类模型
Cline 不绑定单一 AI 提供商。可选用最适合你工作流的模型:
| 提供商 | 模型 |
|---|---|
| Anthropic | Claude Opus, Sonnet, Haiku |
| OpenAI | GPT 系列模型 |
| Gemini 系列模型 | |
| OpenRouter | 来自各提供商的 200+ 款模型 |
| Vercel AI Gateway | 通过单一网关路由至多个提供商 |
| AWS Bedrock | Claude、Llama 等 |
| Azure / GCP Vertex | 全部托管模型 |
| Cerebras / Groq | 高速推理模型 |
| Ollama / LM Studio | 在本地机器上运行本地模型 |
| Any OpenAI-compatible API | 自托管或第三方端点 |
通过插件或 MCP 服务器扩展
通过插件扩展 Cline 的能力。借助 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], /* ... */ })
……或通过 MCP 服务器 连接数据库、查询 API、管理云基础设施并与外部系统交互。使用社区构建的服务器,或让 Cline 即时创建自定义工具。在 CLI 中,使用 cline mcp 管理服务器。
多智能体团队
协调多个智能体协同处理复杂任务。协调者智能体将工作拆分为子任务并委派给专家智能体,各自拥有独立的工具与上下文。团队状态在会话间持久保存,可随时从中断处继续。
cline --team-name auth-sprint "Plan and implement user authentication with tests"
定时智能体
按 cron 计划运行智能体,实现周期性自动化:每日 PR 摘要、每周依赖检查、代码库健康报告等。计划在重启后仍然保留,且不依赖任何终端会话独立运行。
cline schedule create "PR summary" \
--cron "0 9 * * MON-FRI" \
--prompt "List all open PRs and their review status" \
--workspace /path/to/repo
连接 Slack、Telegram、Discord 等
从任意消息平台与你的智能体对话:Telegram、Slack、Discord、Google Chat、WhatsApp 和 Linear。每个对话线程对应一个具备完整上下文的智能体会话。可配置访问控制,限制谁可与你的智能体交互。
# Connect to Telegram
cline connect telegram -k $BOT_TOKEN
# Connect to Slack through webhook
cline connect slack --bot-token $SLACK_TOKEN --signing-secret $SECRET --base-url $URL
# Connect to Slack using socket mode
cline connect slack --bot-token $SLACK_TOKEN --app-token $SLACK_APP_TOKEN
适用于 CI/CD 的无头 CLI
以零交互方式运行 Cline,用于脚本编写与自动化。管道输入、获取 JSON 输出、串联命令,并集成到 CI/CD 流水线中。
cline "Run tests and fix any failures"
git diff origin/main | cline "Review these changes for issues"
cline --json "List all TODO comments" | jq -r 'select(.type == "agent_event" and .event.text) | .event.text'
贡献
请先阅读贡献指南。加入我们的 Discord,前往 #contributors 频道与其他贡献者交流。查看我们的招聘页面,了解全职岗位。