nan
f48bbb3d05
- Implement tests for image layer functionality including alpha curve and depth layer behavior. - Create tests for image plane evaluation and modifier input handling. - Add tests to verify the saved asset inventory and its persistence. - Introduce tests for the documentation command to ensure correct project version deployment. - Validate the extension manifest structure and required permissions. - Develop tests for the packaging process, ensuring correct platform handling and dependency management. - Enhance image depth plane group functionality with new split threshold input and surface processing.
2.7 KiB
2.7 KiB
开发与发布
仓库使用 CPython 3.11 与 bpy==4.5.3 测试 Blender 代码；AI Server 使用 runtime.py 声明的独立 Python 3.12 Environment。
uv sync
uv run pytest
测试组织
| 测试范围 | 文件 |
|---|---|
| 扩展注册、设置、安装和 Job 交互 | test_addon_registration.py、test_preferences.py、test_ai_setup.py、test_job_operator.py |
| Frame、Mask、Rectify、Plane、Cutout | 对应 test_*_tool.py、test_*_operators.py 与对象、投影、网格测试 |
| 图像身份、Alpha、材质与 Undo | 图像编辑集成、共享替换、材质适配与 Undo 测试 |
| Server | test_job_server.py、test_server_jobs.py、test_media_input.py、test_geometry_artifacts.py |
| 模型 | test_model_manager.py、目录、下载、推理与各 ONNX 模型测试 |
| 节点资产 | 布局检查、Depth Plane 模式、深度分离与 Cutout 体积求值 |
| 工具与包协议 | 扩展 Manifest、打包、模型同步、节点启动器和文档命令测试 |
Blender Stub 共用 blender_test_support.py；Server 和实际 Blender 几何 fixture 按使用范围存放在对应 support 模块。测试命名描述功能、触发条件与可观察结果。
发布命令
| 命令 | 职责 |
|---|---|
uv run pack |
生成 Windows、macOS arm64、Linux 扩展包 |
uv run pack --prepare |
为本机同步扩展 wheel 与 Manifest |
uv run build_nodes |
构建、验证节点资产并运行测试 |
uv run sync_models |
准备、校验并上传模型声明的文件 |
uv run docs -dev |
本地预览文档 |
uv run docs |
通过 Mike 发布项目版本并更新 latest |
tools/pack.py 从 pyproject.toml 读取依赖，按平台与 Blender Python 版本解析 wheel，使用 Blender 提供的 NumPy。产物命名为 AnyImage.v<version>.<platform>.zip，写入 dist/。本地 BlendJob wheel 内容变化后运行 uv lock --refresh，并核对锁文件、Manifest 与打包测试。
tools/models/cli.py 根据模型目录选择上游 ONNX 或本地导出流程；tools/models/exports.py 处理对应 PyTorch 权重导出。文件校验依据声明大小和 SHA-256，上传使用逐文件复制。--prepare-only 用于本地准备。
CI 与文档导航
flowchart TD
A[main push、Pull Request 或手动触发] --> B[test.yml 运行测试]
C[v 前缀 Tag] --> D[build.yml 测试、打包并发布 ZIP]
E[main 文档路径变化或手动触发] --> F[docs.yml 构建站点并部署 Cloudflare]
站点导航由 mkdocs.yml 显式维护，页面移动时同步导航和相对链接。节点资产的脚本职责及检查入口见节点资产。