词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"Web Dashboard"
Web Dashboard
快速开始
http://127.0.0.1:9119。Dashboard 完全在你的机器上运行——数据不会离开 localhost。选项
| 标志 | 默认值 | 描述 |
|---|---|---|
--port | 9119 | Web 服务器运行端口 |
--host | 127.0.0.1 | 绑定地址 |
--no-open | — | 不自动打开浏览器 |
--insecure | 关闭 | 允许绑定到非 localhost 主机（危险——会在网络上暴露 API 密钥；请配合防火墙和强认证使用） |
--tui | 关闭 | 启用浏览器内 Chat 标签页（通过 PTY/WebSocket 嵌入 hermes --tui）。也可设置 HERMES_DASHBOARD_TUI=1。 |
前置条件
hermes-agent 安装不包含 HTTP 栈或 PTY 辅助工具——这些是可选扩展。Web Dashboard 需要 FastAPI 和 Uvicorn（web 扩展）。Chat 标签页还需要 ptyprocess 来在伪终端（pseudo-terminal）后面启动嵌入式 TUI（POSIX 上的 pty 扩展）。使用以下命令同时安装：web 扩展会引入 FastAPI/Uvicorn；pty 扩展会引入 ptyprocess（POSIX）或 pywinpty（原生 Windows——注意嵌入式 TUI 本身仍需要 WSL）。pip install hermes-agent[all] 包含两个扩展，如果你还需要消息/语音等功能，这是最简便的方式。hermes dashboard 时，它会告诉你需要安装什么。如果前端尚未构建且 npm 可用，则会在首次启动时自动构建。hermes dashboard 启动时默认关闭。如需嵌入式浏览器聊天面板，请使用 hermes dashboard --tui 启动，或设置 HERMES_DASHBOARD_TUI=1。页面
Status（状态）
Chat（聊天）
hermes --tui 相同的界面）直接嵌入浏览器。你在终端 TUI 中能做的一切——斜杠命令、模型选择器、工具调用卡片、Markdown 流式输出、clarify/sudo/approval 提示、皮肤主题——在这里都完全一致，因为 Dashboard 运行的是真实的 TUI 二进制文件，并通过 xterm.js 的 WebGL 渲染器以像素级精度渲染其 ANSI 输出。/api/pty 打开一个经 Dashboard 会话 token 认证的 WebSockethermes --tui@xterm/addon-fit 插件调整 TUI 大小/chat?resume=<id> 并以 --resume 参数启动 TUI，加载完整历史记录。hermes --tui 相同的要求；TUI 包在首次启动时构建）ptyprocess——由 pty 扩展安装（pip install 'hermes-agent[web,pty]'，或 [all] 同时包含两者）/chat 终端面板特别需要 POSIX PTY——原生 Windows Python 没有等效实现，因此在原生 Windows 安装上，Dashboard 的其余部分（sessions、jobs、metrics、config editor）可以正常工作，但 /chat 标签页会显示提示，告知你需要使用 WSL2 才能使用该功能。Config（配置）
config.yaml 的表单式编辑器。所有 150+ 个配置字段均从 DEFAULT_CONFIG 自动发现，并按标签页分类组织：config.yaml提示
hermes config set 和 gateway 读取的同一个 config.yaml 文件。API Keys（API 密钥）
.env 文件。密钥按类别分组：API_SERVER_ENABLEDSessions（会话）
Logs（日志）
agent、errors 和 gateway 日志文件之间切换Analytics（分析）
Cron（定时任务）
0 9 * * *）和投递目标（local、Telegram、Discord、Slack 或 email）Skills（技能）
~/.hermes/skills/ 加载，并按类别分组。安全提示
.env 文件。它默认绑定到 127.0.0.1——只能从本机访问。如果绑定到 0.0.0.0，网络上的任何人都可以查看和修改你的凭据。Dashboard 本身没有任何认证机制。/reload 斜杠命令
/reload 斜杠命令。通过 Web Dashboard（或直接编辑 .env）更改 API 密钥后，在活跃的 CLI 会话中使用 /reload 即可获取更改，无需重启：You → /reload
Reloaded .env (3 var(s) updated)~/.hermes/.env 重新读取到运行中进程的环境中。当你通过 Dashboard 添加了新的提供商密钥并希望立即使用时非常有用。REST API
GET /api/status
GET /api/sessions
GET /api/config
config.yaml 内容。GET /api/config/defaults
GET /api/config/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
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
http://localhost:9119 / http://127.0.0.1:9119（生产环境）http://localhost:3000 / http://127.0.0.1:3000http://localhost:5173 / http://127.0.0.1:5173（Vite 开发服务器）开发
http://localhost:5173 上的 Vite 开发服务器会将 /api 请求代理到 http://127.0.0.1:9119 上的 FastAPI 后端。hermes_cli/web_dist/，由 FastAPI 服务器作为静态 SPA 提供服务。更新时自动构建
hermes update 时，如果 npm 可用，Web 前端会自动重新构建。这使 Dashboard 与代码更新保持同步。如果未安装 npm，更新会跳过前端构建，hermes dashboard 将在首次启动时构建。主题与插件
config.yaml 的 dashboard.theme 下，并在页面加载时恢复。| 主题 | 特点 |
|---|---|
Hermes Teal (default) | 深青色 + 奶油色，系统字体，舒适间距 |
Hermes Teal (Large) (default-large) | 与 default 相同，但使用 18px 文字和更宽松的间距 |
Midnight (midnight) | 深蓝紫色，Inter + JetBrains Mono |
Ember (ember) | 暖深红 + 古铜色，Spectral 衬线体 + IBM Plex Mono |
Mono (mono) | 灰度，IBM Plex，紧凑 |
Cyberpunk (cyberpunk) | 黑底霓虹绿，Share Tech Mono |
Rosé (rose) | 粉色 + 象牙色，Fraunces 衬线体，宽松 |
standard、cockpit、tiled