OLDBAI213/hermes-tui-reverse-study

# Hermes TUI Reverse Study [](LICENSE) [](https://github.com/NousResearch/hermes-agent) [English](#english) | 中文 ## 这是什么？ 对 Hermes Agent 全屏 TUI 界面的**完整逆向工程研究**。不修改 Hermes 本体代码，只记录拆解过程和发现。 覆盖范围： - 🚀 启动链路（`hermes --tui` 到屏幕渲染） - 📡 通信协议（JSON-RPC + Event） - 🎨 主题/皮肤系统（切换机制、字段映射） - 📺 显示内容（transcript、composer、status、overlay） - 📐 适配规则（终端宽度、亮暗环境） - 🎯 设计规格（v0.1 设计文档） ## 文档地图 ### 架构 - [启动与运行时](architecture/startup-and-runtime.md) — 从 `hermes --tui` 到屏幕的完整链路 - [数据流](architecture/data-flow.md) — JSON-RPC、事件、会话、流式输出 - [组件图](architecture/component-map.md) — 前端组件树和状态分工 ### 主题 - [主题与皮肤系统](themes/theme-and-skin-system.md) — 主题、皮肤、切换、字段映射 ### 显示 - [显示内容图](display/display-content-map.md) — TUI 显示什么内容 - [适配规则](display/adaptation-rules.md) — 终端宽度、状态栏、输入、滚动 - [扩展点](display/extension-points.md) — 自定义 TUI 视觉资产的接口点 ### 设计 - [设计原则](design/design-principles.md) — Hermes TUI 设计原则和决策依据 - [美感标准](design/beauty-benchmark.md) — TUI 美感标准和外部对比 - [设计规格 v0.1](design/hermes-tui-design-spec-v0.1.md) — 完整设计规格 - [Hermes Boy 角色设定](design/hermes-boy-character-sheet.md) — 原创角色设定和展示规则 - [布局决策框架](design/layout-decision-framework.md) — 终端尺寸驱动的布局框架 - [构建路线图](design/building-roadmap.md) — 从调查到静态主题、preview、动效、汉化 ### 工具 - [工具选型](tooling/tui-tooling-survey.md) — TUI/前端工具、框架选型矩阵 - [案例与模板](tooling/case-studies-and-templates.md) — AI CLI/TUI 案例拆解 - [推荐技术栈](tooling/recommended-stack.md) — 设计阶段推荐技术栈 ### 展示 - [展示图说明](showcase/README.md) — v0.1 展示图 - 宽屏 / 标准 / 紧凑 三种布局的展示图 ## 核心发现 1. **双界面架构**：旧的 Python classic CLI + 新的 `ui-tui + tui_gateway` 全屏 TUI 2. **前后端分离**：前端 Node/React Ink，后端 Python `tui_gateway` 3. **通信协议**：newline-delimited JSON-RPC 4. **主题可切换**：`/skin ` 命令 + 配置广播机制 5. **皮肤双来源**：内置皮肤 + 用户自定义 YAML ## 当前状态 - ✅ 架构逆向完成 - ✅ 主题系统分析完成 - ✅ 设计规格 v0.1 完成 - ✅ 展示图生成完成（宽屏/标准/紧凑） - ✅ 工具选型完成 - 🔄 等待实际实现 ## 许可证 MIT License

**由 [小白 🤖](https://github.com/OLDBAI213) 独立研究**

## English **Complete reverse engineering of Hermes Agent's full-screen TUI interface.** From startup chain to rendering architecture, from theme system to design specs — everything documented without modifying Hermes source code. ### What's Inside - 🚀 **Startup Chain** — From `hermes --tui` to screen rendering - 📡 **Protocol** — JSON-RPC + Event communication - 🎨 **Theme System** — Skin switching, field mapping - 📺 **Display Content** — Transcript, composer, status, overlays - 📐 **Adaptation** — Terminal width, light/dark environment - 🎯 **Design Specs** — v0.1 design document with character system ### Key Findings 1. **Dual Interface** — Legacy Python CLI + new Ink/React TUI 2. **Frontend/Backend Split** — Node/React Ink frontend, Python gateway backend 3. **Communication** — Newline-delimited JSON-RPC 4. **Switchable Themes** — `/skin ` command + config broadcast 5. **Dual Skin Sources** — Built-in skins + user YAML files ### Status - ✅ Architecture reverse engineering complete - ✅ Theme system analysis complete - ✅ Design specs v0.1 complete - ✅ Showcase images generated (wide/standard/compact) - ✅ Tooling survey complete - 🔄 Awaiting implementation

**Researched by [XiaoBai 🤖](https://github.com/OLDBAI213)**

标签：MITM代理, TUI, 主题系统, 云资产清单, 前端架构, 技术文档, 系统设计, 逆向工具, 逆向工程