Harness
管理多个 CLI 进程、终端、工作区与恢复配方。
●面向二次开发者的源码架构学习站
看懂一个
Agent 控制平面
如何运转。
Munder Difflin 不是另一个 Agent Runtime。它把 Claude Code、Codex 等真实 CLI 进程装进一个本地优先的 Electron 协作系统：负责启动、隔离、协调、观察与收尾。
继续学习01 · 学习路线与用法0/27 已完成01runtime.ownerexternal_cli
02process.transportnode_pty
03coordinationhive_files
04privilege.ownerelectron_main
05visual.controlrenderer
一句话架构外部 CLI 拥有推理循环；Munder Difflin 拥有进程与协作生命周期。
SYSTEM POSITIONING
30 秒建立正确边界
先把四个相邻概念分开，后面的所有源码都会自然落位。
Orchestration
用 Hive task、mailbox、hook 与安全投递协调真实 Agent。
Control plane
集中处理权限、生命周期、安全保护与外围触发器。
Visualization
把终端和 hook 事实投影成 Office、Kanban 与状态面板。
交互图解
系统边界：管理 Agent，而非实现 Agent
人类 / Trigger输入目标、确认、干预
Munder DifflinHarness · Orchestration · Control plane · Visualization
外部 CLI RuntimeClaude Code · Codex · Gemini · …
模型 / Tool 服务推理、tool loop、provider session
PROVIDER SURFACE
被管理的外部 Runtime
支持不等于行为完全一致。provider preset 明确记录了参数、hook 与 resume 能力差异。
Claude CodeCodexGrokKimi CodeGemini CLIAntigravityQwenOpenCodeCrushPiCopilotCursorCustom
COURSE ARCHITECTURE
六个阶段，把复杂系统逐层讲透
每一阶段都有明确产出；先建立边界，再追进程、协调、状态与系统边缘，最后用实验验证。
LEARNING TRAIL
推荐阅读顺序
从边界到执行，再到协作与二次开发判断。每章都附固定 commit 的源码锚点。
01先建立四层心智模型把复杂桌面 Agent 系统拆成体验层、控制层、执行层与事实层。后续每一段源码都能被放回明确位置。02系统边界与总架构Munder Difflin 是本地优先的多 CLI Agent harness：Electron 主进程掌握权限、进程、文件与调度，外部 CLI Agent 掌握模型推理与工具循环。03Agent 创建全链路从 Add Agent 表单到外部 CLI 的完整入口链：参数校验、provider 推断、CLI 安装探测、Git 隔离、Hive 注入、恢复会话、权限姿态、PTY spawn。04Hive 协作模型Hive 不是一个内嵌 LLM planner，而是主进程中的本地协调协议：registry + agent directories + task files + poll router + hooks + safety controllers。05状态分层总览最重要的纠偏：当前 SQLite 只有 kv 与 command_history；Agent、队列、任务并没有统一进入 SQLite，而是分布在 Zustand/localStorage、roster.json、Hive 文件和外部 CLI 自己的存储中。06架构实验室三个可交互实验覆盖 Agent 创建、消息路由与状态权威。每次选择都会给出路径、失败面与源码入口。