# Hermes Neurovision

> 仓库地址：https://github.com/Tranquil-Flow/hermes-neurovision
> 作者/组织：Tranquil-Flow
> 成熟度：experimental
> 分析日期：2026-04-15

## 一句话总结
一个全屏 ASCII 艺术可视化器，将 Hermes Agent 的运行时事件（tool calls、memory writes、session 生命周期）实时渲染为动态终端图形。

## 项目定位与架构
Hermes Neurovision 是一个独特的可观测性工具——它不是传统的 dashboard 或日志查看器，而是将 agent 活动转化为沉浸式视觉体验。85 个动画主题涵盖 strange attractors、spectral effects、ASCII field renderers 和经典 node-based graphs。

架构上采用纯 Python 标准库实现（零外部依赖），使用 curses 库进行终端渲染。包含两个渲染引擎：ASCII Field Engine（v0.2.0 主力，每帧逐字符计算数学函数）和 Node-Based Engine（legacy，图结构+数据包动画）。Hybrid 主题可同时使用两者。

数据源方面，每秒轮询七个数据源：agent state DB、gateway hook、memory filesystem、cron logs、trajectory logs、Aegis security audit trails（可选）。

## 关键技术特性
- **85 个动画主题**：包含 Lorenz butterfly、Rössler ribbon 等真实 ODE 系统的 strange attractors
- **事件驱动视觉响应**：session start → 亮度激增；tool execution → 游走字符；task completion → 粒子爆炸；error → 边缘闪烁
- **多运行模式**：Live（实时响应）、Quiet（仅真实事件触发）、Gallery（主题浏览）、Daemon（空闲屏保）、Legacy
- **实时调参**：Tuner overlay 支持运行时调整 speed/density/sensitivity
- **零依赖**：纯 Python 标准库 + curses

## 设计亮点与创新
将 agent 运行时可观测性与生成式艺术结合，是极具创意的方案。事件到视觉的映射设计精巧——token usage 缩放 field density/speed，memory creation 生成新节点。174 个测试 100% 通过，对一个"实验性"项目来说质量不错。

## 局限性与风险
纯 curses 渲染限制了平台兼容性（仅 Unix-like）。无 GPU 加速，性能受限于 CPU。最小终端尺寸 80×24。事件检测依赖 Hermes Agent 的文件系统活动模式，耦合较紧。实用价值更多在于演示和氛围渲染，而非严肃监控。

## 与生态系统的关联
作为 Hermes Agent 的"视觉外壳"，与 hermes-webui（传统监控 dashboard）互补。可作为 hermes-autonomous-server 等无头部署的视觉诊断工具。内置 Hermes Agent skill 自动安装主题设计 API 指南。