yaoyao

夭夭 Web

夭夭 Web 是一个独立的本地 Web 工作台，通过端口 8800 连接 Hermes Dashboard/Gateway 9119，提供普通聊天、群聊、文件库和产物浏览。通过本项目安装的 LaunchAgent 会持续监督 9119：缺失时自动配置 Dashboard 认证并启动它。

仓库同时归档了夭夭的 Hermes Dashboard 插件，位于 hermes-plugins/yaoyao/dashboard。Web 工作台和该插件是两个独立部署单元：前者运行在 8800，后者由已运行的 Hermes Dashboard 在 9119 加载。

当前发布版本：Git v0.1.0 / 夭夭 Web 0.1.0 / Hermes Dashboard 插件 1.6.1。

需要由自动化 Agent 部署或升级时，请直接使用 Agent 安装手册。其中包含固定版本校验、备份、同步、单一 Dashboard 重载与验证步骤。

安装 Hermes Dashboard 插件

前提是目标机器已安装并可运行 Hermes。插件目录会被 Hermes 以路径加载，因此请保留下面的目录层级，不要只复制其中的 Python 文件或 dist/。

<Hermes 数据目录>/plugins/yaoyao/dashboard/
├── manifest.json
├── plugin_api.py
├── group_plugin_api.py
└── dist/

默认 Hermes 数据目录是 ~/.hermes。从本仓库根目录执行下列命令即可安装或更新插件；首次覆盖已有版本时会先创建带时间戳的备份：

HERMES_HOME="${HERMES_HOME:-$HOME/.hermes}"
PLUGIN_DIR="$HERMES_HOME/plugins/yaoyao/dashboard"

if [ -d "$PLUGIN_DIR" ]; then
  cp -a "$PLUGIN_DIR" "${PLUGIN_DIR}.backup-$(date +%Y%m%d%H%M%S)"
fi

mkdir -p "$PLUGIN_DIR"
rsync -a --delete \
  --exclude '__pycache__/' \
  --exclude '*.py[cod]' \
  --exclude '.pytest_cache/' \
  hermes-plugins/yaoyao/dashboard/ "$PLUGIN_DIR/"

rsync --delete 只会删除目标 dashboard/ 目录中仓库未提供的旧插件文件，不会触及其他 Hermes 插件或数据；如需保留本机额外文件，请先移出该目录或不要使用 --delete。

安装后停止 Dashboard，使运行中的 9119 进程重新加载插件；已安装的夭夭 Web LaunchAgent 会在下一轮检查中自动按其配置重启它：

hermes dashboard --stop
hermes dashboard --no-open

通过状态命令确认 Dashboard 已恢复运行：

hermes dashboard --status

若 Hermes 由 LaunchAgent、服务管理器或其他外部监督器启动，请使用该监督器重启 Dashboard，而不是同时手动执行 hermes dashboard --no-open，以免产生重复监听进程。

插件的归档数据与运行状态仍位于 Hermes 数据目录中，不在此仓库的 hermes-plugins/ 中；升级插件前的备份也不应提交到 Git。

开发

npm install
cp .env.example .env
npm run dev

网络暴露：9119 与 8800 分别控制

默认情况下，两个端口都不开放局域网：Hermes Dashboard 9119 和夭夭 Web 8800 都只监听 127.0.0.1。通过本项目安装的受管服务开启局域网时，两个端口会一起开放。

端口	服务	默认	单独开启局域网
9119	Hermes Dashboard	127.0.0.1	由夭夭 Web 受管服务监督；首次缺失配置时自动创建 admin/admin 登录并启动
8800	夭夭 Web	127.0.0.1	显式设置 HERMES_YAOYAO_HOST=0.0.0.0 后与 9119 一起开放

夭夭 Web 默认上游仍是 http://127.0.0.1:9119。受管服务的局域网开关会同时让它监听局域网地址，并让其启动的 Dashboard 9119 监听局域网地址。

仅在可信局域网中以 HTTP 开放受管服务时，必须同时设置：

HERMES_YAOYAO_HOST=0.0.0.0
HERMES_YAOYAO_ALLOW_INSECURE_LAN=1

生产局域网使用建议同时配置 HERMES_YAOYAO_TLS_CERT 和 HERMES_YAOYAO_TLS_KEY。

受管服务会在 dashboard.basic_auth 未配置时创建用户名 admin、密码 admin 的 scrypt 哈希和随机会话签名 secret。这是已知默认凭据，首次登录后必须立即修改。具体步骤见 Agent 安装手册。Dashboard 的 --insecure 参数不会关闭认证；不要并行安装其他 Dashboard 监督器。

构建与运行

npm run build
npm start

服务管理命令：

node bin/hermes-yaoyao.mjs service install
node bin/hermes-yaoyao.mjs service start
node bin/hermes-yaoyao.mjs service status
node bin/hermes-yaoyao.mjs service stop
node bin/hermes-yaoyao.mjs service uninstall

执行 npm link 后也可以直接使用 hermes-yaoyao 命令。

运行数据默认位于 ~/.hermes-yaoyao。卸载 LaunchAgent 不会删除运行数据。