跳转到主要内容
Jiewen’blog
升级与维护

日常更新与备份

适用版本:TinyTale 小程序 3.0.0 / TinyTale 配置插件 2.1.2。

更新前先判断修改发生在后台配置、插件还是小程序源码中,三者的生效方式不同。

变更

操作

轮播、公告、站点资料、访问密码

后台保存;重新进入小程序检查

小程序页面、依赖、环境变量、声明

重新编译,在微信平台上传并更新

TinyTale 或依赖插件

备份后在 Halo 更新,核对兼容要求并回归功能

富文本主题、插件、高亮配置

先构建 mp-html,再构建小程序

建议保留的备份

  • 当前工作源码及版本号,包含自己的定制差异。

  • 环境配置与必要密钥的受控副本。

  • 已验证可用的 TinyTale、核心插件和相关依赖安装包。

  • Halo 数据备份,以及附件原文件或对象存储的恢复方案。

  • 本次更新的日期、插件版本、小程序版本与验证结果。

仅保存小程序 dist 目录不足以恢复完整开发工程;仅保存 Halo 数据库也不一定包含外部对象存储中的文件。

更新操作

  1. 阅读本次发布说明,确认 Halo 和依赖插件的最低版本。

  2. 在已有备份的前提下更新服务端,并确认配置接口、登录和内容读取正常。

  3. 合并小程序源码改动,保留锁文件,执行 pnpm install。

  4. 开发预览通过后构建正式包,进行真机验证并上传。

  5. 发布后从正式入口复查文章、图片、登录和需要的发布功能。

更新依赖时避免无目的地把所有版本同时升级。一次改动越集中,出现问题时越容易确认原因。

出现问题时

先记录错误发生在哪个版本和步骤,区分客户端构建、网络配置、接口权限与数据问题。对于仅由小程序源码改动引起的问题,可用已验证的源码重新构建,再按微信平台提供的版本管理流程处理。

后端插件回退前应核对数据兼容性;如果更新改变了存储结构或资源格式,需要结合备份与插件说明恢复。不要覆盖或删除现有数据来“试一下”。

媒体缓存维护

更换图片域名、修复原图地址或调整允许的外部图片域名后,可在插件提供的媒体缓存管理中检查状态并刷新尺寸信息。缓存刷新用于重新解析,不会修复源站链接、改变微信合法域名,也不等于删除或重新上传图片。

日常更新完成后,把实际版本同步到自己的运维记录,避免前端和插件长期混用不匹配的版本。

文档导航