更新系统文档

更新前先做什么

Daiying CMS 的更新系统用于从官方更新源获取 Core 更新信息、下载更新包、校验完整性和签名，并执行升级。更新前不要急着点击执行，先确认当前站点具备回退条件。

• 确认当前 Core 版本和目标版本，记录当前站点可正常访问。
• 进入恢复或备份流程，先创建恢复点，至少保留数据库和 Core 文件的可回滚备份。
• 确认服务器 PHP、扩展、目录权限和磁盘空间正常。
• 确认更新来源是 Daiying CMS 官方更新源，不使用来历不明的压缩包覆盖生产站。

进入后台更新页面

登录后台后进入 /admin/update。这个页面是站长执行在线更新的主要入口，用来检查新版本、查看更新信息、下载更新包并启动升级。

检查新版本

在更新页面先检查是否存在新版本。检查结果应显示目标版本、更新说明或更新包信息。看不懂更新内容时，先不要执行，尤其是跨多个版本升级、涉及数据库迁移或插件兼容时，应先确认备份可用。

下载与完整性校验

更新包下载完成后，系统会进行 SHA256 和签名等完整性校验。只有校验通过的更新包才应继续执行。校验失败通常意味着包损坏、下载不完整或来源不可信，应停止更新并重新检查网络、更新源和服务器环境。

执行更新时的注意事项

• 执行更新期间不要刷新、关闭页面或重启 PHP 服务。
• 不要手工覆盖一半文件后再回到后台继续。
• 如果页面提示正在执行迁移或更新步骤，等待完成并查看最终结果。
• 出现错误时先保留错误信息和日志，不要重复点击导致状态更复杂。

更新完成后检查

更新完成后先确认后台显示的新 Core 版本，再打开首页、文章页和后台常用页面。然后检查 sitemap.xml、插件页面、主题页面、支付或 SEO 等关键模块，确认没有白屏、404 或权限异常。

出现异常怎么办

如果更新后前台或后台异常，优先进入恢复流程，使用更新前的恢复点处理。不要直接删除数据库或覆盖未知文件。恢复后再根据日志判断是环境、权限、插件兼容还是更新包问题。

不建议的更新方式

不建议在生产站用未签名压缩包直接覆盖 Core，也不建议跳过备份后执行跨版本更新。正式站点应该通过后台更新入口和官方更新包完成升级，并把每次更新结果记录下来。