# 部署夭夭 Web

## 前提

- Node.js 24。
- 可访问的 Hermes Dashboard/Gateway（通常为 9119），支持会话创建、恢复、提示词提交、附件及审批 RPC。
- 不需要 Yaoyao 插件，不会修改外部 Hermes 的插件目录或重启外部 Hermes。

## 源码安装

在仓库执行 `npm ci`、`npm run build`，然后执行 `npm start`。Web 默认监听 `127.0.0.1:15300`。

上游地址由 `HERMES_YAOYAO_UPSTREAM` 配置。远端凭据在 Web 系统设置中保存。需要环境配置时使用 `HERMES_YAOYAO_UPSTREAM_USERNAME` 和 `HERMES_YAOYAO_UPSTREAM_PASSWORD`，不要把凭据嵌入 URL。

首次打开 Web 时创建管理员账号和至少 8 位的密码。服务不会生成固定的默认账号或密码；iOS 使用 Web 账号或手机登录二维码。

## 局域网与容器

局域网部署可设置 `HERMES_YAOYAO_HOST=0.0.0.0` 和 `HERMES_YAOYAO_ALLOW_INSECURE_LAN=1`，并在 `HERMES_YAOYAO_ALLOWED_HOSTS` 中列入访问地址。公网部署配置 TLS。

容器保持 `HERMES_YAOYAO_SUPERVISE_DASHBOARD=0`，使用外部 Hermes 上游。数据目录 `/var/lib/hermes-yaoyao` 必须持久化；无需挂载 Hermes 文件系统或 Docker socket。

## 验收

- `/healthz` 检查 Web 自身；`/readyz` 检查 Hermes 上游。
- 登录后 `/api/app/capabilities` 声明新聊天功能。
- 创建角色、发送消息、上传并下载附件、创建固定成员群聊。
- 用同一账号在 iOS 和 Web 查看相同历史；另一账号看不到这些聊天。
- 全过程不应访问 `/api/plugins/yaoyao/`、插件安装或插件升级接口。

## 数据和发布

备份整个 `HERMES_YAOYAO_HOME`，包含 SQLite、上传与归档文件、用户凭据和密钥。正常的数据库持久化不依赖旧插件存储维护工具。

本次升级不迁移旧数据。旧插件及数据文件保留在原处，不自动卸载或删除。首次切换整体部署新 Web 和 iOS；此后只升级 Web 自身版本。