Web 控制台

Web 控制台是用于管理 Hermes Agent 安装的基于浏览器的 UI。你无需编辑 YAML 文件或运行 CLI 命令，即可从简洁的 Web 界面配置设置、管理 API 密钥并监控会话。

快速开始

hermes dashboard

这会启动一个本地 Web 服务器，并在浏览器中打开 http://127.0.0.1:9119。控制台完全在你的机器上运行——没有数据离开本地。

选项

标志	默认值	描述
`--port`	`9119`	Web 服务器运行端口
`--host`	`127.0.0.1`	绑定地址
`--no-open`	—	不自动打开浏览器
`--insecure`	关闭	允许绑定到非 localhost 主机（危险——在网络上暴露 API 密钥；配合防火墙和强认证使用）
`--tui`	关闭	暴露浏览器内聊天标签（通过 PTY/WebSocket 嵌入 `hermes --tui`）。或设置 `HERMES_DASHBOARD_TUI=1`。

# 自定义端口
hermes dashboard --port 8080

# 绑定到所有接口（在共享网络上谨慎使用）
hermes dashboard --host 0.0.0.0

# 启动但不打开浏览器
hermes dashboard --no-open

前提条件

默认的 hermes-agent 安装不包含 HTTP 栈或 PTY 辅助工具——这些是可选扩展。Web 控制台需要 FastAPI 和 Uvicorn（web 扩展）。聊天标签还需要 ptyprocess 在伪终端后面生成嵌入式 TUI（POSIX 上的 pty 扩展）。两者一起安装：

pip install 'hermes-agent[web,pty]'

web 扩展引入 FastAPI/Uvicorn；pty 引入 ptyprocess（POSIX）或 pywinpty（原生 Windows——注意嵌入式 TUI 本身仍需要 WSL）。pip install hermes-agent[all] 包含两个扩展，如果你还需要消息/语音等功能，这是最简便的方式。

当你在没有依赖的情况下运行 hermes dashboard 时，它会告诉你需要安装什么。如果前端尚未构建且 npm 可用，它会在首次启动时自动构建。

页面

状态

主页显示你的安装的实时概览：

Agent 版本和发布日期
网关状态 — 运行中/已停止、PID、已连接的平台及其状态
活跃会话 — 过去 5 分钟内活跃的会话数量
最近会话 — 最近 20 个会话的列表，包含模型、消息数、Token 用量和对话预览

状态页每 5 秒自动刷新一次。

聊天

聊天标签将完整的 Hermes TUI（与 hermes --tui 相同的界面）直接嵌入浏览器。所有你在终端 TUI 中能做的事情——斜杠命令、模型选择器、工具调用卡片、Markdown 流式传输、澄清/sudo/审批提示、皮肤主题——在这里的行为完全相同，因为控制台运行的是真实的 TUI 二进制文件，并通过 xterm.js 的 WebGL 渲染器渲染其 ANSI 输出，实现像素级精确的单元格布局。

工作原理：

/api/pty 打开一个用控制台会话 token 认证的 WebSocket
服务器在 POSIX 伪终端后面生成 hermes --tui
键盘输入传输到 PTY；ANSI 输出流回浏览器
xterm.js 的 WebGL 渲染器将每个单元格绘制到整数像素网格；鼠标跟踪（SGR 1006）、宽字符（Unicode 11）和框线字符均原生渲染
调整浏览器窗口大小会通过 @xterm/addon-fit 插件调整 TUI 大小

恢复现有会话： 从会话标签中，点击任意会话旁边的播放图标（▶）。这会跳转到 /chat?resume=<id> 并用 --resume 启动 TUI，加载完整历史。

前提条件：

Node.js（与 hermes --tui 相同的要求；TUI 包在首次启动时构建）
ptyprocess — 通过 pty 扩展安装（pip install 'hermes-agent[web,pty]'，或 [all] 包含两者）
POSIX 内核（Linux、macOS 或 WSL2）。/chat 终端面板特别需要 POSIX PTY——原生 Windows Python 没有等效实现，因此在原生 Windows 安装中，仪表板的其余部分（会话、任务、指标、配置编辑器）可以工作，但 /chat 标签会显示横幅，告诉你需要使用 WSL2 来获得该功能。

关闭浏览器标签后，服务器会干净地回收 PTY。重新打开会生成一个新会话。

配置

config.yaml 的表单式编辑器。所有 150+ 个配置字段均从 DEFAULT_CONFIG 自动发现，并组织到分类标签页中：

model — 默认模型、提供商、基础 URL、推理设置
terminal — 后端（本地/docker/ssh/modal）、超时、shell 偏好
display — 皮肤、工具进度、恢复显示、加载动画设置
agent — 最大迭代次数、网关超时、服务级别
delegation — 子 Agent 限制、推理努力程度
memory — 提供商选择、上下文注入设置
approvals — 危险命令审批模式（ask/yolo/deny）
以及更多——config.yaml 的每个部分都有对应的表单字段

具有已知有效值的字段（终端后端、皮肤、审批模式等）渲染为下拉菜单。布尔值渲染为开关。其他所有内容均为文本输入。

操作：

保存 — 立即将更改写入 config.yaml
重置为默认值 — 将所有字段恢复为默认值（点击保存前不会保存）
导出 — 将当前配置下载为 JSON
导入 — 上传 JSON 配置文件以替换当前值

提示

配置更改在下次 Agent 会话或网关重启时生效。Web 控制台编辑的是与 hermes config set 和网关读取的同一个 config.yaml 文件。

API 密钥

管理存储 API 密钥和凭证的 .env 文件。密钥按类别分组：

LLM 提供商 — OpenRouter、Anthropic、OpenAI、DeepSeek 等
工具 API 密钥 — Browserbase、Firecrawl、Tavily、ElevenLabs 等
消息平台 — Telegram、Discord、Slack 机器人 token 等
Agent 设置 — 非密钥环境变量，如 API_SERVER_ENABLED

每个密钥显示：

当前是否已设置（带有值的脱敏预览）
用途描述
提供商注册/获取密钥页面的链接
用于设置或更新值的输入字段
删除按钮

高级/很少使用的密钥默认隐藏在切换开关后面。

会话

浏览和检查所有 Agent 会话。每行显示会话标题、来源平台图标（CLI、Telegram、Discord、Slack、定时任务）、模型名称、消息数、工具调用数和最后活跃时间。实时会话带有闪烁徽章标记。

搜索 — 使用 FTS5 对所有消息内容进行全文搜索。结果显示高亮片段，展开时自动滚动到第一条匹配消息。
展开 — 点击会话加载完整消息历史。消息按角色（用户、助手、系统、工具）用颜色区分，并以带语法高亮的 Markdown 格式渲染。
工具调用 — 带工具调用的助手消息显示可折叠块，包含函数名和 JSON 参数。
删除 — 使用垃圾桶图标删除会话及其消息历史。

日志

查看带过滤和实时追踪的 Agent、网关和错误日志文件。

文件 — 在 agent、errors 和 gateway 日志文件之间切换
级别 — 按日志级别过滤：ALL、DEBUG、INFO、WARNING 或 ERROR
组件 — 按来源组件过滤：all、gateway、agent、tools、cli 或 cron
行数 — 选择显示多少行（50、100、200 或 500）
自动刷新 — 切换每 5 秒轮询新日志行的实时追踪
颜色编码 — 日志行按严重程度着色（错误为红色，警告为黄色，调试为暗色）

分析

从会话历史计算的使用和成本分析。选择时间段（7、30 或 90 天）查看：

摘要卡片 — 总 Token 数（输入/输出）、缓存命中率、总估算或实际成本，以及总会话数和日均值
每日 Token 图表 — 显示每天输入和输出 Token 用量的堆叠条形图，鼠标悬停显示详细信息和成本
每日明细表 — 每天的日期、会话数、输入 Token、输出 Token、缓存命中率和成本
按模型明细 — 显示每个使用模型的会话数、Token 用量和估算成本的表格

定时任务

创建和管理按固定周期运行 Agent 提示词的定时任务（Cron Jobs）。

创建 — 填写名称（可选）、提示词、Cron 表达式（例如 0 9 * * *）和投递目标（本地、Telegram、Discord、Slack 或邮件）
任务列表 — 每个任务显示其名称、提示词预览、计划表达式、状态徽章（启用/暂停/错误）、投递目标、上次运行时间和下次运行时间
暂停 / 恢复 — 在活跃和暂停状态之间切换任务
立即触发 — 在正常计划之外立即执行任务
删除 — 永久删除定时任务

技能

浏览、搜索和切换技能（Skills）和工具集。技能从 ~/.hermes/skills/ 加载，并按类别分组。

搜索 — 按名称、描述或类别过滤技能和工具集
类别过滤 — 点击类别标签缩小列表范围（例如 MLOps、MCP、Red Teaming、AI）
切换 — 用开关启用或禁用单个技能。更改在下次会话时生效。
工具集 — 单独的部分显示内置工具集（文件操作、Web 浏览等），包含其活跃/非活跃状态、设置要求和包含的工具列表

安全性

Web 控制台会读写你的 .env 文件，其中包含 API 密钥和密钥信息。默认绑定到 127.0.0.1——只能从本地机器访问。如果绑定到 0.0.0.0，网络上的任何人都可以查看和修改你的凭证。控制台本身没有身份验证。

`/reload` 斜杠命令

控制台 PR 还向交互式 CLI 添加了 /reload 斜杠命令。通过 Web 控制台（或直接编辑 .env）更改 API 密钥后，在活跃的 CLI 会话中使用 /reload 无需重启即可获取更改：

You → /reload
  Reloaded .env (3 var(s) updated)

这会将 ~/.hermes/.env 重新读取到运行中进程的环境中。当你通过控制台添加了新的提供商密钥并想立即使用时非常有用。

REST API

Web 控制台暴露了前端所消费的 REST API。你也可以直接调用这些端点进行自动化：

GET /api/status

返回 Agent 版本、网关状态、平台状态和活跃会话数。

GET /api/sessions

返回最近 20 个会话的元数据（模型、Token 数、时间戳、预览）。

GET /api/config

以 JSON 形式返回当前 config.yaml 内容。

GET /api/config/defaults

返回默认配置值。

GET /api/config/schema

返回描述每个配置字段的 schema——类型、描述、类别，以及适用时的可选值。前端使用此 schema 为每个字段渲染正确的输入控件。

PUT /api/config

保存新配置。请求体：{"config": {...}}。

GET /api/env

返回所有已知环境变量，包含设置/未设置状态、脱敏值、描述和类别。

PUT /api/env

设置环境变量。请求体：{"key": "VAR_NAME", "value": "secret"}。

DELETE /api/env

删除环境变量。请求体：{"key": "VAR_NAME"}。

GET /api/sessions/{session_id}

返回单个会话的元数据。

GET /api/sessions/{session_id}/messages

返回会话的完整消息历史，包含工具调用和时间戳。

GET /api/sessions/search

对消息内容进行全文搜索。查询参数：q。返回带高亮片段的匹配会话 ID。

DELETE /api/sessions/{session_id}

删除会话及其消息历史。

GET /api/logs

返回日志行。查询参数：file（agent/errors/gateway）、lines（数量）、level、component。

GET /api/analytics/usage

返回 Token 用量、成本和会话分析。查询参数：days（默认 30）。响应包含每日明细和按模型汇总。

GET /api/cron/jobs

返回所有配置的定时任务及其状态、计划和运行历史。

POST /api/cron/jobs

创建新定时任务。请求体：{"prompt": "...", "schedule": "0 9 * * *", "name": "...", "deliver": "local"}。

POST /api/cron/jobs/{job_id}/pause

暂停定时任务。

POST /api/cron/jobs/{job_id}/resume

恢复暂停的定时任务。

POST /api/cron/jobs/{job_id}/trigger

在计划之外立即触发定时任务。

DELETE /api/cron/jobs/{job_id}

删除定时任务。

GET /api/skills

返回所有技能，包含名称、描述、类别和启用状态。

PUT /api/skills/toggle

启用或禁用技能。请求体：{"name": "skill-name", "enabled": true}。

GET /api/tools/toolsets

返回所有工具集，包含标签、描述、工具列表和活跃/配置状态。

CORS

Web 服务器将 CORS 限制为仅 localhost 来源：

http://localhost:9119 / http://127.0.0.1:9119（生产环境）
http://localhost:3000 / http://127.0.0.1:3000
http://localhost:5173 / http://127.0.0.1:5173（Vite 开发服务器）

如果你在自定义端口上运行服务器，该来源会自动添加。

开发

如果你要为 Web 控制台前端做贡献：

# 终端 1：启动后端 API
hermes dashboard --no-open

# 终端 2：启动带 HMR 的 Vite 开发服务器
cd web/
npm install
npm run dev

位于 http://localhost:5173 的 Vite 开发服务器会将 /api 请求代理到位于 http://127.0.0.1:9119 的 FastAPI 后端。

前端使用 React 19、TypeScript、Tailwind CSS v4 和 shadcn/ui 风格组件构建。生产构建输出到 hermes_cli/web_dist/，FastAPI 服务器将其作为静态 SPA 提供。

更新时自动构建

当你运行 hermes update 时，如果 npm 可用，Web 前端会自动重新构建。这使控制台与代码更新保持同步。如果未安装 npm，更新会跳过前端构建，hermes dashboard 将在首次启动时构建它。

主题与插件

控制台内置六个主题，可通过用户自定义主题、插件标签页和后端 API 路由进行扩展——全部即插即用，无需克隆仓库。

实时切换主题，从顶部栏切换——点击语言切换器旁边的调色板图标。选择会持久保存到 config.yaml 的 dashboard.theme 中，并在页面加载时恢复。

内置主题：

主题	特色
Hermes Teal（`default`）	深青色 + 米色，系统字体，舒适间距
Hermes Teal（大字）（`default-large`）	与默认主题相同，但文字为 18px 且间距更宽
Midnight（`midnight`）	深蓝紫色，Inter + JetBrains Mono
Ember（`ember`）	暖深红色 + 青铜，Spectral 衬线 + IBM Plex Mono
Mono（`mono`）	灰度，IBM Plex，紧凑
Cyberpunk（`cyberpunk`）	黑底亮绿，Share Tech Mono
Rosé（`rose`）	粉色 + 象牙白，Fraunces 衬线，宽松

要构建自己的主题、添加插件标签页、注入到 shell 槽位或暴露插件特定的 REST 端点，请参阅**扩展控制台**——完整指南涵盖：

主题 YAML schema——调色板、排版、布局、资源、componentStyles、colorOverrides、customCSS
布局变体——standard、cockpit、tiled
插件清单、SDK、shell 槽位、页面作用域槽位（向内置页面注入小部件而无需覆盖它们）、后端 FastAPI 路由
完整的主题加插件组合演练（Strike Freedom cockpit 演示）
发现、重新加载和故障排除

快速开始​

选项​

前提条件​

页面​

状态​

聊天​

配置​

API 密钥​

会话​

日志​

分析​

定时任务​

技能​

/reload 斜杠命令​

REST API​

GET /api/status​

GET /api/sessions​

GET /api/config​

GET /api/config/defaults​

GET /api/config/schema​

PUT /api/config​

GET /api/env​

PUT /api/env​

DELETE /api/env​

GET /api/sessions/{session_id}​

GET /api/sessions/{session_id}/messages​

GET /api/sessions/search​

DELETE /api/sessions/{session_id}​

GET /api/logs​

GET /api/analytics/usage​

GET /api/cron/jobs​

POST /api/cron/jobs​

POST /api/cron/jobs/{job_id}/pause​

POST /api/cron/jobs/{job_id}/resume​

POST /api/cron/jobs/{job_id}/trigger​

DELETE /api/cron/jobs/{job_id}​

GET /api/skills​

PUT /api/skills/toggle​

GET /api/tools/toolsets​

CORS​

开发​

更新时自动构建​

主题与插件​