Hermes (Agent + Studio WebUI) for 飞牛 NAS (fnOS)
自托管 Hermes 智能体（Agent 网关）+ Hermes Studio Web 控制台，飞牛应用中心可安装的应用包（.fpk）。
这个包包含什么
两个独立容器（安装时由飞牛自动拉取镜像，无需本地编译）：
hermes-agent：nousresearch/hermes-agent:latest，运行 Gateway / 模型调用，内部端口 8642 仅容器网络内部可达，不对外暴露。hermes-webui：ekkoye8888/hermes-web-ui:latest（EKKOLearnAI/hermes-studio 官方预编译镜像），提供 Hermes Studio 网页界面；容器内端口 6060，宿主端口 8787。
两个容器通过 HERMES_GATEWAY_URL 连接：WebUI 关掉了自带的托管网关（HERMES_WEB_UI_MANAGED_GATEWAY=0），统一走独立的 hermes-agent 网关。
数据用两个 Docker 命名卷持久化（hermes-home 代理配置/会话，hermes-webui-data 存 UI 登录令牌等），升级镜像不丢数据。
桌面图标与跳转
manifest 中 service_port = 8787，飞牛会在主界面显示 HERMES 图标，点击即打开 http://<飞牛IP>:8787。
安装
- 飞牛 NAS → 应用中心 → 手动安装 → 上传
hermes.fpk。
- 向导里可填API 访问令牌（可选，对应
AUTH_TOKEN；留空则首次启动自动生成并打印到日志）。
- 确认后应用中心自动拉取两个镜像并启动容器。
- 浏览器访问
http://<飞牛IP>:8787（或从主界面点击 HERMES 图标）。
- Web 默认登录 admin / 123456，首次登录后请修改。首次使用在「模型配置」中添加大模型 Provider 的 API Key（如 DeepSeek / OpenAI）即可对话。
自主升级（在飞牛 Docker 中更新镜像）
两个镜像均使用 :latest 标签，可独立升级：
- 方式一（推荐）：重新上传版本号更大的
hermes.fpk（应用中心 → 该应用 → 更新）。upgrade_callback 自动 docker compose pull 拉取最新镜像并重建容器。
- 方式二：在飞牛 Docker 应用中找到
hermes 项目 / 两个容器，使用「更新镜像 / 拉取最新」分别升级 agent 与 webui。
升级只换镜像、不动命名卷，配置与数据保留。
已知注意点
- hermes-studio 前端以「外部网关模式」接入独立 agent。绝大多数对话 / 模型调用功能正常；个别强依赖本地托管网关的高级特性若有异常，可在
docker-compose.yaml 中删除 HERMES_WEB_UI_MANAGED_GATEWAY/HERMES_WEB_UI_DISABLE_GATEWAY_AUTOSTART 两行让 WebUI 自带网关（此时可移除 hermes-agent 容器）。
- 默认 Web 登录 admin/123456 为弱口令，暴露在公网前请务必修改。
修改 Web 端口（高级）
默认固定 8787（与桌面图标跳转一致）。改端口：编辑 app/docker/docker-compose.yaml 的 "8787:6060" 与 manifest 的 service_port 为同一值，重新 fnpack build 并上传。
