docs: codify free PyArmor Trial packaging guidance
All checks were successful
技能自动化发布 / release (push) Successful in 14s

This commit is contained in:
2026-10-13 15:55:44 +08:00
parent 1e2f94dd10
commit de127d7e71
8 changed files with 45 additions and 9 deletions

View File

@@ -140,6 +140,8 @@ RPA 录屏成片(`RpaVideoSession`)、ffmpeg 路径、背景音乐探测均
release workflow 加密 `scripts/` 源码时,可能运行在 PyArmor 免费/试用模式:
- `scripts/**/*.py` 单文件必须 **< 1000 行**(`>= 1000` 可能在 CI 失败);推荐 **< 900 行**。
- 接近上限时拆分到 `cli/`、`service/`、`db/`、`util/`,不要把 RPA 主流程、选择器、DB、CLI 堆进单文件。
- `scripts/**/*.py` 单文件必须 **< 1000 行**(`>= 1000` 可能在 CI 失败);推荐 **< 900 行**。这是预防性硬门槛,不代表低于该行数就一定能被 Trial 加密。
- 模块应按职责拆分到 `cli/`、`service/`、`db/`、`util/`;不要把 RPA 主流程、选择器、DB、CLI 堆进单文件。发现某个文件在免费 Trial 加密时报错时,按报错定位该文件并继续拆分其职责,重新走实际加密验证;不要通过猜测统一的源码字节数阈值代替验证。
- 拆分已有模块时,尽量保留原模块作为兼容门面(re-export / 委托到新模块),避免破坏现有 import 路径;先跑测试,再发布验证。
- 发布验收以 Gitea release workflow 中实际的 PyArmor Trial 加密结果为准:确认全部 `scripts/**/*.py` 均成功加密、加密包成功生成/上传且 job 成功。若 PyArmor 步骤失败,不得把版本视为已发布成功;按日志中的失败文件拆分、升补丁版本并重新 release。
- 此行数限制**仅适用于** `scripts/**/*.py`;不限制 README 等文档行数,也不把 examples 里的 HTML/README 纳入 PyArmor 行数约束。