Dsh Skill Blender Modeling

dsh-skill-blender-modeling

Blender 建模与装配流程 skill（DSH / Claude 风格的 skills/<name>/SKILL.md 目录）· v1.0 把「捏一个物体」和「多个 agent 造一台机器」都写成可执行流程 + 可跑的判据。

这是什么

一份给 AI agent 读的建模作业指导书：先按决策树选形，再走流水线，每一步都要有画面或数字证据。 与常见的「Blender 入门教程」不同，它按实测反馈写成 —— 下面每一条都是踩过之后才加进去的：

• 载体不匹配就换路子：分面装甲板禁止上 SubSurf（会把棱边圆成肥皂）；编辑模式 bpy.ops.mesh.* 在 blender -b 下 context 很脆 → 改 bmesh；
• 展示拼接 ≠ 真实连接：面贴面必见缝，所以展示模型用隐藏交叠（不改可见轮廓、不捅穿薄壳），交叠量由 本项目 spec 明文定、装配后按 spec 复核 —— 没有通用倍数或下限；能不能承载由设计配合 / 标准 / 承载工况 / 制造工艺 / 运动间隙规定，几何脚本不给强度结论；
• 判据必须有前提：法线朝内会让所有"穿模 / 内含"判据整体反号（实测把贴合件误报成深入 150mm）；
• 指标必须有适用范围：IoU 只是单视轮廓的必要条件（看不见深度/内部特征/面感）；单应只校正 取点那一个平面（离平面 0.5m 实测误差 543mm）；跨深度误差不是固定 ±5% 而是 Δz/(D+Δz)；
• 验收不能靠肉眼：形体要「同机位对照图 + 数值 bbox」两条证据；判定走机械门（§6 十道门 / gate_run 三态），degraded 不算通过。

v1.0 版内容一览

• 两条大件主线：§0.5 多 Agent 并行建模的分工范式（冻结 lib/spec.py / 写作用域协议 / 接口表 / 隐藏交叠 + 装配后复检 / 归属标签与可并行性判据）、§0.6 参考图驱动的形体还原（三视图标定 / 双证据验收 / 读图纪律）。
• §0.7 建模类型 → 工具指路：12 类建模类型的「第一步 / 算子链 / 禁止自造 / 验收门」+ 三条硬规则； §0.71 收调用约定（kapi 的 dict 与 JSON 两种形态）与离线逃生口（offline_bootstrap.py）。
• 配方 Recipe 1–23（### Recipe 小节共 26 条：2 拆 2a / 2b，另含 3b、6b 变体）：基本体 → 分面 / 光滑硬表面 → bmesh 编辑 → 布尔 → 镜像 / Array → 参数化销轴弦长闭合阵列 → 装配审计门 → 形体验收 → 程序化雕刻 → 网格修复 + UV → 打印检查 → 沿路径扫掠 → 人形素体 / 头型 → 车辆与参考图放样 → 照片校正 → 折线族拟合 → 特征线层 → 多步链一条命令跑完（pipe_run）。
• 五条高频配方参数化（2a / 4 / 5 / 6b / 9）= 参数块 + 生成脚本，直接接 generator_save/run/list/get/diff（§3.0）。
• 六条必踩的坑（§4）：长轴·宽轴·薄轴语义、可视拼接与真实连接的区别、收尖压中线、headless 慎用 bpy.ops、 法线前提、预览光照；§4.0 按「能不能机械判定」分流到验收门或写代码前 checklist。
• 数值门清单（§6：十道门 ①–⑩ + 证据留档）+ 交接前必跑与可复制的验收回执（§0.5.5 / §6.1）； 判定是三态 pass / fail / degraded —— clean=false 先读 state，degraded 不是通过。
• 容易写错的"通则"在本版里的现行口径：不存在固定修改器链（§5）；Delete Loose 一个面都不删， 内部面走 Boolean UNION / 射线法（§5.1）；正交不推出三视共享 px_per_mm、跨深度误差 ≈ Δz/(D+Δz)（§0.6.1）； 单应只校正取点那个平面；audit_scene 默认不跑自交 ⇒ 交付验收必须显式传 self_intersect:true。

内容（SKILL.md）

计数口径：配方按 §3 的 ### Recipe 小节数（26 条）+ 编号 1–23；坑按 §4 的 ### 坑一–坑六（6 条）； 门按 §6 表 ①–⑩（10 道，另有"证据留档"一行）。SKILL.md 的 frontmatter 与 §12 的计数已同步为 23 条配方 （Recipe 23 pipe_run 加入后），加载器读到的技能目录也已是 23。

安装

git clone https://github.com/sixtysevenlf/dsh-skill-blender-modeling.git
cd dsh-skill-blender-modeling

# 方式 A（推荐）：软链，改一处两边同步
ln -s "$PWD" ~/.dsh/skills/blender-modeling

# 方式 B：直接拷贝
cp -r . ~/.dsh/skills/blender-modeling

⚠ SKILL.md 必须保留 YAML frontmatter（name / description / license）—— 加载器靠它建目录；frontmatter 一掉，技能会直接从技能目录里消失（踩过）。

配套插件

本技能里的 blender_rt_* / blender_viewport 工具来自配套插件（v1.0.0，能力冻结线）：

• https://github.com/sixtysevenlf/dsh-blender-plugin

插件负责"通道"（看视口 / 跑 Python / 无头批处理 / 作业层 / 事务回滚 / 装配审计 / 一键拉起 Blender）， 本技能负责"流程与判据"（选形、配方、坑、数值门）。两个一起用才完整。

许可与来源

MIT（见 LICENSE，Copyright © 2026 sixtyseven67）。派生自两个 MIT 项目（决策树 / 配方 / 坑表 / 六步总纲等）， 工具调用已改写为本机 blender_rt_* 直连链：

• RobLe3/cc-blender-skill（决策树、配方、坑表、深水参考； references/modeling-overview.md 为上游英文原文收录）
• arjun988/blender-skills（六步总纲、集合结构、修改器规则、清理清单、MUST / MUST NOT）

完整归属与本地改动见 NOTICE.md。references/modeling-overview.md 里「固定修改器顺序」与「内部面 → Delete Loose」 两处上游旧说法已就地标注纠正（现行口径见 §5 / §5.1）。