docs: initialize release-only archive and source-code disclaimer

2026-09-22 11:19:40 +08:00
commit 92634afb07
1 changed files with 32 additions and 0 deletions
@@ -0,0 +1,32 @@
+# YidaConnector 发布包归档
+
+这里仅归档 [源仓库](https://git.bunnyruihan.com:16666/ruihan/yidaconnector) 已发布 Release 的说明和上传附件，不提供业务源码镜像。
+
+**请从 Releases 下载 `yidaconnector-*.zip` 安装包。Gitea 自动生成的 Source Code ZIP/TAR 是本归档仓库的内容，不是 YidaConnector 源码。**
+
+版本标签指向本仓库固定的归档说明提交；每个 Release 说明记录源站链接、源标签提交及附件 SHA-256。
+
+每日北京时间 03:00（UTC 19:00）由 Gitea Actions 调度，现有 runner 执行。首次部署通过单版本、全量和重复运行验收后才启用定时。可在 Actions 手动运行、选择 tag 或 dry_run。
+
+## 同步规则
+
+- 分页同步已发布版本，包括预发布版本，跳过草稿。
+- 校验 HTTP 响应、文件大小、ZIP CRC 和 SHA-256；每日完整复核附件。
+- 新 Release 先创建草稿，附件校验通过后公开。
+- 同名附件变更时先上传临时副本并回读验证，再重命名；旧副本保留为 `.backup-<id>-<原名>`。
+- 旧站删除的版本和附件在本仓库保留。
+- 只更新带同步标记的 Release，不覆盖人工创建的同名版本。
+- 修改源站发布说明会同步，原始发布时间以说明记录，新站创建时间不伪造。
+- 任务仅由 schedule/workflow_dispatch 触发，不执行源仓库脚本。
+
+## 运维
+
+`SOURCE_GITEA_TOKEN` 为源站读取凭据，放在仓库 Actions Secrets；目标写入使用任务自带 `GITEA_TOKEN`。不得将凭据提交到 Git。
+
+权限需允许本仓库 `contents: write`（创建标签、发布和附件），不需要站点管理员权限。仅信任的维护者可修改同步脚本和工作流。
+
+查看 Actions 运行日志和 `release-sync-report` artifact 获取对账结果。暂停同步可禁用工作流；恢复后手动运行可补齐错过的版本。失败后直接重跑，程序会核对已经完成的写入，不依赖 runner 本地状态。
+
+默认单附件上限 512 MiB、ZIP 展开大小校验上限 2 GiB、单次任务 30 分钟。多步骤附件改名不是事务；中断可能暂时留下 `.sync-*` 或 `.backup-*` 名称，重跑后恢复正式名称，旧副本不会删除。
+
+本地测试：`python3 -m unittest discover -s tests -v`。