WechatOnCloud Files

⬆️ 升级方式（重要）

1. 面板「检查更新」把面板升到 1.5.2（在 .env 里固定了 WOC_VERSION 的，改成 1.5.2 后执行 docker compose pull && docker compose up -d）；
2. 再点「一键升级全部实例」：QQ 下载的修复在实例镜像里，只更新面板不会生效。

升级实例会保留全部数据（登录状态、聊天记录、设备标识）。之前 QQ 下载失败的实例，升级后回到实例卡片重新点「下载安装」即可。

🐛 修复

QQ 下载不了，提示 HTTP 403（#153）

1.5.1 里所有 QQ 实例都下载不了，国内网络也一样。原因是腾讯给 QQ 的下载地址加了签名校验，不带签名的请求一律 403，跟网络在哪无关。1.5.1 的提示说「只对中国大陆网络开放」是判断错了，关代理、换直连都不会有用。

现在安装时会先向腾讯官网换取带签名的下载链接再下载；中途断了会重新签名、从断点续传。实测境外网络也能正常下载、安装，并启动到扫码登录界面。感谢 @SmartElec 定位并提交修复（#156）。

无感输入：拼音上屏后紧接着按空格，空格跑到文字前面（#155）

打「你好」后连按空格，远端收到的是「 你好」。现在中文还在送出时按下的空格，会排在它后面按顺序送出；没有中文在送出时，空格照旧直接发送，不加延迟。底部输入条（转发模式）原本就没有这个问题。

🔧 改进

• 诊断包多了「桌面服务」一段：每个实例附上桌面入口（nginx）和远程桌面（KasmVNC）有没有在监听，以及 nginx 的错误日志。遇到「正在连接桌面」「桌面长时间未就绪」时，导出的诊断包能直接看出卡在哪里（#107、#114）。
• 自己构建镜像的 scripts/build-local.sh：镜像名称改成跟 docker-compose.yml 用同一个 WOC_IMAGE_PREFIX。之前构建完直接 docker compose up -d 会去拉官方镜像，而不是用刚构建好的。

↩️ 回滚

出现问题时可回到 1.5.1：在 .env 里设 WOC_VERSION=1.5.1，执行 docker compose up -d，再在面板里「一键升级全部实例」（实例切回 1.5.1 镜像，数据保留）。已经装好的 QQ 在 1.5.1 下照常运行，只是在 1.5.1 下重新下载 / 更新 QQ 会再遇到 403。

镜像：ghcr.io/gloridust/{woc-panel,wechat-on-cloud}:1.5.2、gloridust/{woc-panel,wechat-on-cloud}:1.5.2（amd64 + arm64）。