11

InBox/Hermes编排Agent_Web可观测性方案.md

@@ -0,0 +1,66 @@
+---
+title: Hermes 编排 Agent + Web 可观测性方案
+date: 2026-04-29
+tags: [Hermes, Agent编排, ttyd, tmux, 可观测性]
+---
+
+# Hermes 编排 Agent + Web 可观测性方案
+
+## 背景
+
+Hermes 作为母 Agent 编排不同的子 Agent（Codex、Claude Code 等），但全部在后台运行，无法直观看到每个 Agent 的实时输出和进度。需要将后台 tmux session 暴露到 Web 前端观察。
+
+## 方案：ttyd + tmux
+
+**ttyd**（GitHub 31k+ stars）可以把任意终端程序变成 Web 页面，通过 WebSocket 实时推流。
+
+### 架构
+
+```
+Hermes (编排大脑)
+    │
+    ├─ tmux session codex1  ─── ttyd :8080 ──► http://localhost:8080
+    ├─ tmux session claude1 ─── ttyd :8081 ──► http://localhost:8081
+    └─ tmux session codex2  ─── ttyd :8082 ──► http://localhost:8082
+```
+
+### 使用方式
+
+```bash
+# 启动 Agent 的 tmux session
+tmux new-session -d -s codex1 -x 140 -y 40
+tmux new-session -d -s claude1 -x 140 -y 40
+
+# ttyd 暴露每个 session 到 web
+ttyd -p 8080 tmux attach -t codex1 &
+ttyd -p 8081 tmux attach -t claude1 &
+
+# 浏览器打开
+open http://localhost:8080  # 看 Codex
+open http://localhost:8081  # 看 Claude Code
+```
+
+### 类似方案
+- **Wetty / Gotty** — 与 ttyd 类似
+- **LangFuse / AgentOps** — 专业 Agent trace 平台，但偏事后日志分析，非实时终端画面
+
+### 文件握手通信
+
+Agent 之间通过文件交换上下文：
+
+```
+/tmp/handoff.json       # Codex 输出 → Claude Code 读取
+/tmp/instruction.md     # Claude Code 重注入指令 → 拉起新 Codex
+/tmp/next_prompt.txt    # 下一步指令
+```
+
+## 关键结论
+
+1. **不要** 让 Agent 之间直接互相调用（失控）
+2. **要** 用 Hermes 作为中央编排大脑
+3. **用文件作为 Agent 间通信协议**
+4. **ttyd 解决实时观察问题**，浏览器多标签同时查看所有 Agent
+
+---
+
+*来源：Hermes Agent 对话 (2026-04-29)*