feat: 添加 PyArmor 代码混淆支持
- 新增 --obfuscate 命令行参数,支持使用 PyArmor 混淆代码 - 通过 uv run --with pyarmor 按需加载 PyArmor,不污染主机环境 - 添加友好的错误提示,引导用户正确使用 --with pyarmor - 保持非混淆模式完全向后兼容 - 更新 skill-packaging spec,新增混淆相关需求
This commit is contained in:
@@ -52,3 +52,50 @@
|
||||
#### Scenario: 显示构建信息
|
||||
- **WHEN** 构建成功完成
|
||||
- **THEN** 控制台输出版本号和构建文件清单
|
||||
|
||||
### Requirement: --obfuscate 参数支持
|
||||
系统 SHALL 支持 `--obfuscate` 命令行参数,用于启用代码混淆功能。
|
||||
|
||||
#### Scenario: 使用 --obfuscate 参数
|
||||
- **WHEN** 用户执行 `uv run --with pyarmor python build.py --obfuscate`
|
||||
- **THEN** 系统使用 PyArmor 对 scripts 目录代码进行混淆
|
||||
|
||||
#### Scenario: 不使用 --obfuscate 参数
|
||||
- **WHEN** 用户执行 `uv run python build.py`(不带 --obfuscate)
|
||||
- **THEN** 系统执行原有的复制行为,不进行混淆
|
||||
|
||||
### Requirement: PyArmor 混淆执行
|
||||
系统 SHALL 在 `--obfuscate` 模式下调用 PyArmor 工具对 scripts 目录进行混淆。
|
||||
|
||||
#### Scenario: PyArmor 成功执行
|
||||
- **WHEN** 启用 --obfuscate 且 PyArmor 可用
|
||||
- **THEN** 系统执行 pyarmor gen --recursive 命令
|
||||
|
||||
#### Scenario: 混淆后文件输出
|
||||
- **WHEN** PyArmor 混淆完成
|
||||
- **THEN** build/scripts/ 目录包含混淆后的文件
|
||||
|
||||
#### Scenario: pyarmor_runtime 包含
|
||||
- **WHEN** PyArmor 混淆完成
|
||||
- **THEN** build/scripts/ 目录包含 pyarmor_runtime_xxxxxx 子目录
|
||||
|
||||
### Requirement: PyArmor 未安装友好提示
|
||||
系统 SHALL 在 PyArmor 未安装时提供清晰的错误提示,引导用户正确使用 `uv run --with pyarmor`。
|
||||
|
||||
#### Scenario: PyArmor ImportError
|
||||
- **WHEN** 启用 --obfuscate 但未通过 --with pyarmor 加载
|
||||
- **THEN** 系统显示友好错误信息,提示正确命令
|
||||
|
||||
### Requirement: SKILL.md 保持明文
|
||||
系统 SHALL 在混淆模式下仍然将 SKILL.md 作为明文文件复制,不进行混淆。
|
||||
|
||||
#### Scenario: SKILL.md 保持明文
|
||||
- **WHEN** 启用 --obfuscate 执行构建
|
||||
- **THEN** build/SKILL.md 文件为明文,内容与原文件一致
|
||||
|
||||
### Requirement: 混淆错误处理
|
||||
系统 SHALL 在 PyArmor 混淆失败时捕获错误并显示详细信息。
|
||||
|
||||
#### Scenario: PyArmor 命令失败
|
||||
- **WHEN** pyarmor 命令执行返回非零退出码
|
||||
- **THEN** 系统显示退出码、标准输出和错误输出信息
|
||||
|
||||
Reference in New Issue
Block a user