1. 项目定位与用途
Hermes Web UI 是 Hermes Agent 的官方全功能 Web 仪表板，作为其图形化管理界面，提供从 AI 对话到运维配置的一站式可视化操作。主要用途包括：管理多平台 AI 聊天会话、监控使用统计与成本、配置 8 个即时通讯渠道、安排定时任务、发现和管理模型、浏览技能与记忆、查看系统日志，以及通过集成终端直接访问后端 shell。所有功能均通过响应式 Web 界面实现，支持桌面和移动端访问。
项目档案应用项目
Hermes Web UI 官方文档 - 多平台 AI 聊天管理仪表板：安装、配置与使用指南
EKKOLearnAI/hermes-web-ui：Hermes Web UI 是 Hermes Agent 的全功能 Web 仪表板，提供多平台 AI 聊天管理、会话控制、使用分析、频道配置、定本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
Hermes Web UI 是 Hermes Agent 的全功能 Web 仪表板，提供多平台 AI 聊天管理、会话控制、使用分析、频道配置、定时任务等一站式可视化操作界面。
中文项目介绍
Hermes Web UI 是专为 Hermes Agent 设计的全功能 Web 管理面板，旨在为 AI 多平台机器人提供统一的可视化操作界面。
它解决了 Hermes Agent 缺乏图形化管理界面的问题，统一配置和监控多平台 AI 机器人、跟踪使用成本、管理会话与技能、执行定时任务，并通过 Web 终端提供直接 shell 访问。
适用场景包括：运维人员配置 Telegram、Discord 等平台机器人参数；团队监控 AI token 使用量和预估成本；用户创建和管理多会话 AI 对话；管理员安排定时任务并立即触发执行；开发人员通过集成终端调试代理服务。
技术特征：基于 Vue3 和 Koa2 构建前后端分离架构，支持 npm 全局安装，提供开发热重载和生产构建能力。配置持久化至用户目录（~/.hermes/.env 和 ~/.hermes/config.yaml），自动重启网关以应用变更。
详细信息与使用说明
2. 解决的问题
Hermes Agent 本身为命令行或 API 驱动，缺乏直观的图形界面，导致配置复杂、监控困难、操作不友好。Hermes Web UI 解决了以下问题：统一多平台（Telegram、Discord 等）凭证和行为配置，避免手动编辑文件；实时可视化 AI 对话和会话管理，降低使用门槛；提供 Token 使用量和成本跟踪，便于预算控制；集中管理 cron 任务和模型发现；集成 Web 终端便于调试；所有配置变更自动生效，无需手动重启服务。
3. 适用场景
本项目适用于：运维人员需要批量配置和监控多个平台机器人状态；团队协作中跟踪 AI 使用量和支出；用户通过 Web 界面进行多会话 AI 对话，支持文件上传和工具调用；管理员创建和管理定时任务，支持立即触发；开发人员通过内置终端调试 Hermes Agent 服务；以及任何需要统一管理多平台 AI 交互的场景。移动端适配允许在手机上快速查看统计和进行简单操作。
4. 安装方式
仓库中明确给出两种安装方式：一是推荐使用 npm 全局安装：执行 npm install -g hermes-web-ui，安装后通过命令 hermes-web-ui start 启动服务；二是使用一键安装脚本：bash <(curl -fsSL https://cdn.jsdelivr.net/gh/EKKOLearnAI/hermes-web-ui@main/scripts/setup.sh)，该脚本会自动检测操作系统并安装 Node.js（如缺失）及 hermes-web-ui。启动后默认监听 8648 端口，访问 http://localhost:8648 即可使用。
5. 使用方式
启动服务后，在浏览器打开 http://localhost:8648 进入主界面。主要使用方式包括：在 AI 聊天模块创建、切换会话，发送消息并查看 SSE 流式响应，支持文件上传和工具调用详情展开；在平台频道页面配置 8 个平台的凭证和行为，修改后自动生效；在用量分析页面查看 Token 统计、成本估算、模型分布和 30 天趋势图表；在定时任务页面管理 cron 作业，支持暂停、恢复和立即执行；在模型管理页面发现和添加模型；在日志页面筛选查看系统日志；通过 Web 终端进行命令行操作。
6. 补充说明与实现特点
项目采用前后端分离架构：前端为 Vue3 单页应用，使用 Naive UI 组件库和 Vite 构建；后端为 Koa2 BFF 服务器，代理请求到 Hermes Agent。开发模式下使用 concurrently 并行运行前端和后端，支持热重载。生产构建执行类型检查、客户端打包和服务端编译。配置持久化：平台凭证写入 ~/.hermes/.env，频道行为写入 ~/.hermes/config.yaml，修改后网关自动重启。API 设计遵循 OpenAPI 3.0 规范，文档位于 docs/openapi.json。项目提供全局 CLI 命令 hermes-web-ui，便于部署和启动。
思维导图
Hermes Web UI
客户端应用
Vue3 SPA
Naive UI
Vite 构建
服务端 BFF
Koa2 服务器
API 代理
WebSocket 终端
核心功能
AI 聊天
平台频道
使用分析
定时任务
模型管理
技能记忆
日志查看
Web 终端
常见问题
如何安装 Hermes Web UI？
支持两种方式：一是 npm 全局安装：npm install -g hermes-web-ui，然后执行 hermes-web-ui start；二是使用一键安装脚本：bash <(curl -fsSL https://cdn.jsdelivr.net/gh/EKKOLearnAI/hermes-web-ui@main/scripts/setup.sh)，该脚本会自动安装 Node.js（如缺失）及 hermes-web-ui。
Hermes Web UI 支持哪些平台？
支持 8 个平台：Telegram、Discord、Slack、WhatsApp、Matrix、Feishu (Lark)、WeChat、WeCom。在平台频道页面可统一配置各平台的凭证和行为设置，修改后自动生效。
如何查看 AI 使用统计？
在用量分析页面，可查看总 Token 使用量（输入/输出 分解）、会话计数、预估成本、模型分布图表以及 30 天每日趋势，帮助监控使用情况和支出。
开发模式下如何运行？
执行 npm run dev，将同时启动 Vite 前端开发服务器和 Nodemon 热重载的 Koa 后端服务，支持代码修改实时刷新，便于开发调试。
配置如何持久化？
平台凭证写入用户目录的 ~/.hermes/.env 文件，频道行为配置写入 ~/.hermes/config.yaml 文件。修改配置后，网关会自动重启以应用新设置，无需手动操作。