跳到主要内容

Web 仪表盘

Web Dashboard 是一个用于管理 Hermes Agent 安装的浏览器界面。你无需手工编辑 YAML 或频繁使用 CLI，也能配置设置、管理 API keys，并监控会话。

快速开始​

hermes dashboard

这会启动本地 Web 服务，并在浏览器中打开 http://127.0.0.1:9119。Dashboard 完全运行在本机上，数据不会离开 localhost。

启动选项​

FlagDefaultDescription
--port9119Web 服务端口
--host127.0.0.1绑定地址
--no-open—不自动打开浏览器

前置依赖​

Web Dashboard 需要 FastAPI 和 Uvicorn：

pip install hermes-agent[web]

若前端尚未构建且系统中可用 npm，首次启动时会自动构建。

页面​

Status​

展示实时概览：

  • Hermes 版本
  • Gateway 状态
  • 活跃会话数
  • 最近会话列表

Config​

这是 config.yaml 的表单化编辑器。各配置项会按类别分组展示，例如：

  • model
  • terminal
  • display
  • agent
  • delegation
  • memory
  • approvals

支持保存、恢复默认、导出、导入。

API Keys​

用于管理 .env 中的各类 secrets，并按类别分组展示：

  • LLM Providers
  • Tool API Keys
  • Messaging Platforms
  • Agent Settings

Sessions​

用于浏览和搜索全部 agent 会话，支持展开查看完整消息历史、工具调用与删除会话。

Logs​

用于查看 agent、errors、gateway 日志，支持按级别、组件和行数过滤，并支持自动刷新。

Analytics​

用于查看 token、成本与会话使用分析，支持 7 / 30 / 90 天时间窗口。

Cron​

用于创建与管理定时任务：新建、暂停、恢复、立即触发、删除。

技能​

用于浏览、搜索和切换技能与工具集。

Security

Web Dashboard 默认绑定 127.0.0.1。如果你把它绑定到 0.0.0.0，同一网络中的其他人将可能访问并修改你的配置与凭据。Dashboard 自身没有额外认证层。

/reload Slash Command​

Dashboard 还引入了 /reload slash 命令。若你通过 dashboard 或手工修改了 .env，可在运行中的 CLI 会话里执行 /reload，无需重启 Hermes 即可重新加载环境变量。

REST API​

Dashboard 前端本身就是基于一组 REST API 构建的。你也可以直接调用它们，例如：

  • GET /api/status
  • GET /api/sessions
  • GET /api/config
  • PUT /api/config
  • GET /api/env
  • PUT /api/env
  • GET /api/logs
  • GET /api/analytics/usage
  • GET /api/cron/jobs
  • POST /api/cron/jobs
  • GET /api/skills
  • GET /api/tools/toolsets

CORS​

Web 服务默认仅允许 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

开发​

# Terminal 1
hermes dashboard --no-open

# Terminal 2
cd web/
npm install
npm run dev

主题​

Dashboard 主题由三层组成：

  • Palette：颜色
  • Typography：字体与字号
  • Layout：圆角与密度

内置主题包括 default、midnight、ember、mono、cyberpunk、rose。你也可以把自定义 YAML 主题放到 ~/.hermes/dashboard-themes/ 中，系统会自动发现并出现在主题选择器中。

Dashboard Plugins​

Plugins 位于 ~/.hermes/plugins/<name>/dashboard/ 或仓库中的 plugins/<name>/dashboard/。每个插件提供一个 manifest.json 和 JS bundle，并通过 SDK 集成到 dashboard 中。详细方式见 Dashboard Plugins。