Glosario y referencias

源码版本v4.0.10

Esta página es el índice de terminología y la navegación al código fuente del sitio de análisis de la arquitectura de Cline. Cada entrada ofrece el término en español, la palabra original en inglés, una explicación de una línea y una referencia a la posición concreta en el código fuente, para facilitar la referencia cruzada desde otras páginas.

Términos clave

Término	Inglés	Descripción
Tarea	Task	Máquina de estados del agente para una ronda; retiene el historial de mensajes, el coordinador de herramientas y el gestor de checkpoints. apps/vscode/src/core/task/index.ts:188 export class Task
Llamada a herramienta	tool_use	Bloque de llamada a herramienta en el protocolo de mensajes de Anthropic; se parsea tool name + input del output del LLM y ToolExecutor lo despacha al handler correspondiente
Petición recursiva	recursivelyMakeClineRequests	Función del bucle principal de Task: envía API → parsea → alimenta herramientas → recursa a la siguiente ronda. apps/vscode/src/core/task/index.ts:2790
Presentación del mensaje del asistente	presentAssistantMessage	Va volcando al webview bloque a bloque los assistant blocks parseados, con un lock que evita refrescos concurrentes. apps/vscode/src/core/task/index.ts:2630
Petición API	attemptApiRequest	Async generator que empaqueta el contenido del usuario y lo envía al ApiHandler mientras hace yield de tokens en streaming. apps/vscode/src/core/task/index.ts:2175
Parseo de mensaje	parseAssistantMessageV2	Corta el flujo de texto del LLM en bloques text / tool_use / reasoning y reconoce los límites de diff SEARCH/REPLACE. apps/vscode/src/core/assistant-message/parse-assistant-message.ts:28
Diff de búsqueda/reemplazo	SEARCH/REPLACE	Formato de edición multianticulo que usa Cline: tres marcadores ------- SEARCH / ======= / +++++++ REPLACE. apps/vscode/src/core/assistant-message/diff.ts:1-3
Modo planificación/ejecución	plan / act mode	El modo plan solo planea sin escribir archivos; el modo act es el que realmente ejecuta herramientas. apps/vscode/src/shared/storage/types.ts:14 export type Mode = "plan" | "act"
Gestión de contexto	ContextManager	Monitoriza el uso de tokens de la conversación y dispara truncado/compresión/limpieza. apps/vscode/src/core/context/context-management/ContextManager.ts:44
Hub MCP	McpHub	Conecta con MCP servers externos y expone sus herramientas/recursos/prompts a Cline. apps/vscode/src/services/mcp/McpHub.ts:51
Subagente	SubagentRunner	Ejecuta subtareas en una subconversación aislada, con su propio historial de mensajes y conjunto de herramientas. apps/vscode/src/core/task/tools/subagent/SubagentRunner.ts:254
Handler de proveedor	ApiHandler	Interfaz de adaptación a un fabricante LLM; buildApiHandler despacha según la configuración a Anthropic, OpenAI, etc. apps/vscode/src/core/api/index.ts:517
Constructor de prompts	PromptBuilder	Ensambia el system prompt y las definiciones de herramientas según la variante del modelo. apps/vscode/src/core/prompts/system-prompt/registry/PromptBuilder.ts:12
Conjunto de herramientas	ClineToolSet	Conjunto de herramientas registradas por ModelFamily; a cada variante le corresponde un conjunto disponible. apps/vscode/src/core/prompts/system-prompt/registry/ClineToolSet.ts:8
Gestión de estado	StateManager	Persistencia y lectura de configuración global, settings y task history. apps/vscode/src/core/storage/StateManager.ts:58
Punto de control	Checkpoint	Unidad de replay de tarea; un commit del shadow git, adjuntado al mensaje checkpoint_created. apps/vscode/src/integrations/checkpoints/CheckpointTracker.ts:50

Convenciones de directorios

• Repositorio fuente: cline/cline, tag v4.0.10.
• Código principal: apps/vscode/src/ — cuerpo principal de la extensión de VS Code; sdk/ es el SDK transversal; evals/ es de evaluación; packages/ agrupa subpaquetes compartidos.
• Entrada de la extensión: apps/vscode/src/extension.ts.
• Núcleo de tarea: apps/vscode/src/core/task/index.ts — la clase Task, el bucle de recursion, attemptApiRequest y presentAssistantMessage viven aquí.
• Implementación de herramientas: apps/vscode/src/core/task/tools/ — el directorio handlers separa un archivo por herramienta; subagent/ es la implementación del subagente.
• Checkpoints: apps/vscode/src/integrations/checkpoints/ — toda la maquinaria de shadow git está aquí.
• Prompts: apps/vscode/src/core/prompts/system-prompt/ — plantillas de system prompt organizadas por variante.
• Datos de usuario: VS Code globalState / workspaceState + archivos locales bajo globalStorage (shadow git de checkpoints, task history, archivos de reglas, etc.).

Recursos oficiales

• Cline 文档
• Cline GitHub (tag v4.0.10)

La versión del código fuente referenciada en este sitio está fijada en v4.0.10; los números de línea se refieren a ese tag.