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
在通勤路上用手机 Hermes WebUI 追问了一句，回到工位打开电脑，刚才那轮对话还停在原地等你的下一条指令——不用重新登录，也不用重传文件。Hermes WebUI 的多设备一致性，靠的不是"同步"，而是让所有设备连到同一台服务器、看同一份状态。
没有同步引擎，多设备为何还能保持一致
传统工具里，"多设备"往往意味着三份各自更新、偶尔对不上的状态，合并起来挺闹心。Hermes WebUI 把思路反过来：它只有一台服务器，存一份会话、一套工作区、一个 profile；你手机上的浏览器和电脑上的浏览器，连的其实是同一个进程、读的是同一份数据。所以这里没有"谁覆盖谁"的合并难题——手机上改完文件，回到电脑前直接继续，就像换了个窗口看同一间屋子。
三步跑起来：装好、连上、上锁
第一步是在服务器上把 WebUI 跑起来。克隆仓库后执行引导脚本，它会自动装依赖、起服务并等/health通过，再进入首跑引导：
git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui && python3 bootstrap.py第二步是把入口开到其它设备。WebUI 默认只绑127.0.0.1（仅本机回环），所以远程设备走隧道：电脑端一条 SSH 隧道就能把本地端口映射到服务器，手机装好 Tailscale 后直接访问同一个内网地址。
ssh -N -L 8787:127.0.0.1:8787 user@your.server.com第三步是给这台唯一的入口加把锁。因为多个设备共用同一份状态，打开密码（或 Passkey/OIDC）后，任何设备都要先验证身份才能进门，数据才稳。Tailscale 手机方案也建议一并启用密码保护：
HERMES_WEBUI_PASSWORD=your-secret ./start.sh tailscale serve --bg 8787背后是怎么跑的：一份数据，多个窗口
把这台服务器想成公司里唯一的账本，每台设备都是看账本的窗口，而不是各自记账再对账。技术上，会话存在服务器本地（内存 LRU + 磁盘 sidecar JSON），流式回复靠 SSE 推送、网络抖断会自动重连；可选再开sync_to_insights，把 WebUI 的用量回写到 agent 的state.db（见 同步桥源码 与 SSE 流式协议）。
按需调一调：把这份状态用到极致
- 如果你要在统计里看到 WebUI 的用量：在设置里打开
sync_to_insights，同步桥 会把 token 与标题回写 agent 的state.db，默认是关的，回写失败也不影响聊天。 - 如果你要隧道断网也不丢流：SSE 的自动重连是内建的，细节见 docs/sse-streams.md；长期更稳的做法，是把手机入口换成 Tailscale 而非临时隧道。
- 如果你要多个身份各管一摊：用 profile 隔离会话、记忆与配置，切换不重启服务器（见 api/profiles.py）。
- 如果你怕误操作想留后路：会话可导出 Markdown/JSON，也能生成只读分享链接，误改后可用检查点回滚（见 api/rollback.py）。
踩坑速查：常见报错怎么解
接入多设备时，多数问题都出在"网络到那台唯一服务器"这一环。对照下面这张表先自查：
| 问题现象 | 可能原因 | 解决办法 |
|---|---|---|
| 手机或其它设备打不开 | WebUI 默认只绑127.0.0.1（仅本机） | 用 SSH 隧道或 Tailscale 连到同一台服务器 |
| 隧道一抖，回复或流就卡住 | SSH 隧道网络抖动断开 | 等 SSE 自动重连恢复；长期可改用 Tailscale |
| 更新后 PWA/主屏应用白屏 | 反向代理 basic auth 拦了sw.js更新 | 改用 WebUI 自带的密码登录 |
报AIAgent not available | agent 不在运行 Python 的sys.path | 用同一 Pythonpip install -e .，或设HERMES_WEBUI_AGENT_DIR |
更新 agent 后报409 agent_runtime_stale | WebUI 进程未随之重启 | ./ctl.sh restart重启后端 |
更完整的诊断流程（症状→原因→命令→修法）都在 排错手册 里，按条目查即可。
下一步
给 Tailscale Serve 配好 HTTPS MagicDNS 地址，把入口固化到手机主屏当 App 用；想深挖远程接入与 SSH 隧道的细节，读 远程访问文档。
【免费下载链接】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），仅供参考
