适用版本:TinyTale 小程序 3.0.0 / TinyTale 配置插件 2.1.2。
更新前先判断修改发生在后台配置、插件还是小程序源码中,三者的生效方式不同。
建议保留的备份
当前工作源码及版本号,包含自己的定制差异。
环境配置与必要密钥的受控副本。
已验证可用的 TinyTale、核心插件和相关依赖安装包。
Halo 数据备份,以及附件原文件或对象存储的恢复方案。
本次更新的日期、插件版本、小程序版本与验证结果。
仅保存小程序 dist 目录不足以恢复完整开发工程;仅保存 Halo 数据库也不一定包含外部对象存储中的文件。
更新操作
阅读本次发布说明,确认 Halo 和依赖插件的最低版本。
在已有备份的前提下更新服务端,并确认配置接口、登录和内容读取正常。
合并小程序源码改动,保留锁文件,执行
pnpm install。开发预览通过后构建正式包,进行真机验证并上传。
发布后从正式入口复查文章、图片、登录和需要的发布功能。
更新依赖时避免无目的地把所有版本同时升级。一次改动越集中,出现问题时越容易确认原因。
出现问题时
先记录错误发生在哪个版本和步骤,区分客户端构建、网络配置、接口权限与数据问题。对于仅由小程序源码改动引起的问题,可用已验证的源码重新构建,再按微信平台提供的版本管理流程处理。
后端插件回退前应核对数据兼容性;如果更新改变了存储结构或资源格式,需要结合备份与插件说明恢复。不要覆盖或删除现有数据来“试一下”。
媒体缓存维护
更换图片域名、修复原图地址或调整允许的外部图片域名后,可在插件提供的媒体缓存管理中检查状态并刷新尺寸信息。缓存刷新用于重新解析,不会修复源站链接、改变微信合法域名,也不等于删除或重新上传图片。
日常更新完成后,把实际版本同步到自己的运维记录,避免前端和插件长期混用不匹配的版本。