Hermes Agent TUI 第一次启动慢,多半是在安装或重建 ui-tui/node_modules,这属于正常的一次性成本。后续如果每次都慢,就要检查 Node 依赖目录是否可写、版本更新是否频繁触发重建、或者你是否在只读/临时目录里运行。
正常慢和异常慢的区别
官方 TUI 文档说明,首次启动会安装 Node 依赖,更新后如果源码比构建产物新,也会自动重建。正常情况下等一次就好;异常情况是每次打开都重新安装,或者一直卡在启动阶段不进入界面。
处理顺序
- 运行
hermes doctor,先确认 Node.js 和依赖状态。 - 检查 Hermes 安装目录是否有写权限,尤其是 Docker、Nix、只读系统包环境。
- 如果发行版提供预构建 TUI,可设置
HERMES_TUI_DIR指向包含dist/entry.js和node_modules的目录。 - 临时需要工作时,用 classic CLI:
hermes。
不要在启动慢时反复 Ctrl+C 重开,这可能让依赖安装半途而废。先让它完整跑完一次,再判断是否真的异常。