🏗 总体架构

爱马仕 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 对应的后端调用

🔐 认证与安全

• 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)

🧠 Skill Studio 编排原理

不是真的在后端运行编排,而是前端组装复合 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 要让浏览器刷新,记得 bump sw.js 的 CACHE 版本号

🛠 常见问题

• 新改的东西没显示 → Service Worker 缓存顽固,bump sw.js 里 CACHE 版本号,再 F12 → Application → Unregister
• 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 本地版)