从 2.x 升级到 3.x

备份当前源码、环境文件、插件安装包、Halo 数据及附件存储配置。单独记录自己改过的页面、样式、站点文案、声明和图标。包含密钥的备份保存在受控位置，不提交到公开仓库。

满足 Halo 2.25.0 及以上和当前依赖要求，安装配套 TinyTale 配置插件 2.1.2，检查核心插件绑定和域名授权。旧版 2.0.0 配置插件不包含当前完整会话登录和受限阅读接口。

随后确认 AppID、AppSecret、存储策略和页面配置仍正确。对于已有受限文章的站点，升级前后都要检查 Tools 集成，避免仅验证首页就判定升级完成。

同时核对 .env.development 与 .env.production。不要把旧文件中不再使用的变量误认为当前仍生效。

用现有 Halo 账号登录，在真实微信环境完成绑定。旧管理员 OpenID 不等于新账号已绑定，也不会自动赋予发布权限。为需要发布的用户配置 TinyTale 管理权限。

普通用户的微信自动注册受 Halo 注册策略约束；站点要求邮箱验证时，采用已有账号登录与绑定流程。

重点查看代码块、表格、图片、复杂文章嵌入、评论弹层、图库布局和瞬间配图。旧网页专用脚本或主题交互需要单独适配，不能以桌面浏览器效果代替小程序验证。

迁移站点名称、社交入口、主题和声明页面后，重新构建并按发布检查表做真机验证。旧版文档继续保留供历史版本使用，3.x 安装以本文档为准。