{"name":"attempt_completion","arguments":{"result":"建议采用“宿主机原生定时器＋摘要固定部署＋持久事务状态＋本地镜像回滚”，不引入更新容器。本方案条件可行：跨公网检查远端摘要无法保证每次亚秒级完成；当前单实例网关重建也不能保证零停机或在途请求无损。\n\n- 本次交付仅为会话草案与实现契约，没有写入文件、运行测试或操作两台异地 VPS。\n- 对于正常运行的宿主机与 Docker，设计目标是升级失败自动回滚；宿主机断电、Docker 不可用或回滚镜像自身不能启动时，必须失败告警，不能承诺必然自愈。\n\n## 1. 源码核对与必要边界\n\n- 发布工作流实际接受 v主版本.次版本，例如 v3.12；发布 latest、3.12、v3.12、提交短 SHA 四类标签，没有自动维护名为 v3.x 的系列别名。配置四种架构，但这只是工作流定义，不证明具体发布已成功：[发布工作流](.github/workflows/build_docker.yml:19)。\n- 当前网关服务使用源码构建，绑定本机 8080，保留只读配置目录；邮箱采用内存存储。因此邮箱容器不重启是必要保护条件：[部署配置](docker-compose.yml:1)。\n- 发布镜像运行的是根入口；启动依赖本地模型注册表配置，镜像本身没有复制该配置目录。远端仍需交付配置文件，不能只有镜像：[镜像定义](Dockerfile:13)、[启动入口](main.go:21)。\n- 当前根入口使用的模型目录处理器读取注册表快照，不发起真实聊天请求；健康端点只返回静态存活信息。两者都不能证明上游账号预热或真实聊天可用：[模型目录处理器](internal/api/models.go:23)、[健康路由](internal/api/chat.go:2078)。不要混用另一套处理器的鉴权规则。\n- 应用收到终止信号后取消服务上下文，HTTP 关闭窗口为五秒。因此延长容器停止宽限期不能单独保证长流式请求完成：[关闭逻辑](main.go:233)。\n\n必要非目标：不修改邮箱、不同步运行中账号状态、不升级依赖、不引入远端源码、不修改本地开发构建方式、不承诺严格同时切换或真正零停机。真正无损切换需要另行设计双实例、入口切换和连接排空，不属于本草案。\n\n## 2. 更新脚本的实现契约\n\n拟交付入口为 [宿主机更新脚本](scripts/auto-update.sh)，目前未创建。宿主机依赖 Bash、Docker Engine、Compose 插件、curl、jq、flock，以及用于只读取镜像清单的原生 Skopeo；具体发行版和工具版本仍需工程阶段核验。\n\n脚本由受保护的宿主机账户运行，直接使用本机 Docker；不把 Docker 套接字或仓库凭据挂进任何容器。这个账户仍具有 Docker 管理权限，不能把“不挂载套接字”描述成消除了宿主机管理员权限风险。\n\n### 摘要与状态模型\n\n- 跟踪标签用于发现版本，默认跟踪 latest；实际部署始终固定为仓库地址加摘要。Compose 支持按摘要指定镜像。[1](cite:1)\n- 分开保存多架构索引摘要、平台清单摘要、Docker 本地镜像 ID；禁止把这三种值直接互相比对。\n- 保存当前已验收镜像、上一可用镜像、本次事务、失败摘要隔离记录。事务包含新旧引用、本地镜像 ID、旧容器 ID、配置指纹和操作阶段。\n- 更新前，从真实运行容器取得旧镜像 ID，赋予专用本地保留标签，并验证旧服务健康。回滚不依赖重新联网拉取旧版本。\n- 状态采用严格解析的数据格式，不执行其中的文本；同目录临时写入、原子替换，并对关键状态执行文件及目录持久化。单纯重命名不能当成断电持久性保证。\n\n### 执行顺序\n\n1. 非阻塞获取固定文件锁；未取得锁静默退出。更新、恢复、初始化和清理共用这把锁。\n2. 优先处理未完成事务，再查询远端。核验固定 Compose 项目名、唯一网关容器、配置指纹和邮箱容器身份；发现人工变更则停止，不擅自接管。\n3. 只获取远端清单，计算同一种摘要；不先拉镜像层。网络、鉴权或解析失败时保留当前服务，记录失败，禁止把空摘要当新版本。\n4. 摘要与已验收摘要一致时，脚本不拉取、不重建、不写更新日志。失败隔离中的摘要同样不反复部署，直到新摘要出现或管理员解除隔离。\n5. 拉取固定摘要，确认本机平台镜像可用及磁盘余量；此时旧网关继续运行。拉取失败不能触碰运行容器。\n6. 保留旧镜像及兼容配置，持久记录“准备切换”；使用只针对网关的命令重建。\n7. 验证新容器镜像身份、运行状态及应用探针，成功后才提交“当前已验收版本”。\n8. 重建失败或健康窗口结束仍不合格，进入回滚；使用本地旧镜像标签和原配置，仅重建网关，再执行同样的健康验证。\n9. 回滚成功后恢复持久部署引用、隔离失败摘要并记录事件；回滚失败则保留恢复材料、返回失败并告警，不循环重启。\n\n关键调用草案如下；它们不是完整、已验收的安装脚本，事务持久化、身份校验及恢复逻辑必须按上述契约补齐：\n\n```bash\n# 参数来自经过校验、不可由普通账户修改的配置。\nexec 9>\"$LOCK_FILE\"\nflock -n 9 || exit 0\n\n# 仅读取清单；须先确认目标 Skopeo 的认证文件及原始清单行为。\ntimeout --kill-after=2s 15s \\\n skopeo inspect --authfile \"$DOCKER_CONFIG/config.json\" \\\n --raw \"docker://$TRACK_IMAGE\" \\\n \"$MANIFEST_TMP\"\n# 必须先检查退出状态，再计算摘要；禁止处理失败留下的部分输出。\n\n# NEW_REF 为经过校验的 ghcr.io/仓库@sha256:摘要。\ntimeout --kill-after=5s 600s \\\n docker pull \"$NEW_REF\"

{"name":"attempt_completion","arguments":{"result":"建议采用“宿主机原生定时器＋摘要固定部署＋持久事务状态＋本地镜像回滚”，不引入更新容器。本方案条件可行：跨公网检查远端摘要无法保证每次亚秒级完成；当前单实例网关重建也不能保证零停机或在途请求无损。\n\n- 本次交付仅为会话草案与实现契约，没有写入文件、运行测试或操作两台异地 VPS。\n- 对于正常运行的宿主机与 Docker，设计目标是升级失败自动回滚；宿主机断电、Docker 不可用或回滚镜像自身不能启动时，必须失败告警，不能承诺必然自愈。\n\n## 1. 源码核对与必要边界\n\n- 发布工作流实际接受 v主版本.次版本，例如 v3.12；发布 latest、3.12、v3.12、提交短 SHA 四类标签，没有自动维护名为 v3.x 的系列别名。配置四种架构，但这只是工作流定义，不证明具体发布已成功：[发布工作流](.github/workflows/build_docker.yml:19)。\n- 当前网关服务使用源码构建，绑定本机 8080，保留只读配置目录；邮箱采用内存存储。因此邮箱容器不重启是必要保护条件：[部署配置](docker-compose.yml:1)。\n- 发布镜像运行的是根入口；启动依赖本地模型注册表配置，镜像本身没有复制该配置目录。远端仍需交付配置文件，不能只有镜像：[镜像定义](Dockerfile:13)、[启动入口](main.go:21)。\n- 当前根入口使用的模型目录处理器读取注册表快照，不发起真实聊天请求；健康端点只返回静态存活信息。两者都不能证明上游账号预热或真实聊天可用：[模型目录处理器](internal/api/models.go:23)、[健康路由](internal/api/chat.go:2078)。不要混用另一套处理器的鉴权规则。\n- 应用收到终止信号后取消服务上下文，HTTP 关闭窗口为五秒。因此延长容器停止宽限期不能单独保证长流式请求完成：[关闭逻辑](main.go:233)。\n\n必要非目标：不修改邮箱、不同步运行中账号状态、不升级依赖、不引入远端源码、不修改本地开发构建方式、不承诺严格同时切换或真正零停机。真正无损切换需要另行设计双实例、入口切换和连接排空，不属于本草案。\n\n## 2. 更新脚本的实现契约\n\n拟交付入口为 [宿主机更新脚本](scripts/auto-update.sh)，目前未创建。宿主机依赖 Bash、Docker Engine、Compose 插件、curl、jq、flock，以及用于只读取镜像清单的原生 Skopeo；具体发行版和工具版本仍需工程阶段核验。\n\n脚本由受保护的宿主机账户运行，直接使用本机 Docker；不把 Docker 套接字或仓库凭据挂进任何容器。这个账户仍具有 Docker 管理权限，不能把“不挂载套接字”描述成消除了宿主机管理员权限风险。\n\n### 摘要与状态模型\n\n- 跟踪标签用于发现版本，默认跟踪 latest；实际部署始终固定为仓库地址加摘要。Compose 支持按摘要指定镜像。[1](cite:1)\n- 分开保存多架构索引摘要、平台清单摘要、Docker 本地镜像 ID；禁止把这三种值直接互相比对。\n- 保存当前已验收镜像、上一可用镜像、本次事务、失败摘要隔离记录。事务包含新旧引用、本地镜像 ID、旧容器 ID、配置指纹和操作阶段。\n- 更新前，从真实运行容器取得旧镜像 ID，赋予专用本地保留标签，并验证旧服务健康。回滚不依赖重新联网拉取旧版本。\n- 状态采用严格解析的数据格式，不执行其中的文本；同目录临时写入、原子替换，并对关键状态执行文件及目录持久化。单纯重命名不能当成断电持久性保证。\n\n### 执行顺序\n\n1. 非阻塞获取固定文件锁；未取得锁静默退出。更新、恢复、初始化和清理共用这把锁。\n2. 优先处理未完成事务，再查询远端。核验固定 Compose 项目名、唯一网关容器、配置指纹和邮箱容器身份；发现人工变更则停止，不擅自接管。\n3. 只获取远端清单，计算同一种摘要；不先拉镜像层。网络、鉴权或解析失败时保留当前服务，记录失败，禁止把空摘要当新版本。\n4. 摘要与已验收摘要一致时，脚本不拉取、不重建、不写更新日志。失败隔离中的摘要同样不反复部署，直到新摘要出现或管理员解除隔离。\n5. 拉取固定摘要，确认本机平台镜像可用及磁盘余量；此时旧网关继续运行。拉取失败不能触碰运行容器。\n6. 保留旧镜像及兼容配置，持久记录“准备切换”；使用只针对网关的命令重建。\n7. 验证新容器镜像身份、运行状态及应用探针，成功后才提交“当前已验收版本”。\n8. 重建失败或健康窗口结束仍不合格，进入回滚；使用本地旧镜像标签和原配置，仅重建网关，再执行同样的健康验证。\n9. 回滚成功后恢复持久部署引用、隔离失败摘要并记录事件；回滚失败则保留恢复材料、返回失败并告警，不循环重启。\n\n关键调用草案如下；它们不是完整、已验收的安装脚本，事务持久化、身份校验及恢复逻辑必须按上述契约补齐：\n\n```bash\n# 参数来自经过校验、不可由普通账户修改的配置。\nexec 9>\"$LOCK_FILE\"\nflock -n 9 || exit 0\n\n# 仅读取清单；须先确认目标 Skopeo 的认证文件及原始清单行为。\ntimeout --kill-after=2s 15s \\\n skopeo inspect --authfile \"$DOCKER_CONFIG/config.json\" \\\n --raw \"docker://$TRACK_IMAGE\" \\\n \"$MANIFEST_TMP\"\n# 必须先检查退出状态，再计算摘要；禁止处理失败留下的部分输出。\n\n# NEW_REF 为经过校验的 ghcr.io/仓库@sha256:摘要。\ntimeout --kill-after=5s 600s \\\n docker pull \"$NEW_REF\"