企业官网建设流程全解析

5 分钟跑通 Hermes WebUI 会话管理：从 1 条到 500 条对话的整理指南

【免费下载链接】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

Hermes WebUI 是跑在浏览器里的 Hermes Agent 界面，它的核心之一是会话管理：每一次对话都是一个可搜索、可分组、可归档、可导出的独立会话，页面刷新或换台设备也不会丢。适合自托管 AI 助手的个人用户和开发者。

1️⃣ 先跑通最小闭环：新建一条会话，然后找回它

如果还没装，先把仓库拉下来并启动（约 2 分钟）：

git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui python3 bootstrap.py

启动后浏览器会自动打开界面，三步完成第一次"创建并找回"：

1. 点侧边栏顶部的New conversation（快捷键 Ctrl/⌘ + K）。侧边栏底部同时挂着 Transcript / JSON / Import 三个小按钮，先认识它们，后面导出用得上。
2. 在输入框发第一句话，比如"帮我梳理一份读书笔记的框架"。回复结束后，侧边栏对应分组里会出现一个新条目，标题自动取你首句的前 64 个字。
3. 验证它真的"落盘"了：点一下浏览器刷新按钮。条目还在，说明会话已经写进服务器磁盘，不再依赖这个标签页。

2️⃣ 会话堆到上百条：搜索、#标签、固定与归档

上周那段关于部署的对话，在一百多条会话里翻半天是常态。三个动作能把它从海里捞出来：

搜索框在侧边栏顶部，输入关键词会按标题和消息内容做全文匹配，上周那段对话只要内容里出现过"部署"就能命中。

想主动归类，就在标题里加一个井号标签，比如把"部署排查"改成"部署排查 #运维"。保存后标题旁多出一个彩色芯片，点一下，侧边栏立刻只显示带这个标签的会话；再点一下 All 或旁边的"显示其他会话"就还原。同类标签可以建项目分组，给每个项目配一个颜色，一眼分清哪些会话属于哪个项目。

常用会话别靠记，点会话右侧⋯菜单选 Pin，条目会跳进顶部的 PINNED 区。反过来，暂时用不上但不想删的，在 ⋯ 里选 Archive，它就从主列表消失；需要时打开"显示已归档"开关再捞回来，比删除安全得多。

会话多到滚动发卡时，侧边栏本身会做长列表虚拟化，几百条也能流畅滚，ARCHITECTURE.md 里记录了这套渲染策略的设计取舍。

3️⃣ 把命令行里的对话接回浏览器

你在终端里用 hermes 聊到一半，出门后想用手机接着聊。侧边栏会自动列出 Hermes Agent 命令行留下的对话，条目带一枚金色cli徽章，和网页新建的会话排在一起。

点它一下，完整历史就导入到网页端，直接在输入框里接着回复，不需要复制粘贴任何内容。注意它不是"只读快照"，导入后的对话就是普通网页会话，同样能改名、加标签、归档。如果侧边栏里完全看不到 CLI 对话，去设置里确认Show CLI sessions开关没被关掉（默认开启）。

4️⃣ 换台设备接着聊：跨端同步不需要你做任何事

它没有"同步"按钮，因为所有设备访问的是同一台服务器上的同一份状态。手机上要访问，两条路任选：

• SSH 隧道：ssh -N -L 8787:127.0.0.1:8787 user@host，然后手机浏览器打开http://localhost:8787（start.sh 在 SSH 连接时会自动把这条命令打印给你）。
• Tailscale：把服务器和手机拉进同一张网，配HERMES_WEBUI_HOST=0.0.0.0加一个密码后直接访问。

浏览器标签页标题会跟随当前会话名变化，多标签多任务时瞄一眼就能认出来。SSE 流在网络抖动或隧道重连后自动续上，不用手动刷新恢复。

5️⃣ 怕丢数据：导出、备份与恢复的三个动作

Hermes Control Center（侧边栏底部启动器）的Conversation页签里摆着三个按钮：

• Transcript：把当前对话下载成 Markdown 文件，适合发文档、贴 wiki。
• JSON：下载包含全部元数据的完整导出，这是你会话导入导出的标准格式。
• Import：选回之前导出的 JSON 文件，把整段历史恢复到当前环境。

真正的备份更简单：把状态目录整个拷走就是一份完整备份。默认位置是~/.hermes/webui（可用HERMES_WEBUI_STATE_DIR改），里面每个会话一个 JSON 文件，再加设置和项目文件。定期拷到网盘或另一台机器即可；换机器时把目录拷过去并让HERMES_WEBUI_STATE_DIR指向它，全部会话原样回来。

6️⃣ 它为什么可靠：30 秒看懂存储与同步机制

每个会话在状态目录里是一个独立的 JSON 文件，每轮对话结束后自动写盘；内存里只缓存最近用过的会话，被挤出去的那次打开时会从 JSON 读回来。所以重启服务、关掉标签页，历史都还在。

命令行那边的对话存在 Agent 的 SQLite 数据库state.db里，WebUI 启动时从库里投影出最近一批交互会话，这就是侧边栏里金色 cli 徽章条目的来源——两边是同一个存储体系的不同投影，不存在"网页一份、终端一份"的分裂。

长对话触发自动压缩后，压缩链会被合并成一条逻辑会话显示，侧边栏不会因此长出重复条目，完整历史仍然能点开访问。

7️⃣ 踩坑速查：五个常见卡点

• 刷新后找不到某个会话：多半被归档了。打开"显示已归档"开关，找到后从 ⋯ 菜单取消归档。
• 侧边栏没有 CLI 对话：设置里的 Show CLI sessions 被关了，打开即可；再确认当前 profile 和终端里用的是同一个。
• 滚动发卡：先用标签过滤和归档把主列表清瘦；超长对话可在设置里开启实验性的转录虚拟化开关。
• 会话标题认不出内容：标题只取首句前 64 字，点开看前几条消息确认后再 ⋯ → 重命名。
• 恢复备份后没反应：检查HERMES_WEBUI_STATE_DIR是否指向你拷来的目录，然后重启服务。

今天就能做的 3 件事

1. 给最近 5 个常用会话的标题各加一个#标签，确认侧边栏出现了彩色芯片，点一下能过滤出同一类会话。
2. 挑一个旧会话，分别点 Transcript 和 JSON 导出一份，存进网盘——这是你第一次真正的会话导入导出备份。
3. 数一下状态目录里会话 JSON 文件的个数，和侧边栏条目数对不对得上；对得上，说明每条会话都在盘上有据可查。

做完这三步，你的 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