备份与恢复

平台所有者可在左侧“配置 → 备份与恢复”保存 GitHub 连接，按天保存网站源码，或恢复到已备份的源码版本。

首次配置

1. 在 GitHub 创建一个私有仓库。空仓库和已有内容的仓库都可以使用。
2. 创建 Fine-grained personal access token，选择该仓库，为 Repository permissions → Contents 选择 Read and write。
3. 回到 A 站，填写完整仓库地址和 Token，按需勾选“每日自动备份”，选择时间、时区，点击“验证并保存”。
4. 点击“立即备份”。看到成功记录后，进入 GitHub，可在 studio-backups/source.zip 找到源码快照。每次备份对应独立的 Git 提交，原仓库的其他内容不变。

验证连接会检查私有仓库和访问权限。实际写入仍受 GitHub 的 Token 权限和分支保护约束，第一次手动备份可确认写入是否正常。

每日自动备份

默认时间为北京时间 03:00，需勾选开启。由 A 站服务执行，同一天的定时备份只执行一次；服务停机期间不执行，重新运行后补做当日已到时的计划。失败会显示在记录里，可修正连接后手动重试。

替换仓库和 Token

填写新的仓库地址后保存，即可切换目标仓库；填写新 Token 后保存，即可替换凭证。Token 留空表示沿用当前已保存的 Token。旧仓库和旧备份不自动删除。旧仓库的版本要先切回原仓库，并提供有访问权限的 Token，才能恢复。

恢复源码

1. 在版本记录中选择“检查与恢复”。也可点“读取仓库历史”加载仓库最近 100 个备份提交。
2. 查看将更新、增加、删除的文件。平台会校验清单、文件摘要、Python 和 JavaScript 语法，以及依赖和数据库结构兼容性。
3. 输入“恢复源码”确认。已有生产、铺货任务时不能恢复，请先等任务结束。
4. 系统保存恢复前的源码回滚包，暂停写入，应用源码后重启 A 站。健康检查失败时自动回滚；完成后刷新并重新登录。

备份范围

这是源码备份，包含 app、static、scripts、tests、ops 下的允许源码文件及依赖清单。生成的交付文档、示例图片、运行缓存与依赖目录不上传。数据库、商品素材、导出文件、.env、店铺及模型密钥不进入 GitHub 快照，源码恢复也不会覆盖这些业务数据。整机迁移或灾难恢复还需要服务器本地的业务数据备份及独立存储副本。

单份源码上限 30 MB。本地展示最近 500 条操作记录；GitHub 提交历史不会自动清理。恢复前的回滚包保存在服务器私有的 source-backups 目录。

本功能通过隔离仓库接口测试、浏览器检查和隔离服务的实际恢复重启测试。客户自己的 GitHub 连通与写入，需配置仓库后完成首次备份验证。