Hermes WebUI体验
浏览器里跑AI Agent
手机也能用
纯Python · 无构建 · 三栏布局
先说结论： 上篇聊了 Hermes 官方自带的 Web Dashboard，今天说说社区项目 Hermes WebUI。它由开发者 nesquena 创建，把 Hermes Agent 的对话和管理界面做成了独立的浏览器 Web 应用，支持 SSH 隧道远程访问，手机浏览器也能流畅使用。比官方 Dashboard 更侧重对话交互，部署更灵活，适合跑在服务器上。
Hermes WebUI 已经迭代到了 v0.51 版本，6.9k Star，近 2000 次提交，3309 个测试用例，社区维护力度很大。
这个项目的定位很明确：用最轻量的方式给 Hermes 套一个 Web 界面。没有构建工具、没有框架、没有打包器，纯 Python 后端加 vanilla JS 前端。
我搭起来试了试，聊聊感受。
· · ·
01
和官方 Dashboard 有什么不同
官方 Dashboard 主打配置管理和运维监控，而 WebUI 则专注于对话体验和日常使用。两者底层都连接同一个 Hermes Agent，但定位差别挺大：
| 对比项 | 官方 Dashboard | 社区 WebUI |
|---|
| 定位 | 后台管理 / 运维 | 日常对话 / 文件管理 |
| 启动方式 | hermes dashboard (内置) | clone 仓库启动 (独立项目) |
| 远程访问 | 不推荐暴露到网络 | SSH隧道 / Tailscale |
| 手机友好 | 不支持 | 自适应，手机浏览器可用 |
| 文件管理 | 无 | 右侧面板内置文件浏览器 |
简单说：官方 Dashboard 适合偶尔看一眼配置和状态；WebUI 适合日常高频使用，部署在服务器上随时随地访问。下一篇还会写到 Hermes Desktop——社区做的桌面客户端，又是另一种体验。
· · ·
02
最让我惊喜的几个设计
三栏布局很高效
左边栏是会话列表，中间是聊天区域，右侧是工作区文件浏览器。模型选择、Profile 切换、上下文用量指示器都在底部的 Composer Footer，写消息的时候随时可见。
右侧的文件浏览器特别实用——AI 生成代码或者修改文件之后，可以直接在浏览器里预览、编辑、保存，不用再切到终端或者 IDE。它甚至能检测 Git 状态，显示当前分支和修改文件数量。
会话管理很细致
可以置顶会话、移到项目分组、归档、搜索。支持给会话加 #标签，点击标签就能过滤。还有个很实用的小功能：CLI 终端里的 Hermes 会话会自动同步到 WebUI 侧边栏，带金色"cli"标记，点一下就能导入并继续聊。
会话可以下载成 Markdown 或者 JSON，也支持从 JSON 导入——这个对做知识整理的人来说很友好。
上下文用量一目了然
底部有一个圆形的 Context Ring，可视化显示当前对话的 token 用量和费用估算。模型不同，阈值也不同——它会自动感知你用的是哪个模型的上下文窗口。
这个设计比官方 Dashboard 的纯数字显示更直观。看到圆环快满了就知道该开新对话了，不用去算数字。
工具调用可视化
AI 调用工具的时候，WebUI 用卡片形式展示——每个工具名称、参数、返回结果都清晰呈现，可以展开和折叠。子 Agent 委派时还有单独的缩进边框和图标区分。
它还支持 Mermaid 图表内联渲染——AI 生成的流程图、时序图、甘特图直接显示在对话里，不用另外找工具看。
Claude 的 extended thinking 和 o3 的 reasoning 块也有专门的折叠卡片，金色主题，看起来很有质感。
· · ·
03
部署：比想象中简单
WebUI 的部署方式很灵活，按照自己的场景选就行：
方式一：直接运行 最简单的玩法。clone 仓库，运行 python3 bootstrap.py 或 ./start.sh，自动检测 Hermes 安装，启动 Web 服务，打开浏览器就能用。
方式二：Docker 部署 提供了一容器、两容器、三容器三种 compose 方案。单容器最简单，WebUI 和 Agent 跑在一起。两容器方案把 Agent 和 WebUI 分开，适合已经有独立 Agent 服务的用户。三容器方案再加一个 Dashboard。
方式三：远程访问 服务默认绑定 127.0.0.1，通过 SSH 隧道从本机浏览器访问。也可以用 Tailscale 组网，在手机上直接打开。WebUI 有一套响应式布局，手机浏览器上界面自适应，加个桌面快捷方式体验接近原生应用。
启动脚本的自动检测做得不错——自动找 Hermes 安装目录、Python 虚拟环境、状态目录、工作区路径、端口，基本不用手动配置。如果自动检测没命中，也可以用环境变量覆盖。
· · ·
04
一些细节和不足
整体体验下来，说几个值得注意的地方：
Windows 原生启动脚本暂不支持，需要 WSL2。
两容器模式下，WebUI 中触发的工具调用跑在 WebUI 容器而非 Agent 容器里，如果需要 git/node 等工具需要注意。
WebUI 作为纯前端界面，功能丰富度和官方 Dashboard 相比各有侧重——官方 Dashboard 强在配置管理和日志查看，WebUI 则强在文件浏览和远程访问。
项目迭代很快（399 个版本标签），更新频繁可能带来一些 API 兼容性问题，不过测试覆盖 3309 个用例，质量上有保障。
· · ·
05
Dashboard 还是 WebUI，怎么选
选择取决于你的使用习惯：
选官方 Dashboard 如果： 你只需要偶尔看看配置、查日志、管 cron，不想装额外的东西，一条命令启动就够。
选社区 WebUI 如果： 你有服务器或者 NAS，希望部署后随时随地通过浏览器访问，需要手机也能用，或者看重文件浏览和 Git 集成。
当然，两者不冲突——底层共享同一个 Hermes Agent，可以同时开。
总结一下： 官方 Dashboard 是"管理后台"，社区 WebUI 是"对话客户端"，各有侧重。下一篇还会写 Hermes Desktop——社区做的桌面客户端，又是另一种开箱即用的体验。
项目开源免费 MIT 协议，GitHub 搜 Hermes WebUI 就能找到。
— E N D —
科技智趣坊
分享科技好物，让生活更有趣
项目地址：github.com/nesquena/hermes-webui
10个月宝宝每天需要喝多少奶粉？
