企业官网建设流程全解析

Hermes WebUI 会话管理：搜索、归档与 CLI 迁入的实用做法

【免费下载链接】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 的浏览器端界面，这篇文章围绕会话管理展开，覆盖搜索、固定、归档、复制会话、CLI 迁入和导出备份，帮你把攒了几百条的侧边栏重新变得可控。

📁 会话上百条找不到：用搜索和标签过滤

这节解决"旧对话翻不出来"的问题。

按标题和消息内容搜索

• 在侧边栏搜索框输入关键词
• 结果匹配标题和消息内容
• 内容匹配默认只看最近 5 条消息

搜不到旧消息时，说明关键词落在更早的对话里，这时可以先按标题缩小范围，再进会话内查看。

用标签和项目分类

• 在标题里加#标签生成彩色标记
• 点击标签过滤出同类会话
• 新建项目，把相关会话移进去

实际上标签适合临时归类，项目适合长期分组，两者混用就能覆盖大部分会话管理场景。

📌 侧边栏太长：固定常用会话、归档旧会话

这节解决"常用会话被淹没"的问题。

固定常用会话到顶部

• 点会话右侧⋯菜单，选 Pin
• 固定后会话置顶显示
• 默认最多固定 3 个

达到上限时固定会失败，需要先取消一个旧固定再操作。

归档旧会话

• 在⋯菜单选 Archive 归档
• 归档只隐藏，不删除数据
• 侧边栏可切换显示归档内容

说白了，归档是给"暂时用不上但不想删"的会话一个去处，主列表因此保持干净。

📋 想换方向聊：复制会话再分叉

这节解决"分叉讨论弄脏原对话"的问题。

一键复制整个会话

• 在⋯菜单选 Duplicate
• 副本标题带 (copy) 后缀
• 副本独立保存，可自由修改

原会话不受任何影响，两边消息互不干扰。

改历史消息后重新生成

• 双击某条历史用户消息直接编辑
• 保存后从该点重新生成回复
• 适合试错而不想污染主线

📥 终端 CLI 会话一键迁入 Web 端

这节解决"CLI 对话在网页端看不到"。

识别带 cli 徽章的会话

• CLI 会话自动出现在侧边栏
• 条目上带金色 cli 徽章
• 受"显示 CLI 会话"开关控制

点击导入完整历史

• 点击徽章会话即导入全部历史
• 导入后照常发消息继续聊
• 只读会话不能归档或删除

这也属于跨端会话管理的一部分。如果 CLI 会话没出现，先检查开关是否打开，仍看不到可查 docs/troubleshooting.md。

📤 离开 WebUI 之前：导出与备份

这节解决"对话数据带不走"的顾虑。

导出 Markdown 或 JSON

• 打开控制中心的对话页
• 选择导出为 Markdown 或 JSON
• JSON 导出可再次导入恢复

Markdown 适合归档和阅读，JSON 适合迁移和恢复。导出是会话管理里最容易被忽略的一步，建议每隔一段时间各导一份。

备份状态目录

• 会话默认存于~/.hermes/webui
• 定期整目录备份最稳妥
• 用HERMES_WEBUI_STATE_DIR可改位置

📊 令牌成本看不见：开启用量显示

这节解决"对话消耗算不清"的问题。

开启令牌与成本显示

• 在设置中打开令牌用量显示
• 每条会话显示输入和输出令牌
• 也可直接发/usage命令查看

按天查看趋势

• 在洞察面板看每日令牌消耗
• 按模型维度查看用量分布
• 配合输入框下方的上下文圆环盯当前会话

会话数据存在哪里：JSON 文件加 state.db

这节解释会话管理背后的存储结构。

每个会话保存为独立的 JSON 文件，state.db维护会话索引和元数据，两者配合保证刷新页面或 SSH 隧道重连后会话自动恢复，浏览器标签页标题也会跟着当前会话名变化。远程访问的细节可参考 docs/remote-access.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