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-webuiHermes WebUI 的会话Session是它区别于普通聊天窗口的核心。本文覆盖会话的创建、搜索、标签/项目/归档、批量操作、CLI 导入、Markdown/JSON 导出和持久化机制目标是让你把散落的对话变成一个可维护的库。 核心能力概览先看清楚它到底提供了什么再动手全量 CRUD 内容搜索新建、重命名、复制、删除之外搜索框支持按标题和消息正文过滤不止匹配会话名标签 项目双层组织标题里的#标签会渲染成彩色芯片并可点击过滤项目Project是带颜色的命名分组两者可以叠加使用批量选择模式侧边栏可进入多选模式一次勾选多个会话做归档、移动、删除处理会话积压时省时间CLI 会话桥接hermes-agent 命令行里的会话会带金色cli徽章出现在侧边栏点一下即可带完整历史导入 WebUI 继续聊多格式导出单会话可导出 Markdown 转录或完整 JSON控制中心的 Conversation 页签还支持导入 JSON 和创建只读分享链接️ 基础操作从零到跑通新建一个会话点击侧边栏顶部的新建会话New Conversation按钮。新会话创建后是空白对话浏览器标签页标题会同步为当前会话名——这个设计在多标签页切会话时很实用。给会话取个好名字重命名走会话项右侧的⋯菜单里的Rename。命名建议带上日期或项目前缀比如2026-09-08_周报草稿。因为侧边栏按 Today / Yesterday / Earlier 分组好名字能配合搜索在几百个会话里直接命中。搜索定位在侧边栏搜索框输入关键词。它同时匹配标题和消息内容注意这一点就算你忘了会话名只要记得聊过什么也能找回来。固定、归档单会话⋯菜单里还有Pin金色置顶、Archive隐藏但保留、Duplicate复制一份、Delete。归档适合暂时不用但不想删的会话侧边栏有开关可以显示归档项。用键盘切会话焦点不在输入框时按j/k可以在侧边栏上下切换会话这是代码里明确绑定的导航快捷键。批量模式用Escape退出。️ 组织与定制标签、项目与批量操作给标题加 #标签在会话标题里直接写#标签例如#编程 #研究。标签会渲染成彩色芯片点击芯片即按标签过滤会话列表。一个会话挂多个标签也没问题。说白了标签是零成本的分面检索不用维护任何额外结构。建立项目分组通过⋯菜单的Move to Project把会话归入项目项目入口在侧边栏底部还有 New project快捷项。项目是带颜色的命名分组适合按工作 / 个人 / 实验切一刀。一个可用的命名规范项目用业务域命名后端、论文标签用状态或属性命名#待办、#灵感。分组看归属标签看属性两套维度不冲突。进入批量选择模式侧边栏有一个select mode切换按钮非选择模式时常驻显示。进入后每个会话项前出现复选框可逐个勾选或全选底部操作栏会显示已选数量。对选中会话执行动作选择模式下底部有三个动作批量归档、移动弹出项目选择器、批量删除。归档和删除前都有确认弹窗涉及 worktree 会话时会额外提示数量。处理完按Escape或点操作栏的✕退出选择模式。 数据流转导入、导出与持久化从 CLI 导入会话如果你平时在终端用 hermes-agent它的 SQLite 会话库会被 WebUI 自动发现侧边栏出现带金色cli徽章的条目点击即导入完整历史之后可以正常在 WebUI 里回复。设置里有一个 Show/hide CLI sessions 开关默认开启不想要这批条目时关掉即可。导出会话三个出口适用场景不同方式入口适用场景Markdown 转录⋯菜单 → Download阅读、归档进笔记库、贴文档完整 JSON⋯菜单 / 控制中心 Conversation 页签备份、迁移、二次处理含全部元数据只读分享链接控制中心 → Create share link给别人看对话页面只展示清洗后的转录快照不含工作区和在线控制导入会话控制中心侧边栏底部启动器打开 Conversation 页签支持从 JSON 文件导入会话导入时会校验工作区路径。注意JSON 导出/导入是格式兼容的正道Markdown 导出只适合阅读不能回流。持久化行为会话状态落在~/.hermes/webui/可用HERMES_WEBUI_STATE_DIR覆盖页面刷新和 SSH 隧道重连后自动恢复附件默认存在~/.hermes/webui/attachments/session_id/。备份这个目录就覆盖了会话、工作区记录、设置和项目数据建议定期打包。⚙️ 进阶玩法与底层机制侧边栏的分组与折叠逻辑侧边栏按 Today / Yesterday / Earlier 三个可折叠日期组渲染会话。如果你想了解为什么刷新后分组不跳变——因为分组时间戳读自服务端会话元数据而不是本地缓存这保证多设备看到的是同一份时间轴。存储是双层的如果你想了解为什么侧边栏加载快答案在存储架构每个会话有一个独立 JSON 文件存完整消息sidecarstate.db这个 SQLite 状态库可以理解为一张会话索引表只存元数据和消息计数。查询走索引全文按需懒加载 JSON所以长会话列表也不会拖慢首屏。压缩链的合并显示长对话会触发 Hermes 的上下文压缩把旧消息摘要成锚点。WebUI 会把同一条压缩链合并为一个逻辑会话显示在侧边栏历史仍可按段展开。如果你看到某个会话内容比实际短多半是压缩锚点在生效展开分段即可看全。内存与缓存上限服务端对热会话有 LRU 缓存HERMES_WEBUI_AGENT_CACHE_MAX默认 25HERMES_WEBUI_SESSIONS_MAX默认 100。会话多且长的时候调低第一个变量能压住常驻内存——代价是切换会话时冷加载变多。被淘汰的只会是干净、已落盘、非活动的会话下次访问从 JSON 懒加载回来不丢数据。令牌与成本统计每条会话显示输入/输出令牌和估算成本默认关闭两种方式开启设置里打开 Token usage display或直接在对话里发/usage。配合右侧上下文环composer footer 里的用量条长会话何时接近压缩阈值一目了然。️ 实战收尾问题排查与最佳实践高频问题和对应解法刷新后会话列表变空先确认HERMES_HOME是否被改过。状态目录默认跟随$HERMES_HOME/webui如果你之前手动改过HERMES_HOME却没设HERMES_WEBUI_STATE_DIR状态会解析到新位置。显式设置HERMES_WEBUI_STATE_DIR指回旧目录即可CLI 会话不见了检查设置里的 Show CLI sessions 开关是否被关默认是开的关掉后cli徽章条目会隐藏搜索找不到会话确认搜索命中的是标题或正文纯元数据如创建时间不参与匹配先按标签过滤缩小范围再搜批量删除误伤批量操作前先看操作栏的已选数量徽章worktree 会话删除时有二次确认确认弹窗里会列出受影响的 worktree 数导出文件打不开确认走的是 JSON 通道含完整结构而不是 Markdown 转录JSON 用标准文本工具打开即可安全与备份建议远程暴露端口HERMES_WEBUI_HOST0.0.0.0时必须设置HERMES_WEBUI_PASSWORD登录页另有可选 passkey备份~/.hermes/webui目录含state.db和所有会话 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Hermes WebUI 会话管理：从建库到导出的完整实战指南
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-webuiHermes WebUI 的会话Session是它区别于普通聊天窗口的核心。本文覆盖会话的创建、搜索、标签/项目/归档、批量操作、CLI 导入、Markdown/JSON 导出和持久化机制目标是让你把散落的对话变成一个可维护的库。 核心能力概览先看清楚它到底提供了什么再动手全量 CRUD 内容搜索新建、重命名、复制、删除之外搜索框支持按标题和消息正文过滤不止匹配会话名标签 项目双层组织标题里的#标签会渲染成彩色芯片并可点击过滤项目Project是带颜色的命名分组两者可以叠加使用批量选择模式侧边栏可进入多选模式一次勾选多个会话做归档、移动、删除处理会话积压时省时间CLI 会话桥接hermes-agent 命令行里的会话会带金色cli徽章出现在侧边栏点一下即可带完整历史导入 WebUI 继续聊多格式导出单会话可导出 Markdown 转录或完整 JSON控制中心的 Conversation 页签还支持导入 JSON 和创建只读分享链接️ 基础操作从零到跑通新建一个会话点击侧边栏顶部的新建会话New Conversation按钮。新会话创建后是空白对话浏览器标签页标题会同步为当前会话名——这个设计在多标签页切会话时很实用。给会话取个好名字重命名走会话项右侧的⋯菜单里的Rename。命名建议带上日期或项目前缀比如2026-09-08_周报草稿。因为侧边栏按 Today / Yesterday / Earlier 分组好名字能配合搜索在几百个会话里直接命中。搜索定位在侧边栏搜索框输入关键词。它同时匹配标题和消息内容注意这一点就算你忘了会话名只要记得聊过什么也能找回来。固定、归档单会话⋯菜单里还有Pin金色置顶、Archive隐藏但保留、Duplicate复制一份、Delete。归档适合暂时不用但不想删的会话侧边栏有开关可以显示归档项。用键盘切会话焦点不在输入框时按j/k可以在侧边栏上下切换会话这是代码里明确绑定的导航快捷键。批量模式用Escape退出。️ 组织与定制标签、项目与批量操作给标题加 #标签在会话标题里直接写#标签例如#编程 #研究。标签会渲染成彩色芯片点击芯片即按标签过滤会话列表。一个会话挂多个标签也没问题。说白了标签是零成本的分面检索不用维护任何额外结构。建立项目分组通过⋯菜单的Move to Project把会话归入项目项目入口在侧边栏底部还有 New project快捷项。项目是带颜色的命名分组适合按工作 / 个人 / 实验切一刀。一个可用的命名规范项目用业务域命名后端、论文标签用状态或属性命名#待办、#灵感。分组看归属标签看属性两套维度不冲突。进入批量选择模式侧边栏有一个select mode切换按钮非选择模式时常驻显示。进入后每个会话项前出现复选框可逐个勾选或全选底部操作栏会显示已选数量。对选中会话执行动作选择模式下底部有三个动作批量归档、移动弹出项目选择器、批量删除。归档和删除前都有确认弹窗涉及 worktree 会话时会额外提示数量。处理完按Escape或点操作栏的✕退出选择模式。 数据流转导入、导出与持久化从 CLI 导入会话如果你平时在终端用 hermes-agent它的 SQLite 会话库会被 WebUI 自动发现侧边栏出现带金色cli徽章的条目点击即导入完整历史之后可以正常在 WebUI 里回复。设置里有一个 Show/hide CLI sessions 开关默认开启不想要这批条目时关掉即可。导出会话三个出口适用场景不同方式入口适用场景Markdown 转录⋯菜单 → Download阅读、归档进笔记库、贴文档完整 JSON⋯菜单 / 控制中心 Conversation 页签备份、迁移、二次处理含全部元数据只读分享链接控制中心 → Create share link给别人看对话页面只展示清洗后的转录快照不含工作区和在线控制导入会话控制中心侧边栏底部启动器打开 Conversation 页签支持从 JSON 文件导入会话导入时会校验工作区路径。注意JSON 导出/导入是格式兼容的正道Markdown 导出只适合阅读不能回流。持久化行为会话状态落在~/.hermes/webui/可用HERMES_WEBUI_STATE_DIR覆盖页面刷新和 SSH 隧道重连后自动恢复附件默认存在~/.hermes/webui/attachments/session_id/。备份这个目录就覆盖了会话、工作区记录、设置和项目数据建议定期打包。⚙️ 进阶玩法与底层机制侧边栏的分组与折叠逻辑侧边栏按 Today / Yesterday / Earlier 三个可折叠日期组渲染会话。如果你想了解为什么刷新后分组不跳变——因为分组时间戳读自服务端会话元数据而不是本地缓存这保证多设备看到的是同一份时间轴。存储是双层的如果你想了解为什么侧边栏加载快答案在存储架构每个会话有一个独立 JSON 文件存完整消息sidecarstate.db这个 SQLite 状态库可以理解为一张会话索引表只存元数据和消息计数。查询走索引全文按需懒加载 JSON所以长会话列表也不会拖慢首屏。压缩链的合并显示长对话会触发 Hermes 的上下文压缩把旧消息摘要成锚点。WebUI 会把同一条压缩链合并为一个逻辑会话显示在侧边栏历史仍可按段展开。如果你看到某个会话内容比实际短多半是压缩锚点在生效展开分段即可看全。内存与缓存上限服务端对热会话有 LRU 缓存HERMES_WEBUI_AGENT_CACHE_MAX默认 25HERMES_WEBUI_SESSIONS_MAX默认 100。会话多且长的时候调低第一个变量能压住常驻内存——代价是切换会话时冷加载变多。被淘汰的只会是干净、已落盘、非活动的会话下次访问从 JSON 懒加载回来不丢数据。令牌与成本统计每条会话显示输入/输出令牌和估算成本默认关闭两种方式开启设置里打开 Token usage display或直接在对话里发/usage。配合右侧上下文环composer footer 里的用量条长会话何时接近压缩阈值一目了然。️ 实战收尾问题排查与最佳实践高频问题和对应解法刷新后会话列表变空先确认HERMES_HOME是否被改过。状态目录默认跟随$HERMES_HOME/webui如果你之前手动改过HERMES_HOME却没设HERMES_WEBUI_STATE_DIR状态会解析到新位置。显式设置HERMES_WEBUI_STATE_DIR指回旧目录即可CLI 会话不见了检查设置里的 Show CLI sessions 开关是否被关默认是开的关掉后cli徽章条目会隐藏搜索找不到会话确认搜索命中的是标题或正文纯元数据如创建时间不参与匹配先按标签过滤缩小范围再搜批量删除误伤批量操作前先看操作栏的已选数量徽章worktree 会话删除时有二次确认确认弹窗里会列出受影响的 worktree 数导出文件打不开确认走的是 JSON 通道含完整结构而不是 Markdown 转录JSON 用标准文本工具打开即可安全与备份建议远程暴露端口HERMES_WEBUI_HOST0.0.0.0时必须设置HERMES_WEBUI_PASSWORD登录页另有可选 passkey备份~/.hermes/webui目录含state.db和所有会话 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考