nan
938d95db0f
- Implemented a preview tool for rectifying images with interactive aspect controls in `preview.py`. - Added tests for depth metadata loading to ensure consistent schema usage in `test_depth_metadata.py`. - Developed comprehensive tests for cutout calibration processes in `test_cutout_calibration.py`, including stability checks and depth calibration. - Created tests for frame compositing operations in `test_frame_compositing.py`, ensuring correct handling of depth and transparency. - Introduced material slot inheritance functionality in `material_slots.py` to manage geometry material assignments. - Built shared shader nodes for material processing in `shader.py`, including roughness and bump mapping setups.
2.6 KiB
2.6 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 模型测试 |
| 节点资产 | 布局前后功能等价、深度分离与 Cutout 体积求值 |
| 工具与包协议 | 扩展 Manifest、打包、模型同步与节点启动器 |
Blender Stub 共用 tests/support/blender.py；Server 和实际 Blender 几何 fixture 按使用范围存放在对应 support 模块。测试命名描述功能、触发条件与可观察结果。
发布命令
| 命令 | 职责 |
|---|---|
uv run pack |
生成 Windows、macOS arm64、Linux 扩展包 |
uv run pack --prepare |
为本机同步扩展 wheel 与 Manifest |
uv run node-group build |
构建、验证节点资产并运行测试 |
uv run model sync |
准备、校验并上传模型声明的文件 |
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，上传使用逐文件复制。uv run model prepare 用于本地准备。
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 显式维护，页面移动时同步导航和相对链接。节点资产的脚本职责及检查入口见节点资产。