01
Bootstrap
组装 Electron app、全局 managers、生命周期与 IPC。
app.whenReadybootstrapHiveServicescreateWindowteardownAndQuit- UPSTREAM
- Electron app/config
- DOWNSTREAM
- 所有 Main service、Preload、Renderer
CHAPTER 25
按架构域导航源码，而不是按目录背文件
每个域给出入口、关键 symbols、上游依赖与下游消费者。所有链接固定到分析 commit。
02
Electron / IPC
把受限 renderer 请求映射到 Main 权限。
contextBridge.exposeInMainWorldapiipcMain.handle- UPSTREAM
- Renderer 用户操作
- DOWNSTREAM
- PTY、FS、Git、DB、Hive、integrations
03
Agent Runtime
解析命令、创建 PTY、维护 session 与回收进程树。
PtyManagerbuildPtyEnvensureKilledtokenizeWorkerCommand- UPSTREAM
- spawnAgentCore
- DOWNSTREAM
- 外部 CLI、PTY events
04
Orchestration / Hive
身份、mailbox、task、router、prompt injection 与 session 记录。
HiveManagerHookServerControlRegistryAgentProviderPreset- UPSTREAM
- Main lifecycle、CLI hook/bridge
- DOWNSTREAM
- Agent env/args、renderer state、Hive files
05
Task & Messaging
任务账本、Agent 邮箱、路由与空闲安全投递。
src/main/hive.ts↗src/shared/taskLedger.ts↗src/renderer/src/hooks/useHive.ts↗src/renderer/src/hooks/queueDelivery.ts↗
HiveTaskrouteMessagemergeTaskLedgerdeliverWithAcknowledgement- UPSTREAM
- UI、Agent outbox、Slack/Webhook
- DOWNSTREAM
- tasks.json、inbox、PTY queue
06
Safety & Lifecycle
循环/成本保护、唤醒、优雅收尾与进程清理。
CircuitBreakerClosingTimeControllerWorkerWakeWatchdogCostLedgerTotals- UPSTREAM
- hook、telemetry、任务与 PTY 活性
- DOWNSTREAM
- steer/constrain/stop、shutdown
07
State & DB
设置、窗口/prompt history、roster mirror 与 renderer state。
PersistStorereadConfigRosterStoreuseStore- UPSTREAM
- UI 与 Main services
- DOWNSTREAM
- SQLite、config.json、roster.json、localStorage
08
Git / Workspace
Git 浏览、受保护 checkout 与 Agent worktree 隔离。
src/main/git.ts↗src/main/github.ts↗src/renderer/src/components/GitTab.tsx↗src/renderer/src/ide/GitPanes.tsx↗
addWorktreeworktreeHasUnintegratedWorkcheckoutReflistIssues- UPSTREAM
- spawn 与 IDE
- DOWNSTREAM
- git/gh 子进程、Monaco diff
09
Renderer
Office、terminal、editor、store 与用户交互。
src/renderer/src/App.tsx↗src/renderer/src/scene/office/OfficeFloor.tsx↗src/renderer/src/components/terminalPool.ts↗src/renderer/src/hooks/usePtyParser.ts↗
AppOfficeFloorTerminalEntryusePtyParser- UPSTREAM
- Preload events 与用户输入
- DOWNSTREAM
- Pixi/xterm/Monaco、IPC 请求
10
Memory & Knowledge
Markdown memory、可选 semantic memory、Knowledge Graph 与图形展示。
src/main/memory.ts↗src/main/knowledge.ts↗src/main/kg-core.cjs↗src/renderer/src/components/MemoryGraphPanel.tsx↗
MemoryManagerKnowledgeManagerMemoryGraphPanel- UPSTREAM
- Hive agent directories、配置
- DOWNSTREAM
- mempalace、knowledge store、renderer graph
11
Realtime & Triggers
语音 orchestrator、Slack/Webhook 与 tunnel。
src/main/realtime.ts↗src/main/realtimeActions.ts↗src/main/slack.ts↗src/main/webhook.ts↗src/renderer/src/realtime/session.ts↗
RealtimeSessionrealtimeActionSlackServerWebhookServer- UPSTREAM
- OpenAI Realtime、外部 HTTP
- DOWNSTREAM
- Hive actions、tasks、prompt queue
12
Telemetry & Updates
本地 OTLP、匿名 analytics、transcript fallback 与 app update。
TelemetryCollectorAnalyticsreadAgentUsageinitAutoUpdater- UPSTREAM
- CLI OTel/transcript、app lifecycle
- DOWNSTREAM
- breaker、UI events、PostHog、GitHub releases
13
Tests
关键边界的 Node 单测与 Electron quit sweep 验证。
node --testquit-sweep.electron.test.cjs- UPSTREAM
- Shared/Main/Renderer 纯函数与 source loading
- DOWNSTREAM
- 回归保护
LESSON CHECKPOINT
能用自己的话回答核心问题了吗？
源码地图是调查索引，不是学习顺序。