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-webuiHermes WebUI 会话管理主要解决一个很实际的问题对话一多怎么找、怎么搬、怎么确认没丢。所有会话数据落在本地~/.hermes/webui/目录侧边栏的固定、归档、项目分组都是对这份本地数据的轻量操作。理解了这一点大部分行为都能自己推导出来出问题时也知道往哪查。 会话多了以后先谈找搜索、#tag 与日期分组的组合拳侧边栏搜索框会同时匹配标题和消息正文输入关键词即可定位。会话在列表里按 Today / Yesterday / Earlier 三组展示日期分组可折叠翻旧会话时不必从头滑到尾。另外有个轻量技巧在标题里加#标签如#编程会生成彩色 chip点一下 chip 就按它过滤比新建一套分类系统省事得多。固定、归档与项目分组的分工每个会话右侧的⋯下拉提供固定、移动到项目、归档、复制、删除五个动作职责各不相同。固定pin带金色标记把当前高频会话钉在侧边栏顶部归档是隐藏但不删除关掉归档视图它们就从列表消失需要时再开回来项目则是有颜色标识的命名分组适合按工作线归类。复制出来的会话是独立副本改标题互不影响。️ 会话的进出CLI 导入与导出带金色 cli 徽章的会话怎么来的如果同一台机器上跑过 hermes-agent 的命令行那些会话会直接出现在侧边栏带金色 cli 徽章。它不是完整加载而是从 agent 的state.db投影出的行点一下就能导入完整历史随后在网页里正常续聊。不想看到它们时设置里有个显示/隐藏 CLI 会话的开关默认开启。导出 Markdown 转录和 JSON 之后数据在哪从侧边栏的 Hermes Control Center 进入 Conversation 标签可以下载 Markdown 转录、完整 JSON 导出或从 JSON 导入。导出物只是会话数据的副本原数据仍留在状态目录的sessions/下导出多少遍都不影响在线会话。跨机器迁移时把 JSON 拷过去再导入即可。只读分享链接长什么样同样在 Control Center 里可以为当前会话生成一个公开只读分享链接。打开分享页看到的是脱敏后的转录快照没有工作区路径、没有 profile、没有任何实时控件适合把一段对话甩给别人看。 成本与状态确认会话还活着/usage与设置里的开关每个会话可以显示输入令牌、输出令牌和估算成本这个显示默认是关的。打开方式有两个设置里切换开关或在输入框敲/usage。长期开着它能直观看到哪些会话在持续烧 token。刷新、断线之后为什么会话还在Hermes WebUI 会话管理承诺的一点是页面刷新、SSH 隧道断开重连之后会话列表和当前对话都还在。浏览器标签页标题会同步成活动会话名多标签页切换时靠它辨认。会话没丢的前提是状态目录没变这点后面排查章节会展开。洞察面板看趋势洞察面板会把message_count等数据同步进state.db按天聚合展示各模型的令牌用量。它回答的不是这个会话花多少而是我这段时间花在什么模型上。 会话消失时的排查顺序先查状态目录是不是搬家了最常见的坑是升级后状态目录解析规则变了现在默认跟随HERMES_HOME落在$HERMES_HOME/webui。如果之前把HERMES_HOME挪到过非默认位置、又没单独设HERMES_WEBUI_STATE_DIR会话会整体消失其实只是路径变了。显式设HERMES_WEBUI_STATE_DIR指回旧位置即可找回。再查归档与 CLI 会话开关第二种可能是会话被归档了列表默认隐藏打开归档开关就能看到。第三种是看到的多半是 CLI 会话显示开关被关了。三件事按顺序查一遍绝大多数丢会话都能解释。 深度机制一个会话到底存在哪一个 JSON sidecar加一个索引文件每个会话在~/.hermes/webui/sessions/下对应一个{session_id}.jsonSession类把messages、tool_calls、pinned、archived、project_id等字段整体写成 JSON。目录里还有个_index.json每次保存都会重建列表接口读索引而不是扫全目录所以会话上千条时侧边栏依然跟手。字段层面JSON sidecar 是唯一的权威来源包括消息、归档状态、令牌统计和草稿。内存 LRU 只决定快不快不决定丢不丢服务进程里维护一个内存中的SESSIONS缓存用 LRU 上限约束webui.sessions_cache_max或环境变量HERMES_WEBUI_SESSIONS_MAX。被淘汰的只能是干净、已持久化、非活动的会话下次访问会从 JSON sidecar 惰性重载。所以调低缓存上限影响的是响应速度不是数据安全。细节可参考 ARCHITECTURE.md 的 Session Model 一节。侧边栏里的 CLI 行是投影不是会话api/models.py里的get_cli_sessions()把当前 profile 的state.db投影成侧边栏形状的有限窗口Cron、Webhook 等后台来源各有独立配额避免挤占交互会话的展示空间。项目里还放着一个休眠态的统一存储适配器experimental.unified_session_db默认关闭它只在 JSON sidecar 之上包了一层 SessionDB 形状的接口见 docs/architecture/unified-session-db.md。把这几层拆开看Hermes WebUI 会话管理的每一层都能独立理解侧边栏的每次点击最终都落回那一个 JSON 文件数据流向清晰出问题时也就有迹可循。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考