mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-27 21:03:16 +00:00
175fa9dd62
`site-infra-runbook.md` 是**静态站 / nginx / 证书**的手册，不含 homed 与 waiter —— 两次生产部署（19:45 首次、21:50 修复）因此只存在于提交信息里， 查不到。 ## 内容 **§1 homed** - 硬前置：必须 `-tags=onnxruntime`（普通 build 只有 ~28MB，缺 ONNX Runtime） - ★ **构建参数必须与线上一致**：不要顺手加 `-s -w`。加了产物从 86.8MB 掉到 78MB，8.8MB 的差会让人误判成"构建坏了"，而它只是被 strip 了 - `check` / `deploy` / `rollback` 三条命令与备份位置 - 部署后必核：`multimodal space active: provider=chineseclip` 才是 ONNX 真加载起来的标志，缺它说明已降级但**不报错** - ★ 适配器升级的保护语义（`.bundled` 三种情形的判定表），并记 21:50 那次 实测：手工补过 `stream_index` 的 `openai.lua` 被正确判定为用户修改并保留 - 两次部署的真实数据对照表 **§2 waiter** - 逐台更新、不可并行（两台连同一网关，同时重启会同时断链） - 部署后确认 `device waiter-* online` - 记 2026-09-27 顺手解决的悬案：106 此前无 `online` 而 30 正常，两台配置与 token 完全相同 ⇒ 差异只可能在旧二进制，8月27日那版落在"未 bind 时收到 ping 会关连接"的缺陷窗口 - `device_cmd_allowlist` 的替换语义、生效验证、幂等追加方法 - ★ 明确写**白名单只匹配命令名、不看参数**，`find -delete`/`sed -i` 仍能逃 ⇒ **不要称它为"只读白名单"** **§3 故障排查**：按"消息没反应 / 命令被拒 / 适配器异常 / 告警是否缺陷" 四条线各给命令；特别标注"群聊 not @bot"与"私聊没回"是两件事 **§4 已知未修**：三项目前是已知限制而非疏漏 文中数字均与现场核对：脚本子命令确实存在（`check`/`deploy`/`rollback`）、 生产白名单确为 22 条、两次二进制大小取自实际部署。