diff --git a/README.md b/README.md index 055918f..7a49da2 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,9 @@ + +> [!NOTE] +> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。 +> [English](./README.en.md) · [原始项目](https://github.com/cline/cline) · [上游 README](https://github.com/cline/cline/blob/HEAD/README.md) +> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。 +

Cline

@@ -5,7 +11,7 @@

Cline

-The open source coding agent in your IDE and terminal. +在你的 IDE 和终端中运行的开源编码智能体。

@@ -14,7 +20,7 @@ The open source coding agent in your IDE and terminal.
-Docs +文档 Discord @@ -23,10 +29,10 @@ The open source coding agent in your IDE and terminal. r/cline -Feature Requests +功能请求 -Join us! +加入我们！
@@ -43,15 +49,14 @@ The open source coding agent in your IDE and terminal. ### CLI -Run Cline in your terminal. -Interactive chat or fully headless -for CI/CD and scripting. +在终端中运行 Cline。 +支持交互式聊天，也可在 CI/CD 和脚本中完全无头（headless）运行。 ``` npm i -g cline ``` -Learn more +了解更多

@@ -59,15 +64,13 @@ npm i -g cline ### Kanban -Run many agents in parallel from a -web-based task board. Each card gets its own -worktree, auto-commit, and dependency chains. +通过基于 Web 的任务看板并行运行多个智能体。每张卡片拥有独立的工作树（worktree）、自动提交和依赖链。 ``` npm i -g kanban ``` -Learn more +了解更多

@@ -77,11 +80,10 @@ npm i -g kanban ### VS Code Extension -AI coding assistant in your editor. -Create files, run commands, browse the web, -and use tools with human-in-the-loop approval. +编辑器中的 AI 编程助手。 +创建文件、运行命令、浏览网页，并在人机协同（human-in-the-loop）审批下使用工具。 -Install from VS Marketplace +从 VS Marketplace 安装

@@ -89,11 +91,9 @@ and use tools with human-in-the-loop approval. ### JetBrains Plugin -The same Cline experience in IntelliJ IDEA, -PyCharm, WebStorm, GoLand, and the rest of -the JetBrains family. +在 IntelliJ IDEA、PyCharm、WebStorm、GoLand 及整个 JetBrains 产品家族中享受相同的 Cline 体验。 -Install from JetBrains Marketplace +从 JetBrains Marketplace 安装

@@ -108,13 +108,13 @@ the JetBrains family. ### SDK -Build your own AI agents and integrations powered by the same engine that runs the CLI, Kanban, VS Code extension, and JetBrains plugin. Custom tools, multi-agent teams, connectors, scheduled automations, and more. +基于驱动 CLI、Kanban、VS Code 扩展和 JetBrains 插件的同一引擎，构建你自己的 AI 智能体与集成。支持自定义工具、多智能体团队、连接器、定时自动化等更多能力。 ``` npm install @cline/sdk ``` -Documentation +文档

@@ -124,53 +124,53 @@ npm install @cline/sdk --- -## Index +## 索引 -| Product | Description | Location | CHANGELOG | +| 产品 | 描述 | 位置 | CHANGELOG | |---------|------------|--------------|--------------| -| **SDK** | Node.js programmatic agent API and extension exports. | [`sdk/`](https://github.com/cline/cline/tree/main/sdk) | [CHANGELOG.md](https://github.com/cline/cline/blob/main/sdk/CHANGELOG.md) | -| **CLI** | Terminal UI, headless mode, shell commands, and CLI-specific flows. | [`apps/cli/`](https://github.com/cline/cline/tree/main/apps/cli) | [CHANGELOG.md](https://github.com/cline/cline/blob/main/apps/cli/CHANGELOG.md) | -| **VS Code Extension** | The Marketplace extension and extension host integration. | [`/`](https://github.com/cline/cline/tree/main) (WIP migrating) | [CHANGELOG.md](https://github.com/cline/cline/blob/main/CHANGELOG.md) | -| **JetBrains Plugin** | JetBrains-hosted client that talks to the shared agent core. | Currently we are not open-sourcing JetBrains plugins | - | -| **Kanban** | Web-based multi-agent task board. | [`cline/kanban`](https://github.com/cline/kanban) | [CHANGELOG.md](https://github.com/cline/kanban/blob/main/CHANGELOG.md) | -| **Docs site** | Public documentation pages. | [`docs/`](https://docs.cline.bot/) | - | +| **SDK** | Node.js 程序化智能体 API 与扩展导出。 | [`sdk/`](https://github.com/cline/cline/tree/main/sdk) | [CHANGELOG.md](https://github.com/cline/cline/blob/main/sdk/CHANGELOG.md) | +| **CLI** | 终端 UI、无头模式、Shell 命令及 CLI 专属流程。 | [`apps/cli/`](https://github.com/cline/cline/tree/main/apps/cli) | [CHANGELOG.md](https://github.com/cline/cline/blob/main/apps/cli/CHANGELOG.md) | +| **VS Code Extension** | Marketplace 扩展及扩展宿主集成。 | [`/`](https://github.com/cline/cline/tree/main) (WIP migrating) | [CHANGELOG.md](https://github.com/cline/cline/blob/main/CHANGELOG.md) | +| **JetBrains Plugin** | 与共享智能体核心通信的 JetBrains 托管客户端。 | 目前我们尚未开源 JetBrains 插件 | - | +| **Kanban** | 基于 Web 的多智能体任务看板。 | [`cline/kanban`](https://github.com/cline/kanban) | [CHANGELOG.md](https://github.com/cline/kanban/blob/main/CHANGELOG.md) | +| **Docs site** | 公开文档页面。 | [`docs/`](https://docs.cline.bot/) | - | -## Edits Code Across Your Project +## 跨项目编辑代码 -Cline reads your project structure, understands the relationships between files, and makes coordinated changes across your codebase. It monitors linter and compiler errors as it works, fixing issues like missing imports, type mismatches, and syntax errors before you even see them. In VS Code and JetBrains, every edit shows up as a diff you can review, modify, or revert. All changes are tracked with checkpoints, so you can easily undo the agent's work. +Cline 会读取你的项目结构，理解文件之间的关系，并在整个代码库中进行协同修改。它在工作时监控 linter 和编译器错误，在你察觉之前就修复缺失导入、类型不匹配和语法错误等问题。在 VS Code 和 JetBrains 中，每次编辑都会以 diff 形式呈现，供你审阅、修改或撤销。所有更改都通过检查点（checkpoint）追踪，因此你可以轻松撤销智能体的工作。 -## Runs Bash Commands +## 运行 Bash 命令 -Cline executes commands directly in your terminal and watches the output in real time. Install packages, run build scripts, execute tests, deploy applications, manage databases. For long-running processes like dev servers, Cline continues working in the background and reacts to new output as it appears, catching compile errors, test failures, and server crashes as they happen. +Cline 会直接在你的终端中执行命令并实时监视输出。安装软件包、运行构建脚本、执行测试、部署应用、管理数据库。对于开发服务器等长时间运行的进程，Cline 会在后台继续工作，并在新输出出现时作出响应，及时捕获编译错误、测试失败和服务器崩溃。 -## Plan and Act +## 规划与执行 -Toggle between Plan mode and Act mode. In Plan mode, Cline explores your codebase, asks clarifying questions, and lays out a strategy. Once you're aligned, switch to Act mode and Cline executes the plan. Every file edit and terminal command requires your approval, so you stay in control of what actually changes. Or toggle auto-approve and let Cline run autonomously. +在 Plan 模式与 Act 模式之间切换。在 Plan 模式下，Cline 会探索你的代码库、提出澄清问题并制定策略。双方达成一致后，切换到 Act 模式，Cline 便会执行计划。每次文件编辑和终端命令都需要你的批准，因此你始终掌控实际发生的变化。也可以开启自动批准，让 Cline 自主运行。 -## Rules and Skills +## 规则与技能（Skills） -Define project-specific rules in `.clinerules` files that guide how Cline works in your codebase: coding standards, architecture conventions, deployment procedures, testing requirements. Rules are picked up automatically by the CLI, VS Code extension, and JetBrains plugin. Use skills to let the model load specific rules when needed. +在 `.clinerules` 文件中定义项目专属规则，指导 Cline 在你的代码库中如何工作：编码标准、架构约定、部署流程、测试要求等。CLI、VS Code 扩展和 JetBrains 插件会自动加载这些规则。使用 skills 让模型在需要时加载特定规则。 -## Works With Every Model +## 适配各类模型 -Cline is not locked to a single AI provider. Use whichever model fits your workflow: +Cline 不绑定单一 AI 提供商。可选用最适合你工作流的模型： -| Provider | Models | +| 提供商 | 模型 | |----------|--------| | Anthropic | Claude Opus, Sonnet, Haiku | -| OpenAI | GPT series models | -| Google | Gemini series models | -| OpenRouter | 200+ models from any provider | -| Vercel AI Gateway | Route to many providers through one gateway | -| AWS Bedrock | Claude, Llama, and more | -| Azure / GCP Vertex | All hosted models | -| Cerebras / Groq | Fast inference models | -| Ollama / LM Studio | Run local models on your machine | -| Any OpenAI-compatible API | Self-hosted or third-party endpoints | +| OpenAI | GPT 系列模型 | +| Google | Gemini 系列模型 | +| OpenRouter | 来自各提供商的 200+ 款模型 | +| Vercel AI Gateway | 通过单一网关路由至多个提供商 | +| AWS Bedrock | Claude、Llama 等 | +| Azure / GCP Vertex | 全部托管模型 | +| Cerebras / Groq | 高速推理模型 | +| Ollama / LM Studio | 在本地机器上运行本地模型 | +| Any OpenAI-compatible API | 自托管或第三方端点 | -## Extend With Plugins or MCP Servers +## 通过插件或 MCP 服务器扩展 -Extend Cline's capabilities with plugins. Using the SDK, register tools and lifecycle hooks programmatically through the plugin system for logging, auditing, policy enforcement, or adding domain-specific capabilities. Simple plugin example below. +通过插件扩展 Cline 的能力。借助 SDK，可通过插件系统以编程方式注册工具和生命周期钩子，用于日志记录、审计、策略强制执行或添加领域特定能力。示例如下。 ```typescript import { Agent, createTool } from "@cline/sdk" @@ -186,19 +186,19 @@ const deployTool = createTool({ const agent = new Agent({ tools: [deployTool], /* ... */ }) ``` -...or use [MCP servers](https://github.com/modelcontextprotocol) to connect to databases, query APIs, manage cloud infrastructure, and interact with external systems. Use [community-built servers](https://github.com/modelcontextprotocol/servers) or ask Cline to create custom tools on the fly. In the CLI, manage servers with `cline mcp`. +……或通过 [MCP 服务器](https://github.com/modelcontextprotocol) 连接数据库、查询 API、管理云基础设施并与外部系统交互。使用[社区构建的服务器](https://github.com/modelcontextprotocol/servers)，或让 Cline 即时创建自定义工具。在 CLI 中，使用 `cline mcp` 管理服务器。 -## Multi-Agent Teams +## 多智能体团队 -Coordinate multiple agents working together on complex tasks. A coordinator agent breaks the work into subtasks and delegates to specialist agents, each with their own tools and context. Team state persists across sessions so you can pick up where you left off. +协调多个智能体协同处理复杂任务。协调者智能体将工作拆分为子任务并委派给专家智能体，各自拥有独立的工具与上下文。团队状态在会话间持久保存，可随时从中断处继续。 ```bash cline --team-name auth-sprint "Plan and implement user authentication with tests" ``` -## Scheduled Agents +## 定时智能体 -Run agents on cron schedules for recurring automations. Daily PR summaries, weekly dependency checks, codebase health reports. Schedules persist across restarts and run independently of any terminal session. +按 cron 计划运行智能体，实现周期性自动化：每日 PR 摘要、每周依赖检查、代码库健康报告等。计划在重启后仍然保留，且不依赖任何终端会话独立运行。 ```bash cline schedule create "PR summary" \ @@ -207,9 +207,9 @@ cline schedule create "PR summary" \ --workspace /path/to/repo ``` -## Connect to Slack, Telegram, Discord, and More +## 连接 Slack、Telegram、Discord 等 -Chat with your agent from any messaging platform: Telegram, Slack, Discord, Google Chat, WhatsApp, and Linear. Each conversation thread maps to an agent session with full context. Set up access control to restrict who can interact with your agent. +从任意消息平台与你的智能体对话：Telegram、Slack、Discord、Google Chat、WhatsApp 和 Linear。每个对话线程对应一个具备完整上下文的智能体会话。可配置访问控制，限制谁可与你的智能体交互。 ```bash # Connect to Telegram @@ -220,9 +220,9 @@ cline connect slack --bot-token $SLACK_TOKEN --signing-secret $SECRET --base-url cline connect slack --bot-token $SLACK_TOKEN --app-token $SLACK_APP_TOKEN ``` -## Headless CLI for CI/CD +## 适用于 CI/CD 的无头 CLI -Run Cline with zero interaction for scripting and automation. Pipe input, get JSON output, chain commands, integrate into CI/CD pipelines. +以零交互方式运行 Cline，用于脚本编写与自动化。管道输入、获取 JSON 输出、串联命令，并集成到 CI/CD 流水线中。 ```bash cline "Run tests and fix any failures" @@ -230,10 +230,10 @@ 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' ``` -## Contributing +## 贡献 -Start with the [Contributing Guide](CONTRIBUTING.md). Join our [Discord](https://discord.gg/cline) and head to the `#contributors` channel to connect with other contributors. Check our [careers page](https://cline.bot/join-us) for full-time roles. +请先阅读[贡献指南](CONTRIBUTING.md)。加入我们的 [Discord](https://discord.gg/cline)，前往 `#contributors` 频道与其他贡献者交流。查看我们的[招聘页面](https://cline.bot/join-us)，了解全职岗位。 -## License +## 许可证 [Apache 2.0 © 2026 Cline Bot Inc.](./LICENSE)