ghcr.io/nesquena/hermes-webui:0.51.560

Hermes Web UI

https://hermes-agent.nousresearch.com/ 是一款运行在您服务器上的复杂自主代理，可通过终端或消息应用访问，能够记住所学内容，运行时间越长能力越强。

Hermes WebUI 是一款轻量级、深色主题的 Web 应用界面，可在浏览器中使用 https://hermes-agent.nousresearch.com/%E3%80%82%E5%AE%83%E4%B8%8E CLI 体验完全一致——所有可通过终端完成的操作，都能通过此 UI 实现。无需构建步骤，无需框架，无需打包工具。仅需 Python 和原生 JS。

布局：三面板。左侧边栏用于会话和导航，中间为聊天区域，右侧为工作区文件浏览。模型、配置文件和工作区控制项位于 composer footer（编辑器底部）——在编辑时始终可见。圆形上下文环可让您一目了然地查看 token 使用情况。所有设置和会话工具都位于 Hermes Control Center（启动器位于边栏底部）。

• 支持完整配置文件的浅色模式
• 自定义设置，配置密码
• 带内联预览的工作区文件浏览器
• 会话项目、标签和工具调用卡片

这使您通过便捷的 Web UI 获得与 Hermes CLI 几乎 1:1 的功能对等，您可以通过 Hermes 环境中的 SSH 隧道安全访问该 UI。单命令即可启动，单命令即可通过 SSH 隧道在您的计算机上访问。Web UI 的每一部分都使用您现有的 Hermes 代理和现有模型，无需任何额外设置。

功能特性

聊天与智能体

• 通过 SSE 实现流式响应（生成 tokens 时即时显示）
• 多提供商模型支持——任何 Hermes API 提供商（OpenAI、Anthropic、Google、DeepSeek、Nous Portal、OpenRouter、MiniMax、小米 MiMo、Z.AI）；根据已配置的密钥动态生成模型下拉列表
• 可在消息处理过程中发送新消息——系统会自动排队
• 内联编辑任何历史用户消息并从该点重新生成响应
• 一键重试上一条助手响应
• 直接从输入框底部取消正在运行的任务（发送按钮旁的停止按钮）
• 内联工具调用卡片——每张卡片显示工具名称、参数和结果片段；支持展开/折叠所有卡片的切换，适用于多工具调用场景
• 子智能体委托卡片——子智能体活动显示独特图标和缩进边框
• 内联渲染 Mermaid 图表（流程图、序列图、甘特图）
• 思考/推理过程显示——Claude 扩展思考和 o3 推理块以可折叠金色主题卡片呈现
• 危险 shell 命令的审批卡片（允许一次/会话内/始终允许/拒绝）
• 网络中断时 SSE 自动重连（SSH 隧道弹性）
• 文件附件在页面重新加载后仍可保留，默认存储在活动工作区之外（~/.hermes/webui/attachments/，或配置 HERMES_WEBUI_ATTACHMENT_DIR 时的路径）
• 消息时间戳（每条消息旁显示 HH:MM，悬停显示完整日期）
• 代码块复制按钮，带有“已复制！”反馈
• 通过 Prism.js 实现语法高亮（支持 Python、JS、bash、JSON、SQL 等）
• AI 响应中安全 HTML 渲染（粗体、斜体、代码转换为 Markdown）
• 使用 rAF 限流的 token 流，确保长响应期间渲染更流畅
• 输入框底部的上下文使用指示器——显示 token 数量、成本和填充条（模型感知）

会话管理

• 创建、重命名、复制、删除会话，可按标题和消息内容搜索
• 每个会话通过 ⋯ 下拉菜单执行操作——固定、移动到项目、归档、复制、删除
• 将会话固定/标星到侧边栏顶部（金色指示器）
• 归档会话（隐藏但不删除，可切换显示）
• 会话项目——带颜色的命名分组，用于组织会话
• 会话标签——在标题中添加 #tag 以显示彩色标签，点击可筛选
• 在侧边栏按今日/昨日/更早分组（可折叠日期组）
• 可下载为 Markdown 转录文本、完整 JSON 导出，或从 JSON 导入
• 会话在页面重新加载和 SSH 隧道重连后仍可保留
• 浏览器标签标题反映当前活动会话名称
• CLI 会话桥接——来自 hermes-agent SQLite 存储的 CLI 会话在侧边栏显示，带有金色“cli”徽章；点击可导入完整历史并正常回复
• Token/成本显示——每个对话显示输入 tokens、输出 tokens 和预估成本（可在设置中或通过 /usage 命令切换）

工作区文件浏览器

• 可展开/折叠的目录树（单击切换，双击导航）
• 带有可点击路径段的面包屑导航
• 内联预览文本、代码、Markdown（已渲染）和图像
• 使用 workspace://path/to/file 的聊天链接会在右侧预览窗格中打开文件
• 编辑、创建、删除和重命名文件；创建文件夹
• 二进制文件下载（由服务器自动检测）
• 目录导航时文件预览自动关闭（带有未保存编辑保护）
• Git 检测——工作区标题显示分支名称和未提交文件数量徽章
• 右侧面板可拖动调整大小
• 语法高亮的代码预览（Prism.js）

语音输入

• 输入框中的麦克风按钮（Web Speech API）
• 点击开始录音，再次点击或发送消息停止录音
• 实时临时转录文本显示在文本框中
• 沉默约 2 秒后自动停止
• 追加到现有文本框内容（不替换）
• 浏览器不支持 Web Speech API 时隐藏（Chrome、Edge、Safari 支持）

配置文件

• 输入框底部的配置文件芯片——下拉菜单显示所有配置文件，包含网关状态和模型信息
• 网关状态点（绿色 = 运行中）、模型信息、每个配置文件的技能数量
• 配置文件管理面板——从侧边栏创建、切换和删除配置文件
• 创建时可从活动配置文件克隆配置
• 创建时可选的自定义端点字段——创建时将 Base URL 和 API 密钥写入配置文件的 config.yaml，因此无需手动编辑文件即可配置 Ollama、LMStudio 和其他本地端点
• 无缝切换——无需重启服务器；重新加载配置、技能、内存、定时任务和模型
• 按会话跟踪配置文件（记录创建时活动的配置文件）

设置与配置

• Hermes 控制中心（侧边栏启动按钮）—— 对话选项卡（导出/导入/清除）、偏好设置选项卡（模型、发送键、主题、语言、所有开关）、系统选项卡（版本、密码）
• 发送键：Enter（默认）或 Ctrl/Cmd+Enter
• 显示/隐藏 CLI 会话开关（默认启用）
• 令牌使用情况显示开关（默认关闭，也可通过 /usage 命令）
• 控制中心打开时始终显示对话选项卡；关闭时重置
• 未保存更改保护——关闭时存在未持久化更改会提示放弃/保存
• 定时任务完成提醒——悬浮通知和任务选项卡上的未读标记
• 后台代理错误提醒——非活动会话发生错误时显示横幅提示

运行测试

测试会动态发现仓库和 Hermes agent——无硬编码路径。使用仓库测试运行器，确保本地运行不会意外使用不受支持的系统 Python。它会创建/使用包含 Python 3.11、3.12 或 3.13 的 .venv，并在缺失时从 requirements-dev.txt 安装开发测试依赖。

cd hermes-webui
./scripts/test.sh

为聚焦运行，可在脚本后传递常规 pytest 参数：

./scripts/test.sh tests/test_regressions.py -v

或者从明确支持的基础解释器初始化仓库 .venv：

HERMES_WEBUI_TEST_PYTHON=/path/to/python3.12 ./scripts/test.sh tests/ -v

此覆盖选项选择用于创建或重建 .venv 的 Python；依赖仍安装在仓库本地的虚拟环境中，而非系统/Homebrew 解释器。

测试在带有独立状态目录的隔离服务器上运行。生产数据和实际的 cron 任务绝不会被触及。当前快照：约 7,150 个测试用例分布在约 700 个测试文件中，在 CI 中基于 Python 3.11、3.12 和 3.13 运行（每个版本 3 个并行分片）。

贡献者

Hermes WebUI 的开发离不开开源社区的帮助。每一个 PR——无论是直接合并、纳入批量发布，还是从大型提案中提取的部分——都对项目产生了影响，我们感谢所有花时间贡献的人。

已有超过 280 位贡献者 提交的代码被纳入发布版本。完整且持续更新的贡献者名单——包括所有提交过一两个 PR 的人以及在设计和架构工作方面的特别致谢名单——可在 CONTRIBUTORS.md 中查看。以下是贡献最活跃的贡献者快照：

主要贡献者（按 PR 数量排序，包括被合并/批量发布的工作）

完整的 280 位贡献者排名列表（包括提交 3+ PR 的表格、1–2 PR 的名单以及设计和架构贡献的特别致谢说明）请参见 CONTRIBUTORS.md。

重要贡献

https://github.com/franksong2702 — 最活跃的外部贡献者（180 个 PR，v0.49.3 → v0.51.384）
作为任期最长的外部贡献者，贡献包括：会话标题保护（#301）、面包屑工作区导航（#302）、嵌入式工作区终端（#1099）、基于工作树的会话创建（#2053）、入门文档（#2052）、编辑器页脚容器查询、流式会话侧边栏豁免（#1327）、会话侧车修复、cron 输出保留（#1295）、配置文件默认工作区持久化、手动 /compress 异步启动/状态端点（#2128）、工作树状态显示（#2109）+ 生命周期总览 #2057 的受保护删除（#2156）、会话渲染后去重（#2166）、原生 WebUI 快速路径（#2170）、尾部窗口响应修剪（#2171）、过期流保护扩展（#2158）、CSP 报告收集器（#2160），以及在移动/响应式设计、会话侧边栏和工作区状态机方面的大量优化。

https://github.com/Michaelyklam — 近期版本最活跃的贡献者（118 个 PR，v0.50.240 → v0.51.198）
贡献包括：生产环境 Docker 强化（#1921，移除具有 sudo 权限的临时用户）、配置文件作用域的技能端点（#1903）、配置文件作用域 HERMES_HOME 下的网关 PID 解析（#1901）、配置文件感知的 AIAgent 缓存（#1898/#1904）、反斜杠 LaTeX 分隔符（#1848）、Codex 配额错误显示（#1770）、shell 路由 HTML 503 错误（#1836）、过期看板客户端恢复（#1828）、上下文自动压缩提示框生命周期（#1988）、/goal 命令（#1866）、看板详情视图滚动（#1916）、CLI 会话工具元数据保留（#1778）、繁体中文看板本地化补充（#1979）、v0.51.51 移动版 Insights 分组/布局（#2120/#2121）、Hermes 运行适配器 RFC（#2105，用于 #1925）、从此处分支的绝对索引（#2198，用于 #2184）、opencode-go 自定义提供程序重叠路由（#2204，用于 #1894）。

https://github.com/rodboev — Windows/跨平台正确性 + 测试可靠性（83个PR，v0.51.223 → v0.51.384）
广泛而持续的改进，重点确保项目在Linux之外的环境中正常运行：ctl.sh的Windows进程树终止修复（#3670）、Windows本地全套信号/孤儿进程处理、斜杠命令自动补全优化，以及通过数十个发布批次交付的大量前端和基础设施修复。

https://github.com/bergeouss — 提供商管理界面 + Docker安全加固（70个PR，v0.48.0 → v0.51.385）
设置页面中用于添加/编辑自定义提供商的管理界面、OAuth提供商状态检测（#1552）、双容器Docker设置、配置文件隔离加固（每个配置文件的.env密钥）、用户在“设置→提供商”页面看到的大部分内容、“在Finder中显示”上下文菜单（#1551）、网关状态卡片（#1552）、按活动项目筛选器自动分配会话（#1550）、更新横幅中的“新增功能？”链接（#1549）、OpenRouter免费层实时获取（#1548）、凭据池401错误自修复（#1553）、模型选择器中的内联提供商芯片+组模型计数（#1644）。

https://github.com/ai-ag2026 — 会话恢复 + 审计基础架构（75个PR，v0.50.279 → v0.51.367）
自治AI贡献者（由Hermes Agent驱动），专注于耐用性：基于state.db的边车协调（#2041）、启动时孤儿.json.bak文件恢复（#2035）、只读会话恢复审计端点（#2036、#2040）、/health端点中的活动运行生命周期（#2039）、docs/rfcs/turn-journal.md中的崩溃安全对话日志RFC（#2042）、仅追加对话日志辅助工具（#2059）、生命周期事件层（#2062）、Content-Security-Policy-Report-Only头（#2084）、每个定时任务的通知开关（#2100）、分叉会话压缩谱系隔离（#2014）。

https://github.com/dso2ng — 会话谱系 + 诊断（30个PR，v0.50.227 → v0.51.327）
用于有限会话图诊断的/api/session/lineage-report/端点（#2012）、陈旧Mermaid渲染错误清理（#1337）、session_source="fork"的延续链隔离（#2063）、侧边栏徽章展开时延迟加载谱系报告（#2130），以及大量围绕会话加载的前端可靠性修复。

https://github.com/jasonjcwu — 编辑器 + 对话记录优化（16个PR，v0.50.227 → v0.51.132）
通过活动轨道点击折叠侧边栏（#2054，整合#1884 + #1924）、编辑器芯片灯箱（#1758）、工具密集型首次对话的标题修复、会话切换期间的静默压缩状态（#2185）、并发发送丢失修复（#2186）、对话记录中的引导消息徽章（#2187），以及一系列前端优化修复。

https://github.com/Jordan-SkyLF — 实时流 + 用户体验优化（12个PR，v0.50.18 → v0.51.66）
最初的工作区回退解析冲刺、实时推理卡片（#366、#367、#394–#397），以及近期的集中改进：提供商配额卡片上的手动“刷新用量”按钮（#2150）、取消对话状态分类（#2151）、Firefox侧边栏滚动稳定性（#2200）、早期临时会话标题（#2202）、目标感知的“新增功能？”更新横幅链接（#2207），以及设置中MCP工具溢出修复（#2210）。

https://github.com/aronprins — v0.50.0 UI大修（PR #242，外加9个后续PR）
项目最大的单项贡献：完整的UI重新设计，将模型/配置文件/工作区控件移至编辑器底部，用Hermes控制中心（标签式模态框）替换齿轮图标设置面板，移除活动栏并改用内联编辑器状态，通过⋯操作下拉菜单重新设计会话列表，以及添加工作区面板状态机。此外还包括聊天记录重新设计（#587）、侧边栏精简（#584）、三列布局重构（#899）、明暗主题+强调色皮肤（#627），以及共享confirm()/prompt()对话框替换（从#242中提取的PR #251）。

https://github.com/iRonin — 安全加固冲刺（PR #196–#204）
六个连续且专注的安全PR：会话内存泄漏修复（过期令牌清理）、CSP + Permissions-Policy头、30秒慢客户端连接超时、通过环境变量的可选HTTPS/TLS支持、自更新的上游分支跟踪修复，以及文件浏览器API中的CLI会话支持。这类专注且高质量的安全工作使自托管工具更值得信赖。

https://github.com/lucasrc — 身份验证加固三部曲（PR #2191、#2192、#2193）
三个协同安全PR均在v0.51.57中发布：带PBKDF2密钥分离的线程安全登录速率限制器、设置保存时的密码哈希缓存失效，以及完整的64字符HMAC-SHA256会话签名（含向后兼容迁移桥）。这类清晰分解的安全工作可作为三个独立部分进行审查。

https://github.com/LumenYoung — 流处理热路径正确性（8个PR，v0.51.47 → v0.51.99）
最初的 stale-stream 写回保护（#2136——后续两个版本扩展的bug类型）、网关状态alive-null分类（#2075）、压缩横幅锚点对齐（#2182），以及压缩完成时上下文进度环自动刷新（#2188）。每个PR都在代码库中最脆弱的子系统之一中进行了小而精确的修复。

https://github.com/dobby-d-elf — 前端可靠性 + 动效优化（15个PR，v0.51.38 → v0.51.161）
删除目录时的工作区回退（#2138）、iPhone PWA底部滚动修复（#2143）、新的“活动：X个工具”编辑器底部微光动画（#2203），以及后续动画调整（#2212）。

https://github.com/JKJameson — 编辑器 + 会话优化（10个PR）
每个会话的持久编辑器草稿（#1956），以及编辑器和会话侧边栏的大量优化。

https://github.com/gabogabucho — 西班牙语本地化 + 引导向导
完整的西班牙语（es）本地化覆盖所有UI字符串，以及首次启动时引导新用户完成提供商设置的一次性引导向导。

https://github.com/deboste — 反向代理身份验证 + 移动响应式布局（PR #3、#4、#5）
最早的三个社区PR：修复EventSource/fetch以在反向代理设置中使用URL源、从配置中修正模型提供商路由，以及添加带dvh视口修复的移动响应式布局。早期基础工作。

https://github.com/indigokarasu — 视觉重新设计提案（PR #213）
纯CSS的完整UI重新设计——完善的设计标记、替换表情符号标签栏的图标轨道侧边栏、一致的表单卡片、面包屑导航，以及7个基于自定义属性的内置主题。该PR未按原样合并，但塑造了v0.50.0中发布的设计语言和主题架构。