新对话
⏎ 发送 · Shift+⏎ 换行 · @ 本次对话用指定智能体

档案

每个档案都是独立的 Hermes 工作区，可绑定模型 Profile、技能、编排阶段和提示词。

技能

可复用技能库 + 编排画布 · 接入 Hermes 真实 skill(75 个,26 类) + 前端 prompt 技能

加载中…
🎯
1
前置 · Prep
理解目标 / 拆解任务 / 澄清
↓
2
执行 · Execute
主任务 / 工具调用 / 生成内容
↓
3
收尾 · Review
自查 / 格式化输出 / 风险提示
详情预览
点左侧技能查看详情 · 点"+ 加入编排"放入画布

计划任务

通过定时运行 Agent 自动完成任务；直接对接 Hermes 后端 /api/jobs

加载中…

人格

通过 SOUL.md 定义 Agent 的人格、语气和长期指令。

SOUL.md · 人格文档
加载中…
说明
每次对话会加载这份长期指令。编辑能力暂未开放在前端，当前页面用于读取线上 Hermes 同步快照。

记忆

Hermes 在不同会话之间沉淀的偏好、事实和可检索上下文。

代理记忆
当前个人版已同步 SOUL.md 和会话快照；更细的外部记忆 Provider 仍由 Hermes 后端配置。
相关入口

提供商

配置 LLM Provider、运行模型、Base URL 和服务器端 API Key 引用。

运行 Provider
线上 Hermes agent 当前默认调用的模型和 Provider 配置
真实 Key 仍只放在服务器环境变量；这里不保存、不回显密钥。多 Agent 的专属 Key 引用在「模型」Profile 里维护。
打开提供商页后自动读取。

模型

管理模型库和 Agent 可绑定的模型 Profiles；Provider 和运行模型放在「提供商」。

模型 Profiles
给不同 Agent 绑定不同模型、Provider、Base URL 和服务器端 Key 引用
已配置 Profiles
用于给不同智能体绑定不同模型接入信息。
正在读取服务器共享配置...
新增模型 Profile
只填服务器环境变量名；前端不保存真实 Key。Agent 使用该 Profile 时会由桥接服务代理请求。
共享配置会保存到服务器，供同事端同步。

工具

Hermes 已注册工具包 · hermes tools list 输出 · 每分钟同步

加载中…
MCP 工具接入
外部工具、知识库和服务调用配置
留空会移除 mcp_servers；保存只改工具接入，不要求同时填写模型配置。
打开工具页后自动读取。

异步任务

POST /v1/runs 启动长任务,SSE 实时事件流展示 agent 调工具/思考/结果

任务指令
长任务 / 带工具调用 / 需要流式看中间步骤时用这个。短问题用对话 tab 即可。
事件流 未启动
点「运行」启动一个任务,事件会实时显示在这里

官方 Console

内嵌 Hermes 官方 Web UI(React + Vite 构建),7 个页面含完整架构文档 / 技能 / 记忆 / 工具 / 定时任务说明

新窗口打开

🏗 总体架构

爱马仕 UI 是 纯前端 SPA(无构建),通过 nginx 反代对接 Hermes Agent 后端。Hermes 后端部署在 Incus LXC 容器里,内嵌 Docker 容器跑 Python Gateway,暴露 OpenAI 兼容的 HTTP API。

浏览器
 └─ https://hermes.kang-kang.com/
 └─ 宿主 nginx (cookie 门禁 + Bearer 注入)
    ├─ /                 静态 UI (index.html + app.js + styles.css)
    ├─ /_auth/verify     htpasswd 登录(kang)
    ├─ /v1/*             → Hermes API (LXC incusbr0:8642)
    ├─ /api/jobs*        → 定时任务 CRUD
    ├─ /hermes-skills/   真实 78 个 SKILL.md(docker cp 快照)
    └─ /memory/          SOUL.md + sessions + tools.txt(systemd timer 每 1 分钟同步)

🔌 各 tab 对应的后端调用

Tab调用数据源
对话POST /v1/chat/completions (SSE 流式)实时 · 前端 localStorage 存会话
会话本地对话列表 + /memory/sessions.json + /memory/sessions/{id}.jsonlocalStorage + systemd timer sync
档案前端 CRUD + system prompt 组装localStorage (hermes-ui-agents-v1)
工作区GET /v1/models + localStorage 聚合实时 + 本地
模型GET/POST /feishu/ui-config服务器共享模型 Profiles
提供商GET/PUT /feishu/hermes-config 的 model 块Hermes 运行模型配置
技能GET /hermes-skills/ autoindex JSONdocker cp 快照 (78 个真实 SKILL.md)
人格GET /memory/SOUL.mdsystemd timer sync
记忆GET /memory/sessions.json 入口聚合systemd timer sync
工具GET /memory/tools.txt + GET/PUT /feishu/hermes-config 的 mcp_servers 块hermes tools list + MCP 配置
计划任务GET/POST/PATCH/DELETE /api/jobsHermes 后端实时
网关GET/POST/DELETE /feishu/apps外部消息入口
异步任务POST /v1/runs + EventSource /v1/runs/{id}/events实时 SSE

🔐 认证与安全

  • Cookie 门禁: hermes_auth=ok,HttpOnly + Secure + 24h 有效
  • 登录流程: 前端 login.html → fetch /_auth/verify Basic Auth → nginx 校验 htpasswd → 返回 Set-Cookie
  • Bearer 注入: nginx 在 proxy_pass 时自动加 Authorization: Bearer ...,浏览器永远看不到真 API key
  • 用户: kang(bcrypt 存在 /etc/nginx/.htpasswd-hermes-kang)

🧠 技能编排原理

不是真的在后端运行编排,而是前端组装复合 system prompt:

Agent.stages.pre    → 阶段一 · 前置(理解目标)
Agent.stages.exec   → 阶段二 · 执行(工具调用 / 生成)
Agent.stages.post   → 阶段三 · 收尾(自查 / 格式化)

每个 stage 把选中的 skill 文本拼起来
→ 作为 messages[0] system 发给 /v1/chat/completions
→ Gemini 3 Pro 按阶段指令输出

真实 Hermes skill(SKILL.md)会把前 1200 字节正文注入 prompt,内建 skill 是简短的 prompt 片段。

⚙ 部署 / 更新

# 本机改 src/ 后
cd ~/Projects/code/20260421-hermes-glass-ui-personal

# 同步个人 VPS
rsync -az src/ root@76.13.31.179:/var/www/hermes-kang/

# Git
git push  # Gitea kangwan/hermes-glass-ui-personal

# 如果改了 JS/CSS 要让浏览器刷新,更新 index.html 里的资源 query 版本

🛠 常见问题

  • 新改的东西没显示 → 刷新页面；旧浏览器如果曾安装 Service Worker，当前 sw.js 会自动清理并注销
  • VPS 后端换模型 → 改容器内 /opt/hermes-agent/config.yaml + .env,docker restart hermes-agent
  • 记忆 tab 看不到最新会话 → systemd timer 1 分钟一次,急的话 ssh root@76.13.31.179 /usr/local/bin/sync-hermes-memory.sh
  • Cron 任务不触发 → 看 Hermes 容器日志 docker logs hermes-agent

📦 技术栈

  • 前端:纯 HTML + CSS + JS,无构建,无任何 npm 依赖,约 120KB app.js + 75KB styles.css
  • 风格:Apple Liquid Glass(iOS/macOS 26 风格)+ Hermès 橙 #FF6900
  • 后端对接:OpenAI 兼容 HTTP + SSE,不走 WebSocket
  • 持久化:前端 localStorage(6 个 key),后端 Hermes session DB
  • PWA:manifest + service worker,可装 Dock App(macOS 本地版)

会话

查看本地对话和 Hermes 后端同步的会话快照，可导入继续聊。

本地会话
加载中…
云端会话 · 0
加载中…

工作区

集中查看运行状态、快捷入口、活动热力图和工作节奏。

个人版 · 主站
hermes.kang-kang.com
后端 · OpenAI 兼容
/api/v1/models
飞书 · 机器人列表
/feishu/apps
文档 · 解析
styles.kang-kang.com
今日 Token 消耗
0
0 条消息 · 0 个对话
0
本周消息
0 tokens
0
本月消息
0 tokens
0
总对话
0 条消息
API 状态
—
127.0.0.1:8642
当前模型
google/gemini-3.1-pro-preview
Provider 以提供商页为准
本机地址
—
Mac mini M4
代理
Clash ✓
127.0.0.1:7897
智能体
0
已创建
存储占用
—
localStorage
—
最常使用的智能体
还未使用智能体
创建一个智能体开始对话
活动热力图

最近使用节奏

按天聚合消息量，颜色越深代表当天对话越活跃。

0 个活跃日 峰值 0
少
多
日详情
点上面热力图中的任意一天查看详情

网关

统一管理飞书、微信、WhatsApp、Telegram、Discord 等外部消息入口。

已接入
飞书机器人
接收私聊、群聊、进群和消息事件，支持多个飞书 App。
待接入
微信
预留企业微信或个人微信网关入口。
待接入
WhatsApp
预留 WhatsApp Business Webhook。
待接入
Telegram
预留 Bot Token、Webhook 和群组授权。
待接入
Discord
预留 Discord Bot、频道事件和 Slash Commands。
飞书集成
当前已接入的飞书机器人和事件回调地址
只显示 App ID、回调地址和服务状态；Secret 与 Token 只保存在服务器环境文件。
打开网关页后自动读取飞书桥接服务。
保存前会校验 App ID / Secret；成功后复制回调地址到飞书事件配置。

设置

调整连接、偏好、数据和外观。

连接
爱马仕后端的 API 地址和密钥
Hermes API Server 的 OpenAI 兼容端点。本地默认 /api/v1(nginx 反代到 127.0.0.1:8642)
任意字符串,只要和 Hermes .env 里的 API_SERVER_KEY 一致
对话偏好
控制消息发送行为
打开后 AI 边生成边显示,更接近打字机效果
外观
主题、字体、动画
左下角"明亮/暗色"按钮切换
数据
导出、导入、清空本地数据
周报记录
保存任务描述、优化过程和最终周报
对话页点「存周报」会把最近一次任务描述和回答存到这里，之后可以打开、复制或删除。
还没有保存过周报记录。
关于
爱马仕 · AI
版本
v0.2 · Liquid Glass
运行于
Mac mini M4 · macOS 26.3
模型
以「模型」页配置为准
代理
Clash Verge · 127.0.0.1:7897