詞彙表與資料
源码版本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" |
| context 管理 | 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 為準。