33 lines
2.3 KiB
Markdown
33 lines
2.3 KiB
Markdown
# 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`。
|