Cline — 自主 AI 编码助手¶

# === VS Code 安装 ===
# 1. 打开 VS Code
# 2. Extensions（Ctrl+Shift+X）
# 3. 搜索 "Cline"
# 4. 点击 Install

# 命令行安装
code --install-extension saoudrizwan.claude-dev  # 安装 Cline 插件

安装后：
1. 点击侧边栏的 Cline 图标
2. 选择 API Provider：
   - OpenRouter（推荐，汇集了所有主流模型）
   - Anthropic（直接用 Claude）
   - OpenAI
   - Google Gemini
   - AWS Bedrock
   - Ollama（本地模型）
3. 输入对应的 API Key
4. 选择模型（推荐 Claude Sonnet 4）

Cline 有两种工作模式：

Plan 模式（规划模式）：
- AI 先分析需求，列出执行计划
- 不会立即修改代码
- 适合复杂任务，先看看 AI 打算怎么做

Act 模式（执行模式）：
- AI 直接开始执行任务
- 每一步都要你确认
- 适合简单、明确的任务

建议：复杂任务先用 Plan，确认计划后切换到 Act 执行

# 示例1：让 Cline 创建一个 REST API
输入："用 FastAPI 创建一个用户管理 API，包含增删改查"

Cline 会依次：
1. 创建 main.py — 你确认 ✓
2. 创建 models.py — 你确认 ✓
3. 创建 requirements.txt — 你确认 ✓
4. 执行 pip install — 你确认 ✓
5. 运行测试 — 你确认 ✓

# 示例2：修复一个 Bug
输入："终端报错 TypeError: cannot unpack non-iterable NoneType，帮我修复"

Cline 会：
1. 读取报错信息
2. 找到出问题的文件
3. 分析原因
4. 提出修复方案
5. 等你确认后修改

Cline 可以操作浏览器来测试 Web 应用：

输入："启动开发服务器，打开浏览器测试登录页面"

Cline 会：
1. 启动 npm run dev
2. 打开无头浏览器
3. 导航到登录页面
4. 截图给你看
5. 如果发现问题，自动修复代码

Cline 支持生成子代理来并行研究：

输入："分析这个项目的安全漏洞"

Cline 可能会生成多个子代理：
- 子代理 1：检查依赖包漏洞
- 子代理 2：检查 SQL 注入风险
- 子代理 3：检查认证逻辑

子代理是只读的（不会修改代码），只负责调查和汇报
主代理根据子代理的报告做出修改决策

MCP 让 Cline 能连接外部工具：

常用 MCP 服务器：
- @modelcontextprotocol/server-filesystem — 文件系统操作
- @modelcontextprotocol/server-github — GitHub 操作
- @modelcontextprotocol/server-postgres — 数据库查询
- @playwright/mcp — 浏览器自动化

配置方法：
在 Cline 设置中 → MCP Servers → 添加服务器配置

# 在项目根目录创建 .clinerules 文件

## 项目规则
- 使用 Python 3.11+
- 所有函数加 type hints 和 docstring
- 测试用 pytest，覆盖率 > 80%
- 代码注释用中文
- 遵循 PEP 8 规范
- 优先使用标准库，不轻易引入第三方包

# 安装 Cline CLI（2026年2月发布）
npm install -g @cline/cli  # 全局安装 Cline CLI

# 使用
cline "给这个项目写单元测试"  # 在终端中使用 Cline

# 特性：
# - 支持并行 Agent
# - 可用于 CI/CD 管道
# - 无头模式（headless）