nan
27ca25224a
- Added a proposal for depth surface strip cleanup, detailing the rationale and changes to the depth plane and cutout nodes. - Created specifications for the new cleanup requirements, including scenarios for strip removal and boundary edge detection. - Developed tasks for implementing shared strip detection logic and integrating new interfaces for depth nodes. - Established a new CLI structure for organizing node groups and model commands, replacing old entry points with a more intuitive command structure. - Introduced a prototype for panorama surface generation, including requirements for distance reconstruction and geometry node surfaces. - Added comprehensive tests for depth strip cleanup functionality, ensuring correct behavior for various mesh topologies and edge cases.
49 lines
2.7 KiB
Markdown
49 lines
2.7 KiB
Markdown
# 开发与发布
|
||
|
||
仓库使用 CPython 3.11 与 `bpy==4.5.3` 测试 Blender 代码；AI Server 使用 `runtime.py` 声明的独立 Python 3.12 Environment。
|
||
|
||
```bash
|
||
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 与文档导航
|
||
|
||
```mermaid
|
||
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` 显式维护，页面移动时同步导航和相对链接。节点资产的脚本职责及检查入口见[节点资产](node-assets.md)。
|