Skip to content

91 核心文件索引

这份索引的目标不是罗列全部目录,而是给你一张“源码地图入口”:当你想沿着业务流追代码、或在脑中重新定位某个名词时,优先从这里挑一个锚点文件切入。

推荐用法:

  • 顺读主线:先走“入口层 → 主循环层 → 工具系统层”,再按需补“扩展系统层/远程与协同层”。
  • 反查名词:在本索引里找到该名词所在层的锚点文件,然后用 rg 追踪引用扩散。

章节对照:Part 1 的前三章分别对应入口分流、初始化边界、会话上下文与消息模型,可配合阅读:

入口层(EntryPoints)

  • restored-src/src/entrypoints/cli.tsx:CLI bootstrap + 模式分流(fast-path、bridge/daemon/bg sessions、常规交互入口)。
  • restored-src/src/entrypoints/init.ts:昂贵初始化边界(配置、环境变量注入、网络代理与 TLS、清理器、遥测等“主会话前置基础设施”)。
  • restored-src/src/main.tsx:完整 CLI 主模块(命令解析、交互会话启动、把入口接入主循环与 UI)。

主循环层(Query Loop)

  • restored-src/src/query.ts:一次请求的主循环(流式生成、识别 tool_use、执行工具并回填 tool_result、直到收束)。
  • restored-src/src/query/stopHooks.ts:停止与收尾钩子(决定何时 stop/continue,以及终止路径上的收口动作)。
  • restored-src/src/query/tokenBudget.ts:token 预算与恢复策略(把主循环变成“可治理的循环”,而不是无限推进)。
  • restored-src/src/utils/messages.ts:消息构造与规范化边界(本地消息形态与发往 API 的消息形态在这里收敛)。

工具系统层(Tools System)

  • restored-src/src/Tool.ts:工具协议与 ToolUseContext(贯穿主循环与工具执行的“上下文容器”,也是治理与扩展的挂载点)。
  • restored-src/src/services/tools/toolOrchestration.ts:工具编排策略(并发安全分批、上下文变更应用顺序、执行阶段如何产出增量消息)。
  • restored-src/src/services/tools/toolExecution.ts:单工具执行包装(把执行结果编码为可回填的 tool_result 消息,并覆盖取消/错误路径)。
  • restored-src/src/services/tools/StreamingToolExecutor.ts:流式工具执行器(在工具执行阶段保持“可流式消费”的事件节奏)。

扩展系统层(Skills / Plugins / MCP)

  • restored-src/src/skills/loadSkillsDir.ts:Skills 发现与加载(把“方法论/固定流程”变成可注入的可执行资产)。
  • restored-src/src/skills/bundledSkills.ts:内置 skills 注册(把官方/随包 skills 组织成可用集合,并与上下文衔接)。
  • restored-src/src/plugins/builtinPlugins.ts:内置插件集合(把插件作为扩展单元纳入系统生命周期)。
  • restored-src/src/services/mcp/client.ts:MCP 客户端与协议交互(外部工具/资源如何接入到同一套工具与上下文模型里)。

远程与协同层(Remote / Bridge / Tasks)

  • restored-src/src/bridge/bridgeMain.ts:bridge 运行形态入口(把本机作为可被远程调度的环境,并落地鉴权/策略)。
  • restored-src/src/bridge/remoteBridgeCore.ts:bridge 核心逻辑(连接生命周期、消息桥接、远程请求如何进入本地执行闭环)。
  • restored-src/src/remote/RemoteSessionManager.ts:远程会话管理(远程 session 的创建、维护与状态同步入口)。
  • restored-src/src/tasks/LocalMainSessionTask.ts:任务托管形态之一(把“会话/执行”包装成可调度任务,适配后台/协同场景)。
  • restored-src/src/coordinator/coordinatorMode.ts:协同模式入口(多代理/协作执行的模式组织与开关点)。