主题
附录：关键文件索引
Opencode 核心文件
| 文件路径 | 作用 |
|---|---|
opencode/packages/opencode/src/agent/agent.ts | Agent 定义 |
opencode/packages/opencode/src/session/processor.ts | LLM 交互核心循环 |
opencode/packages/opencode/src/tool/registry.ts | 工具注册表 |
opencode/packages/opencode/src/session/compaction.ts | 上下文压缩 |
opencode/packages/opencode/src/mcp/index.ts | MCP 客户端 |
opencode/packages/opencode/src/lsp/server.ts | LSP 服务器管理 |
opencode/packages/opencode/src/provider/provider.ts | LLM 提供商集成 |
opencode/packages/opencode/src/bus/index.ts | Effect PubSub 事件总线 |
opencode/packages/opencode/src/bus/bus-event.ts | 事件定义工厂 + 全局 Registry |
opencode/packages/opencode/src/bus/global.ts | GlobalBus 跨实例 EventEmitter |
opencode/packages/opencode/src/session/prompt.ts | 工具解析 + AI SDK 封装 + Hook 管线 |
opencode/packages/opencode/src/config/config.ts | 三层配置加载、合并、验证（1576 行） |
opencode/packages/opencode/src/provider/transform.ts | Provider 适配与消息规范化（1045 行） |
opencode/packages/opencode/src/cli/cmd/tui/app.tsx | TUI 根组件（SolidJS + Ink） |
opencode/packages/opencode/src/file/watcher.ts | 文件监视器（@parcel/watcher） |
opencode/packages/opencode/src/project/vcs.ts | VCS/Git 集成服务 |
opencode/packages/opencode/src/tool/ | 全部 19 个内置工具定义 |
OmO 核心文件
| 文件路径 | 作用 |
|---|---|
oh-my-openagent/src/index.ts | 插件入口（5 步初始化） |
oh-my-openagent/src/agents/ | 12 个 Agent 定义 |
oh-my-openagent/src/agents/dynamic-agent-prompt-builder.ts | 动态 Prompt 构建器 |
oh-my-openagent/src/features/background-agent/manager.ts | 后台任务管理器 |
oh-my-openagent/src/tools/delegate-task/ | 任务委派引擎 |
oh-my-openagent/src/hooks/atlas/ | Atlas 续航 Hook |
oh-my-openagent/src/hooks/ | 48 个生命周期 Hook |
oh-my-openagent/src/hooks/runtime-fallback/ | 运行时容错（错误检测、自动重试） |
oh-my-openagent/src/hooks/model-fallback/ | Provider 级别模型降级链 |
oh-my-openagent/src/hooks/ralph-loop/ | Ralph Loop（14 文件，~1687 LOC） |
oh-my-openagent/src/hooks/comment-checker/ | AI 注释污染防护 |
oh-my-openagent/src/hooks/think-mode/ | 动态思维深度调整 |
oh-my-openagent/src/hooks/hashline-read-enhancer/ | 行哈希精确编辑 |
oh-my-openagent/src/shared/permission-compat.ts | 权限系统（allow/deny/ask） |
oh-my-openagent/src/shared/agent-tool-restrictions.ts | 每 Agent 工具限制矩阵 |
oh-my-openagent/src/features/builtin-commands/templates/ | 斜杠命令模板（handoff, start-work, refactor） |
oh-my-openagent/src/tools/ | 全部 26 个扩展工具定义 |
oh-my-openagent/src/features/ | 19 个 Feature 模块 |
oh-my-openagent/src/cli/doctor/ | Doctor 环境诊断系统（23 个检查） |
Claude Code 核心文件
| 文件路径 | 作用 |
|---|---|
claude-code/src/entrypoints/cli.tsx | CLI 入口（15+ fast-path 判断） |
claude-code/src/query.ts | 主查询循环（1729 行） |
claude-code/src/QueryEngine.ts | 查询引擎封装 |
claude-code/src/Tool.ts | Tool 泛型接口定义（792 行） |
claude-code/src/tools.ts | 工具注册 + ToolSearch + 50+ 工具入口 |
claude-code/src/bootstrap/state.ts | 全局 STATE 对象（1758 行，90+ 字段） |
claude-code/src/state/AppStateStore.ts | UI 层 React Store（569 行） |
claude-code/src/state/store.ts | 极简 pub/sub 状态管理（34 行） |
claude-code/src/screens/REPL.tsx | REPL 主界面（5006 行 mega-component） |
claude-code/src/components/ | 144+ UI 组件 |
claude-code/src/coordinator/coordinatorMode.ts | Coordinator 多 Agent 模式（369 行） |
claude-code/src/tools/AgentTool/runAgent.ts | 子 Agent 执行器（973 行） |
claude-code/src/tasks/ | 统一 Task 接口（7 种任务类型） |
claude-code/src/services/compact/autoCompact.ts | 自动压缩触发（351 行） |
claude-code/src/services/compact/compact.ts | 核心压缩逻辑（1705 行） |
claude-code/src/services/compact/microCompact.ts | Microcompact 策略（530 行） |
claude-code/src/services/compact/sessionMemoryCompact.ts | 会话记忆压缩（630 行） |
claude-code/src/services/PromptSuggestion/speculation.ts | 推测执行（991 行） |
claude-code/src/utils/hooks.ts | Hooks 系统（5022 行，20+ 事件类型） |
claude-code/src/skills/loadSkillsDir.ts | Skills 加载器（1086 行） |
claude-code/src/memdir/memdir.ts | Memory 系统（507 行） |
claude-code/src/buddy/companion.ts | Companion 虚拟宠物（133 行） |
claude-code/src/types/permissions.ts | 权限类型定义（441 行，7 模式 × 8 来源） |
claude-code/src/utils/permissions/ | 权限执行逻辑 |
claude-code/src/services/api/claude.ts | Claude API 客户端 |
claude-code/src/constants/prompts.ts | 系统提示常量 |
claude-code/src/tools/BashTool/ | Bash 工具（18 文件，最复杂的单一工具） |
claude-code/src/tools/FileReadTool/ | 文件读取工具 |
claude-code/src/tools/FileEditTool/ | 文件编辑工具 |
claude-code/src/utils/config.ts | 配置系统 |
本文档基于 2026 年 4 月 1 日的代码仓库状态生成。随着三个项目的持续演进，部分实现细节可能发生变化。