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.
2.7 KiB
2.7 KiB
Context
参见 proposal.md。现有节点入口依次调用 Blender 构建、资产校验及 pytest，预览模块已有 HTML 导出能力。模型入口统一准备模型并按选项上传，包含现成文件下载、普通 ONNX 转换及 PiSA-SR 独立环境转换。
Goals
命令入口负责参数解析与流程调度，业务模块负责产物；复用现有 Blender 启动、模型准备与校验实现。
Decisions
- 在现有两个 cli.py 使用 argparse 子命令，脚本入口为
node-group和model。Python 包继续使用表示业务集合的tools/nodes、tools/models。 node-group build保持构建、资产校验、全量 pytest 的顺序；check复用后两步。两者支持--blender和现有--skip-tests，后者只跳过 pytest。任一步失败立即以非零状态退出。preview复用 Blender 启动流程及现有预览导出器，默认写入系统临时目录的独立 HTML，输出绝对路径，再由父进程打开浏览器。支持--blender、--output PATH、--no-open、--fragment；fragment 模式仅输出片段且不自动打开。文件保留供查看，资产文件保持原样。- 模型子命令为
prepare和sync。prepare替代--prepare-only，统一下载现成 ONNX 或准备源权重并导出，包含 PiSA-SR；按既有目录输出，复用已校验的缓存及独立转换环境。sync复用全部准备成功后上传的流程。 - PiSA-SR 在模型目录下的临时目录导出整组文件，全部通过目录清单校验后再更新正式产物，临时目录随流程退出清理。
- 使用延迟导入，使帮助与参数错误可以在未加载 Blender、Torch 和导出环境时返回。无动作时显示帮助并成功退出，非法动作或参数非零退出。
flowchart TD
A[解析命令] --> B[node-group]
A --> C[model]
B --> D[build 构建资产]
D --> E[校验资产]
B --> F[check]
F --> E
E --> G[pytest]
B --> H[preview 内存构建与排列]
H --> I[HTML 预览]
C --> J[prepare 下载或导出并校验全部模型]
C --> K[sync]
K --> J
J --> L{动作是 sync}
L -->|是| M[上传 R2]
Risks / Trade-offs
- CLI 改名影响本地脚本调用 → 删除旧入口并验证新的安装脚本映射，实施时报告命令迁移。
- Blender 参数与预览参数共用进程命令行 → 显式传递业务参数，测试参数隔离与失败传播。
- 模型导出成本较高 → 保留大小及 SHA-256 校验后的缓存复用；自动测试使用隔离文件和替代执行器验证路由。
Migration Plan
更新入口及子命令后执行 uv sync 刷新本地脚本，运行相关测试、帮助命令及节点构建链验证。保留工作区既有修改。