CHAPTER 01

11 · LEARNING PATH7 分钟阅读入门

从产品边界到二次开发的八级路线

先理解谁拥有推理，再读 IPC 和 PTY；之后进入 lifecycle、Hive、状态存储与 visualization。

本课核心问题怎样读，才能从看热闹变成会判断？

学完你能

选择适合自己的阅读入口。
理解课程中的证据、练习与完成标准。

建议先学

无需前置课程

PHASE 0

建立地图

知道系统边界、阅读顺序与判断证据的方法。

01学习路线与用法7 分钟阅读 02先建立四层心智模型12 分钟阅读 03系统边界与总架构9 分钟阅读

PHASE 1

进程与权限

从一次点击追到外部 CLI 进程，并理解恢复与失败边界。

04Electron 权限分层10 分钟阅读 05启动链与服务装配14 分钟阅读 06Agent 创建全链路12 分钟阅读 07Provider 适配与恢复16 分钟阅读 08PTY 会话与进程树11 分钟阅读 09Prompt 输入与队列14 分钟阅读

PHASE 2

多 Agent 协调

读懂 Hive 协议、消息投递、任务状态与安全收尾。

10Hive 协作模型14 分钟阅读 11文件协议与身份17 分钟阅读 12消息路由与投递语义18 分钟阅读 13熔断、看门狗与收尾18 分钟阅读

PHASE 3

状态与工作区

判断每类事实的权威来源、持久化位置与恢复策略。

14状态分层总览12 分钟阅读 15权威源与恢复18 分钟阅读 16Git 工作区隔离18 分钟阅读 17Memory 与知识图谱15 分钟阅读

PHASE 4

界面与系统边缘

理解 UI 如何投影事实，以及网络、遥测和集成如何守住边界。

18Renderer 状态投影10 分钟阅读 19Git、网络与外部集成12 分钟阅读 20实时、遥测与隐私17 分钟阅读

PHASE 5

实战与验证

用实验、调用链和自测完成可迁移的架构理解。

21关键调用链播放器15 分钟阅读 22架构实验室16 分钟阅读 23二次开发作战手册20 分钟阅读 24理解度自测12 分钟阅读 25源码地图8 分钟阅读 26术语与概念关系18 分钟阅读 27架构结论与取舍9 分钟阅读

READER ROUTE 1

产品边界

先能解释 Munder Difflin 不做模型推理，而是管理外部 CLI runtime。

READER ROUTE 2

Electron 与 IPC

掌握 renderer 为什么无 Node 权限，以及 preload 如何形成窄能力面。

READER ROUTE 3

PTY Runtime

跟踪 command/args/env/cwd 到 node-pty，再理解输入输出与 process cleanup。

READER ROUTE 4

Agent Lifecycle

阅读 spawnAgentCore 的 provider、CLI install、worktree、Hive、resume 与 restart 逻辑。

READER ROUTE 5

Hive / Multi-Agent

区分 registry、task ledger、mailbox、hook、nudge 与 terminal handoff。

READER ROUTE 6

State / Storage

记住当前 SQLite 只有两表，其他权威分散在 roster、Hive files 与 CLI storage。

READER ROUTE 7

Renderer / Visualization

理解 xterm 与 Pixi 如何消费真实事件，而不是替代 runtime。

READER ROUTE 8

扩展与二次开发

从 provider preset、IPC capability、Hive protocol 或企业权威数据层选择一个明确边界扩展。

LESSON CHECKPOINT

能用自己的话回答核心问题了吗？

不要按文件名漫游；先回答问题，再追调用链。