词汇表与资料
源码版本v4.0.10
本页是 Cline 架构拆解站的术语索引与源码导航。每个条目给出中文术语、英文原词、一句话说明,并指向源码中的具体位置,方便其他页面交叉引用。
核心术语
| 术语 | 英文 | 说明 |
|---|---|---|
| 任务 | Task | 单回合 agent 状态机,持有消息历史、工具协调器、checkpoint 管理器。apps/vscode/src/core/task/index.ts:188 export class Task |
| 工具调用 | tool_use | Anthropic 消息协议里的工具调用 block,LLM 输出中解析出 tool name + input,由 ToolExecutor 分发到对应 handler |
| 递归请求 | recursivelyMakeClineRequests | Task 的主循环驱动函数:发 API → 解析 → 喂工具 → 递归下一轮。apps/vscode/src/core/task/index.ts:2790 |
| 展示助手消息 | presentAssistantMessage | 把解析出的 assistant block 一块块刷到 webview,带锁防止并发刷新。apps/vscode/src/core/task/index.ts:2630 |
| API 请求 | attemptApiRequest | 一个 async generator,把用户内容打包送给 ApiHandler 并 yield 流式 token。apps/vscode/src/core/task/index.ts:2175 |
| 消息解析 | parseAssistantMessageV2 | 把 LLM 文本流切成 text / tool_use / reasoning 块,识别 SEARCH/REPLACE diff 边界。apps/vscode/src/core/assistant-message/parse-assistant-message.ts:28 |
| 搜索/替换 diff | SEARCH/REPLACE | Cline 用的多文件编辑格式:------- SEARCH / ======= / +++++++ REPLACE 三段标记。apps/vscode/src/core/assistant-message/diff.ts:1-3 |
| 规划/执行模式 | plan / act mode | plan 模式只规划不写文件,act 模式才真正执行工具。apps/vscode/src/shared/storage/types.ts:14 export type Mode = "plan" | "act" |
| 上下文管理 | ContextManager | 监控对话 token 用量,触发截断/压缩/清场。apps/vscode/src/core/context/context-management/ContextManager.ts:44 |
| MCP 枢纽 | McpHub | 连接外部 MCP server,把它们的工具/资源/prompt 暴露给 Cline。apps/vscode/src/services/mcp/McpHub.ts:51 |
| 子 Agent | SubagentRunner | 隔离子会话执行子任务,有自己的消息历史和工具集。apps/vscode/src/core/task/tools/subagent/SubagentRunner.ts:254 |
| Provider 处理器 | ApiHandler | LLM 厂商适配接口,buildApiHandler 按配置分流到 Anthropic/OpenAI 等。apps/vscode/src/core/api/index.ts:517 |
| 提示构建器 | PromptBuilder | 按模型 variant 拼装系统提示与工具定义。apps/vscode/src/core/prompts/system-prompt/registry/PromptBuilder.ts:12 |
| 工具集 | ClineToolSet | 按 ModelFamily 注册的工具集合,一个 variant 对应一组可用工具。apps/vscode/src/core/prompts/system-prompt/registry/ClineToolSet.ts:8 |
| 状态管理 | StateManager | 全局配置、settings、task history 的持久化与读取。apps/vscode/src/core/storage/StateManager.ts:58 |
| 检查点 | Checkpoint | 任务回放单元,影子 git 的一个 commit,贴在 checkpoint_created 消息上。apps/vscode/src/integrations/checkpoints/CheckpointTracker.ts:50 |
目录约定
- 源码仓库:
cline/cline,tagv4.0.10。 - 主代码位置:
apps/vscode/src/——VS Code 扩展主体;sdk/是跨平台 SDK;evals/是评测;packages/是共享子包。 - 扩展入口:
apps/vscode/src/extension.ts。 - 任务核心:
apps/vscode/src/core/task/index.ts——Task 类、recursion 循环、attemptApiRequest、presentAssistantMessage 都在这里。 - 工具实现:
apps/vscode/src/core/task/tools/——handlers 目录按工具拆文件,subagent/ 是子 agent 实现。 - 检查点:
apps/vscode/src/integrations/checkpoints/——影子 git 全套在这里。 - 提示词:
apps/vscode/src/core/prompts/system-prompt/——按 variant 组织的系统提示模板。 - 用户数据:VS Code globalState / workspaceState + globalStorage 下的本地文件(checkpoint 影子 git、task history、规则文件等)。
官方资料
- Cline 文档
- Cline GitHub (tag v4.0.10)
本站源码版本钉定 v4.0.10,行号以该 tag 为准。