尧图网页设计 
Munder Difflin 双数据平面架构node-pty 终端平面与 hooks/hive 事件平面如何汇聚于单一渲染器【免费下载链接】munder-difflinA local multi-agent harness that works with your existing Claude Code, Codex subscriptions, allows you to run an office of agents项目地址: https://gitcode.com/GitHub_Trending/mu/munder-difflinMunder Difflin 是一个运行在本地、复用你已有 Claude Code 订阅的多智能体编排工具harness。它同时运行多个真实 Claude 智能体并向你展示关于每个智能体的两样东西精确的终端输出以及它正在做什么的实时画面。这两类数据性质完全不同因此在该项目架构中被拆成两个独立数据平面——承载原始字节流的终端平面、承载结构化事件的 hooks/hive 事件平面——最终通过 Electron IPC 汇聚进一个 React Pixi.js 渲染器。读完本文你将理解这两个平面各自解决的问题、它们在源码中的落点src/main/pty.ts、src/main/hooks.ts以及为什么双平面单渲染器是这个多智能体 harness 能够同时做到可读与可看的承重决策。承重决策两个数据平面Munder Difflin 的大部分行为都源自一个架构决策。每个智能体都是一个真实的claude进程从它身上可以读出两条流字节流——shell 实际打印的每一个字节原样保留事件流——结构化的信号我即将使用某个工具、一条消息被路由、我停止了。原始架构图如下┌──────────────────── Electron Renderer (React Pixi) ───────────────────┐ │ Office floor (Pixi.js) Terminal view (xterm.js) │ │ ▲ avatar state ▲ pty bytes │ └────────┼──────────────────────────────────┼────────────────────────────┘ │ IPC │ IPC ┌─────┴───────────────┐ ┌──────┴──────────────┐ │ Event Plane │ │ Terminal Plane │ │ hooks hive router │ │ node-pty │ └─────▲───────────────┘ └──────▲──────────────┘ │ JSON events │ raw bytes ┌─────┴───────────────────────────────────┴──────────────┐ │ Claude Code processes (one per agent) │ └────────────────────────────────────────────────────────┘保持两条流分离是整套架构的关键。下面的两个小节分别讲解每个平面以及它们如何收敛。终端平面node-pty字节级保真终端平面追求的是fidelity保真。每个智能体都运行在一个由 node-pty 创建的真实伪终端pseudo-terminal中因此它的 shell 行为与普通终端逐字节一致——颜色、提示符、全屏 TUI 全部真实。主进程持有 PTY并把输出按每会话通道通过 IPC 转发给渲染器UI 上的按键输入也沿同一条路返回。渲染器侧为每个智能体池化pool一个 xterm.js 终端实例这就是海量实时终端渲染一文背后的技术。在源码中这一平面由 src/main/pty.ts 的PtyManager类实现其关键设计可以直接从代码读到会话与通道PtyManager.spawn()把每个 PTY 注册为一个PtySession含id、cwd、command、proc随后proc.onData()把原始字节通过pty:data:id通道推给渲染器proc.onExit()通过pty:exit:id上报退出信息。通道是按会话命名的而不是广播式。多窗口路由PtySession.owner记录了发起该 PTY 的窗口webContentssafeSend()会把输出只路由到拥有它的窗口——一个楼层的终端流永远不会泄漏进另一个楼层窗口。故障诊断每个会话维护一个有界的输出环tail上限TAIL_MAX 8192字节。当进程异常退出时例如提供方 CLI 启动即崩溃、缺少共享库主进程能据此告诉用户进程死亡时屏幕上最后显示的是什么而不是留下一段毫无解释的空白。命令解析与跨平台resolveCommand()会在交互式登录 shell 中执行whichmacOS/Linux或whereWindows来解析claude等裸命令覆盖 nvm/asdf/brew 等常见安装路径Windows 上还会把 npm 风格的.cmdshim 解码成真实解释器 脚本以argv数组方式直接 spawn绕开 cmd.exe 对换行与引号的破坏。终端平面给你的是未经过滤的事实每个智能体实际做了什么。但它很难可靠地回答当前正在运行哪个工具——那需要对输出做脆弱的文本猜测。这正是另一个平面的职责。事件平面hooks hive结构化信号事件平面追求的是structure结构化。它有两个来源都汇入主进程Claude Code hooks。每个智能体启动时都挂接了生命周期 hooks通过一个微型 shim 把每一个事件——PreToolUse、PostToolUse、Stop、Notification——转发到主进程监听的 Unix domain socket 上这套注入机制详见hook shim 模式与 Claude Code hooks 详解。这些是干净、类型化的信号即将运行 Bash、编辑完成、空闲等待中。无需解析任何输出。在源码中这是 src/main/hooks.ts 的HookServer类它createServer监听 hive 提供的 socket 路径按newline-delimited JSON 帧接收 shim 推送单帧上限MAX_HOOK_FRAME_BYTES 256 * 1024字节超限即拒收并记录日志每个事件驱动两类下游行为驱动头像状态PreToolUse/PostToolUse/Notification 等以及汇报生命周期边界让渲染器侧的守卫队列只在会话到达安全空闲提示后才投递 inbox 工作事件在跨 IPC 边界前会经过 src/shared/hookEvents.ts 的validateHookEvent()校验HookEvent契约agentId、event、tool、notificationType、message、blocked等最后通过hive:hookEvent通道推给渲染器。The hive协调层。包含每个智能体的邮箱mailbox、消息路由器、单提交者 gitsingle-committer git和共享内存。它在工作中自己也会发出事件一条消息从 A 路由到 B、一项任务升级给人类。GOD orchestrator 作为智能住在这里主进程则是搬运消息、提交状态的机制。两个来源都落在主进程主进程把结构化事件转发给渲染器驱动办公室地板工具事件让头像走向工位消息事件让信封飞越房间路由事件契约见 src/preload/index.ts 中的HiveRouteEvent其字段直接服务于信封交接动画。为什么两个平面都要人们很容易只选一个。但每一个单独都不够只有 hooks拿不到用户期望看到的原始输出流——你知道智能体跑了某条命令却不知道它打印了什么只有终端流无法可靠地说出当前在跑哪个工具——你看到字节却必须猜测含义。合在一起则互补办公室地板是事件驱动的精确、结构化、渲染廉价终端视图是逐字节真实的需要细节时给你完整细节。两个平面、两个问题各自都被回答得很好。单渲染器汇聚两个平面最终都终止于同一个 Electron 渲染器里面同时跑着 React 和 Pixi.jsReact拥有应用外壳、面板和 xterm.js 终端视图终端平面Pixi.js拥有办公室地板——头像、Tiled 地图、飞行的信封事件平面——它们处于同一个由单个 ticker 更新的、相机可控的世界中设计详见用 Pixi.js 可视化 AI 智能体。源码落点在 src/renderer/src/scene/office/OfficeFloor.tsx承载Application与TickerCharacter.ts/CharacterSprite.ts渲染头像MessageEnvelope.ts渲染信封TiledMapRenderer.ts绘制办公室地图Camera.ts提供相机控制。主进程与渲染器之间的桥是一条类型化的 preload API通过 Electron 的 contextBridge 暴露见 src/preload/index.ts渲染器调用它去 spawn/write/resize/kill PTYspawnPty、writePty、resizePty、killPty…并读取 hive 状态hiveRegistry、hiveTasks、hiveInbox…渲染器订阅它接收终端字节onPtyData、onPtyExit和事件onHiveHookEvent、onHiveMessage、onHiveContextUpdate…。关键在于渲染器从不直接触碰文件系统、git 或智能体进程本身它只和主进程对话。这就在机制主进程PTY、socket、git、路由与呈现渲染器React Pixi之间划出了一条硬边界。为什么这套架构站得住双平面设计会自然涌现出几个性质关注点分离保真与结构化是两个独立的问题被独立解决。你可以改进终端渲染而不动事件管线反之亦然。主进程是唯一权威PTY、hook socket、hive 的 git 仓库、记忆层都住在一个地方渲染器只是消费者。这正是单提交者 git 模式与安全 IPC 得以成立的前提。真实而非模拟因为事件平面承载的是真实的 hook 与路由事件可视化不可能偏离现实——它本身就是现实被渲染出来。从测试与验证角度这套契约也有对应守护例如 test/hook-event-contract.test.cjs 校验跨 IPC 的 hook 事件契约test/hooks-framing.test.cjs 校验 hook 帧的处理test/pty-env.test.cjs 校验 PTY 子进程环境test/hive-*.test.cjs系列覆盖 hive 路由、未知收件人、任务变更等事件平面的核心路径。FAQ双平面里记忆memory放在哪里与事件平面的 hive 层并列。共享语义记忆由主进程驱动一个指向每个智能体的 CLI回忆发生在智能体自身——它是协调机制的一部分而不是第三个 UI 平面。能不能加第三个平面可以但纪律是保持平面正交。新信号通常都放得进现有平面更多结构化事件进事件平面更多字节流进终端平面很少需要新开一个平面。如何上手体验这套架构安装 Munder Difflin 后打开一个办公室左侧是每个智能体的真实终端终端平面中间是 Pixi.js 的办公室地板事件平面——智能体执行工具时头像走向工位消息路由时信封飞过房间。你既可以去读terminals也可以去看floor这正是多智能体 harness 的核心价值。项目是免费开源的仓库根目录下的 README.md、ARCHITECTURE.md 与 SPEC.md 提供了进一步阅读入口。【免费下载链接】munder-difflinA local multi-agent harness that works with your existing Claude Code, Codex subscriptions, allows you to run an office of agents项目地址: https://gitcode.com/GitHub_Trending/mu/munder-difflin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Munder Difflin 双数据平面架构：node-pty 终端平面与 hooks/hive 事件平面如何汇聚于单一渲染器
Munder Difflin 双数据平面架构node-pty 终端平面与 hooks/hive 事件平面如何汇聚于单一渲染器【免费下载链接】munder-difflinA local multi-agent harness that works with your existing Claude Code, Codex subscriptions, allows you to run an office of agents项目地址: https://gitcode.com/GitHub_Trending/mu/munder-difflinMunder Difflin 是一个运行在本地、复用你已有 Claude Code 订阅的多智能体编排工具harness。它同时运行多个真实 Claude 智能体并向你展示关于每个智能体的两样东西精确的终端输出以及它正在做什么的实时画面。这两类数据性质完全不同因此在该项目架构中被拆成两个独立数据平面——承载原始字节流的终端平面、承载结构化事件的 hooks/hive 事件平面——最终通过 Electron IPC 汇聚进一个 React Pixi.js 渲染器。读完本文你将理解这两个平面各自解决的问题、它们在源码中的落点src/main/pty.ts、src/main/hooks.ts以及为什么双平面单渲染器是这个多智能体 harness 能够同时做到可读与可看的承重决策。承重决策两个数据平面Munder Difflin 的大部分行为都源自一个架构决策。每个智能体都是一个真实的claude进程从它身上可以读出两条流字节流——shell 实际打印的每一个字节原样保留事件流——结构化的信号我即将使用某个工具、一条消息被路由、我停止了。原始架构图如下┌──────────────────── Electron Renderer (React Pixi) ───────────────────┐ │ Office floor (Pixi.js) Terminal view (xterm.js) │ │ ▲ avatar state ▲ pty bytes │ └────────┼──────────────────────────────────┼────────────────────────────┘ │ IPC │ IPC ┌─────┴───────────────┐ ┌──────┴──────────────┐ │ Event Plane │ │ Terminal Plane │ │ hooks hive router │ │ node-pty │ └─────▲───────────────┘ └──────▲──────────────┘ │ JSON events │ raw bytes ┌─────┴───────────────────────────────────┴──────────────┐ │ Claude Code processes (one per agent) │ └────────────────────────────────────────────────────────┘保持两条流分离是整套架构的关键。下面的两个小节分别讲解每个平面以及它们如何收敛。终端平面node-pty字节级保真终端平面追求的是fidelity保真。每个智能体都运行在一个由 node-pty 创建的真实伪终端pseudo-terminal中因此它的 shell 行为与普通终端逐字节一致——颜色、提示符、全屏 TUI 全部真实。主进程持有 PTY并把输出按每会话通道通过 IPC 转发给渲染器UI 上的按键输入也沿同一条路返回。渲染器侧为每个智能体池化pool一个 xterm.js 终端实例这就是海量实时终端渲染一文背后的技术。在源码中这一平面由 src/main/pty.ts 的PtyManager类实现其关键设计可以直接从代码读到会话与通道PtyManager.spawn()把每个 PTY 注册为一个PtySession含id、cwd、command、proc随后proc.onData()把原始字节通过pty:data:id通道推给渲染器proc.onExit()通过pty:exit:id上报退出信息。通道是按会话命名的而不是广播式。多窗口路由PtySession.owner记录了发起该 PTY 的窗口webContentssafeSend()会把输出只路由到拥有它的窗口——一个楼层的终端流永远不会泄漏进另一个楼层窗口。故障诊断每个会话维护一个有界的输出环tail上限TAIL_MAX 8192字节。当进程异常退出时例如提供方 CLI 启动即崩溃、缺少共享库主进程能据此告诉用户进程死亡时屏幕上最后显示的是什么而不是留下一段毫无解释的空白。命令解析与跨平台resolveCommand()会在交互式登录 shell 中执行whichmacOS/Linux或whereWindows来解析claude等裸命令覆盖 nvm/asdf/brew 等常见安装路径Windows 上还会把 npm 风格的.cmdshim 解码成真实解释器 脚本以argv数组方式直接 spawn绕开 cmd.exe 对换行与引号的破坏。终端平面给你的是未经过滤的事实每个智能体实际做了什么。但它很难可靠地回答当前正在运行哪个工具——那需要对输出做脆弱的文本猜测。这正是另一个平面的职责。事件平面hooks hive结构化信号事件平面追求的是structure结构化。它有两个来源都汇入主进程Claude Code hooks。每个智能体启动时都挂接了生命周期 hooks通过一个微型 shim 把每一个事件——PreToolUse、PostToolUse、Stop、Notification——转发到主进程监听的 Unix domain socket 上这套注入机制详见hook shim 模式与 Claude Code hooks 详解。这些是干净、类型化的信号即将运行 Bash、编辑完成、空闲等待中。无需解析任何输出。在源码中这是 src/main/hooks.ts 的HookServer类它createServer监听 hive 提供的 socket 路径按newline-delimited JSON 帧接收 shim 推送单帧上限MAX_HOOK_FRAME_BYTES 256 * 1024字节超限即拒收并记录日志每个事件驱动两类下游行为驱动头像状态PreToolUse/PostToolUse/Notification 等以及汇报生命周期边界让渲染器侧的守卫队列只在会话到达安全空闲提示后才投递 inbox 工作事件在跨 IPC 边界前会经过 src/shared/hookEvents.ts 的validateHookEvent()校验HookEvent契约agentId、event、tool、notificationType、message、blocked等最后通过hive:hookEvent通道推给渲染器。The hive协调层。包含每个智能体的邮箱mailbox、消息路由器、单提交者 gitsingle-committer git和共享内存。它在工作中自己也会发出事件一条消息从 A 路由到 B、一项任务升级给人类。GOD orchestrator 作为智能住在这里主进程则是搬运消息、提交状态的机制。两个来源都落在主进程主进程把结构化事件转发给渲染器驱动办公室地板工具事件让头像走向工位消息事件让信封飞越房间路由事件契约见 src/preload/index.ts 中的HiveRouteEvent其字段直接服务于信封交接动画。为什么两个平面都要人们很容易只选一个。但每一个单独都不够只有 hooks拿不到用户期望看到的原始输出流——你知道智能体跑了某条命令却不知道它打印了什么只有终端流无法可靠地说出当前在跑哪个工具——你看到字节却必须猜测含义。合在一起则互补办公室地板是事件驱动的精确、结构化、渲染廉价终端视图是逐字节真实的需要细节时给你完整细节。两个平面、两个问题各自都被回答得很好。单渲染器汇聚两个平面最终都终止于同一个 Electron 渲染器里面同时跑着 React 和 Pixi.jsReact拥有应用外壳、面板和 xterm.js 终端视图终端平面Pixi.js拥有办公室地板——头像、Tiled 地图、飞行的信封事件平面——它们处于同一个由单个 ticker 更新的、相机可控的世界中设计详见用 Pixi.js 可视化 AI 智能体。源码落点在 src/renderer/src/scene/office/OfficeFloor.tsx承载Application与TickerCharacter.ts/CharacterSprite.ts渲染头像MessageEnvelope.ts渲染信封TiledMapRenderer.ts绘制办公室地图Camera.ts提供相机控制。主进程与渲染器之间的桥是一条类型化的 preload API通过 Electron 的 contextBridge 暴露见 src/preload/index.ts渲染器调用它去 spawn/write/resize/kill PTYspawnPty、writePty、resizePty、killPty…并读取 hive 状态hiveRegistry、hiveTasks、hiveInbox…渲染器订阅它接收终端字节onPtyData、onPtyExit和事件onHiveHookEvent、onHiveMessage、onHiveContextUpdate…。关键在于渲染器从不直接触碰文件系统、git 或智能体进程本身它只和主进程对话。这就在机制主进程PTY、socket、git、路由与呈现渲染器React Pixi之间划出了一条硬边界。为什么这套架构站得住双平面设计会自然涌现出几个性质关注点分离保真与结构化是两个独立的问题被独立解决。你可以改进终端渲染而不动事件管线反之亦然。主进程是唯一权威PTY、hook socket、hive 的 git 仓库、记忆层都住在一个地方渲染器只是消费者。这正是单提交者 git 模式与安全 IPC 得以成立的前提。真实而非模拟因为事件平面承载的是真实的 hook 与路由事件可视化不可能偏离现实——它本身就是现实被渲染出来。从测试与验证角度这套契约也有对应守护例如 test/hook-event-contract.test.cjs 校验跨 IPC 的 hook 事件契约test/hooks-framing.test.cjs 校验 hook 帧的处理test/pty-env.test.cjs 校验 PTY 子进程环境test/hive-*.test.cjs系列覆盖 hive 路由、未知收件人、任务变更等事件平面的核心路径。FAQ双平面里记忆memory放在哪里与事件平面的 hive 层并列。共享语义记忆由主进程驱动一个指向每个智能体的 CLI回忆发生在智能体自身——它是协调机制的一部分而不是第三个 UI 平面。能不能加第三个平面可以但纪律是保持平面正交。新信号通常都放得进现有平面更多结构化事件进事件平面更多字节流进终端平面很少需要新开一个平面。如何上手体验这套架构安装 Munder Difflin 后打开一个办公室左侧是每个智能体的真实终端终端平面中间是 Pixi.js 的办公室地板事件平面——智能体执行工具时头像走向工位消息路由时信封飞过房间。你既可以去读terminals也可以去看floor这正是多智能体 harness 的核心价值。项目是免费开源的仓库根目录下的 README.md、ARCHITECTURE.md 与 SPEC.md 提供了进一步阅读入口。【免费下载链接】munder-difflinA local multi-agent harness that works with your existing Claude Code, Codex subscriptions, allows you to run an office of agents项目地址: https://gitcode.com/GitHub_Trending/mu/munder-difflin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考