Hermes Labyrinth 是 Hermes Agent 的只读可观测性仪表盘插件，由 ara.so 收录于 Daily 2026 Skills 集合。它的定位不是聊天 UI，而是面向在未知工作中运行的智能体的黑盒记录器，把自主智能体运行过程转化为可导航的“旅程地图”，并附带可导出的证据。
用途
该插件用于观察和审计 Hermes Agent 的自主运行。它把一次运行拆解为有序的 crossings（穿越点），涵盖提示、工具调用、工具结果、失败、模型切换、子智能体、审批、记忆命中、脱敏、上下文压缩、cron 运行等类型，让使用者能够沿着一次旅程逐步查看发生了什么。
主要能力
插件提供多个视图：旅程索引展示最近的 CLI、仪表盘、网关、cron 与委派工作；迷宫地图展示所选智能体旅程中有序的 crossings；检查器展示每个 crossing 的输入、输出、耗时、状态、证据与路标；路标是由本地证据支撑的生成式观察；技能图谱列出内置、可选、外部与用户技能清单；cron 门展示计划自主性、下次运行、最近失败与工作目录；模型渡口展示跨会话的模型/提供商切换；报告可导出单个旅程的脱敏 Markdown 与 JSON。
API 表面
所有端点均为只读，由 Hermes 仪表盘在 http://127.0.0.1:9119/api/plugins/hermes-labyrinth/ 提供。端点包括：GET /health、GET /journeys、GET /journeys/{journey_id}、GET /journeys/{journey_id}/crossings、GET /skills、GET /cron、GET /guideposts、GET /reports/{journey_id}.json、GET /reports/{journey_id}.md。可使用 curl 或任意语言调用，文档给出了 Python 与 JavaScript 示例，包括获取全部旅程、获取某旅程的 crossings、导出 Markdown/JSON 报告、健康检查、遍历 crossings 并检查工具调用、批量下载最近旅程报告、记录失败 crossings 等。
安装与使用方式
插件目录安装：先创建目录并克隆仓库：
mkdir -p ~/.hermes/plugins git clone https://github.com/stainlu/hermes-labyrinth.git ~/.hermes/plugins/hermes-labyrinth
然后启动或重启 Hermes 仪表盘：
hermes dashboard
若仪表盘已在运行，可不重启直接重新扫描插件：
curl http://127.0.0.1:9119/api/dashboard/plugins/rescan
在浏览器中打开仪表盘并选择 Labyrinth 标签页。可选主题安装：
mkdir -p ~/.hermes/dashboard-themes cp ~/.hermes/plugins/hermes-labyrinth/theme/hermes-labyrinth.yaml ~/.hermes/dashboard-themes/
构建与开发
前端由 src/parts/*.js 与 src/labyrinth.css 构建到 dashboard/dist/，演示 index.html 使用内容哈希查询字符串生成。可用命令包括：npm run build（构建 dashboard/dist 与 index.html）、npm run check（可复现性与解析检查）、npm run smoke（无头 Chrome 浏览器冒烟测试）、npm run smoke:live（对已部署 GitHub Pages 演示做冒烟测试）、npm test（运行全部测试）。完整测试套件覆盖可复现构建检查、前端 JavaScript 解析检查、后端 Python 解析检查、API 归一化夹具测试（含数值型 Hermes 时间戳）、打包产物与死控件回归、无头 Chrome 冒烟覆盖（地图模式、路由变化、搜索、数据集切换、阈值过滤）。
架构
数据流为：Hermes 本地状态（state.db 会话/消息、技能目录、cron 配置）→ dashboard/plugin_api.py → /api/plugins/hermes-labyrinth/* → src/parts/.js + src/labyrinth.css → npm run build → dashboard/dist/ → Hermes 仪表盘 Labyrinth 标签页。仓库布局包含 dashboard/（manifest.json、plugin_api.py、dist/）、docs/（CONCEPT.md、DESIGN_BRIEF.md、FUNCTIONAL_SPEC.md）、scripts/（build-plugin.mjs、smoke-demo.mjs、test-plugin-api.py、verify.mjs）、src/（demo/、parts/、labyrinth.css）、theme/、index.html、package.json。
数据政策
只读设计：不启动、停止、恢复、修改或创建 Hermes 会话。对预览与报告应用密钥脱敏。未知字段保持未知，不会被静默丢弃。报告仅从本地 Hermes 状态生成。公开演示使用示例/模拟数据，不是实时遥测。
常见模式与故障排查
文档给出检查插件健康、按类型过滤旅程、汇总旅程 crossing 类型等模式。故障排查包括：插件标签未出现时确认克隆位置、重启或 rescan、检查 manifest.json 是否为有效 JSON；API 返回 404 时验证插件已加载并确认仪表盘运行在 9119 端口；构建产物过期时运行 npm run build 与 npm run check；本地冒烟测试失败需 PATH 中有无头 Chrome/Chromium；报告含脱敏字段属预期行为；API 响应中的数值时间戳由归一化层自动处理，可能为 ISO 8601 字符串或 Unix 纪元整数。
适用场景与限制
适用于需要审计、复盘或调试 Hermes Agent 自主运行的场景，尤其是涉及工具调用、模型切换、cron 调度与子智能体委派的工作流。限制在于：插件为只读，不能控制或修改会话；报告与预览经过脱敏，原始值仅在 Hermes 进程内部可访问；公开演示使用模拟数据；具体收费、价格、平台支持范围等资料暂未提供。
链接
实时演示：https://stainlu.github.io/hermes-labyrinth/ Hermes Agent：https://github.com/NousResearch/hermes-agent Release v0.1.0：https://github.com/stainlu/hermes-labyrinth/releases/tag/v0.1.0 许可证：MIT