企业官网建设流程全解析

5个场景讲透：Hermes WebUI 会话管理实操笔记

【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webui

打开侧边栏，50个会话混在一起：这周改的 bug、上个月调 API key、上周三聊的部署方案。要快速找到某一条、还要让列表保持干净，靠记是记不住的。Hermes WebUI 是跑在浏览器里的 Hermes Agent 自托管界面，下面几个场景，都是 Hermes WebUI 会话管理里绕不开的真实问题。

🧭 它和你想的不一样

它不是一个独立的聊天工具。Hermes WebUI 直接复用你服务器上已有的 Hermes Agent 和模型配置，不需要再建一套账号。CLI 里发过的消息，也会直接出现在侧边栏里。

会话不是开在浏览器里的。它们保存在服务端，页面刷新、SSH 隧道断开重连，回到页面时对话都还在，浏览器标签页标题也会跟着当前会话走。

布局是固定三栏的：左侧会话列表，中间对话区，右侧 workspace 文件面板。模型、profile、workspace 的选择器固定在底部输入区，打字时随时能切。

🚶 第一次打开：最短路径

1. 拉代码跑一遍：git clone https://gitcode.com/GitHub_Trending/he/hermes-webui，然后python3 bootstrap.py，它会探测 Agent、起服务并打开浏览器。
2. 走完首次引导向导：系统检查、配 provider、选 workspace 和模型、可选设密码，五步结束。

3. 回到主界面，点侧边栏的 New conversation 发第一条消息，新会话随即出现在 Today 分组下。

💪 把常用操作变成肌肉记忆

在 Hermes WebUI 会话管理里，下面这几个动作频率最高。

改标题。自动总结出来的标题分不清是谁。鼠标移到会话上，点⋯里的 Rename conversation，改成"重构订单接口"。下次搜索直接命中。

置顶。重要会话被新会话顶下去。⋯菜单选 Pin conversation，它会收进侧边栏顶部的 PINNED 区，不再往下沉。

搜索。要找上周那条"修 502"的对话。在侧边栏顶部的 Filter conversations 框里输关键词，标题和消息内容都参与匹配。列表立刻只剩相关会话。

换设备接着聊。电脑上聊到一半，想在手机上瞄一眼进度。手机连同一个地址（SSH 隧道或 Tailscale 的做法见 docs/remote-access.md），点进对应会话，上下文原样接着。

🗂️ 当会话变多之后

侧边栏堆到一百条以上。用⋯菜单里的 Move to project，按主题建命名分组，项目可以设颜色。之后在筛选行点项目名，只看这一组。

有会话不想删也不想看。用 Archive conversation，它把会话从列表里藏起来但数据仍留在磁盘。想回顾时打开侧边栏的归档开关即可，这是最稳妥的 Hermes 会话归档方法。

想让类型一眼可辨。在标题里加#标签，比如#coding、#研究，会生成彩色 chip，点 chip 就能过滤出这一类。Hermes 会话标签不占额外空间，是最轻量的组织手段。

攒了一批想一次清掉。选中多个会话后可以做批量归档或删除，操作前会弹确认框，写明会处理几条。

🔒 数据不会丢，前提是你做了这件事

数据这一层，是 Hermes WebUI 会话管理的底线。

会话存在服务端：每个会话是一个独立 JSON 文件，元数据由state.db维护，默认都在~/.hermes/webui目录下。所以刷新页面、隧道重连都不会丢东西。

导出走控制中心：Conversation 标签页里能下载 Markdown 转录、完整 JSON，也能从 JSON 导回来。这就是 Hermes WebUI 会话导出的完整路径，备份和迁移都靠它。

⚠️ 状态目录在宿主机上。重装系统或换机器前，先把~/.hermes/webui整个目录备份走，会话、设置、项目分组都在里面。

⚠️ 远程访问记得开密码（HERMES_WEBUI_PASSWORD）。服务默认只绑定 127.0.0.1，一旦对网络暴露，没密码的会话等于公开。

进阶：把它接入你的工作流

CLI 和 WebUI 混用。你在 Hermes CLI 里跑的会话会带金色 cli 徽章出现在侧边栏，点一下就能导入完整历史，然后在浏览器里继续回复。适合终端为主、偶尔用手机查进度的用法。

定时任务配会话提醒。在 Tasks 面板建 cron 任务，跑完会弹 toast、挂未读角标，结果还能推送到 Telegram、Discord、Slack。适合报表、巡检这类"人不在也要跑"的活。

对话连着 workspace 干。对话里提到的文件用右侧文件面板打开，能直接预览和编辑。适合习惯在浏览器里写代码、改文档的人，不用切回终端。

🕳️ 踩坑备忘

• 侧边栏看不到 CLI 会话 → 设置里的 Show CLI sessions 被关了 → 在 Preferences 打开。
• 手机打不开页面 → 服务默认只监听 127.0.0.1 → 走 SSH 隧道，或绑 0.0.0.0 并设密码。
• 流式输出中途断、画面卡住 → SSH 隧道抖动 → SSE 会自动重连，不恢复就刷新页面。
• 装成 PWA 后更新到白屏 → 反向代理 basic auth 挡住了 service worker → 按 docs/troubleshooting.md 的恢复步骤处理。

写在最后

再回到开头那个场景：侧边栏堆着 50 个会话时，找一条的成本其实只剩几秒——固定的在顶上，过时的归档，项目分主题，标签分类型。现在就打开侧边栏，把三个月没碰的会话归档掉，这是 Hermes WebUI 会话管理里见效最快的一步。首次配置细节可以看 docs/onboarding.md。

【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webui