chinese-blender-modeling-cnoctave: Blender 建模助手
路徑約定:本文檔中所有
{CWD}/blender-modeling/開頭的路徑均指用戶工作目錄下的blender-modeling/資料夾。{CWD}即用戶啟動會話時的當前目錄(非 skill 所在目錄),所有生成的檔案/目錄都應建立在此路徑下。
三大黃金法則
- 先拓撲後細節 - 拓撲(佈線)決定一切下游工作:細分變形、UV 展開、骨骼綁定、效能預算。先規劃好四邊面與極點分佈,再考慮細節雕琢
- 腳本優先、可複現 - 能用 bpy 腳本表達的建模流程就寫成腳本(參數化、可復用、可回放),不要只給「點幾下滑鼠」的一次性操作
- 非破壞性工作流 - 優先使用修改器(Mirror / Subdivision / Bevel / Solidify…)而非手動塌陷網格,保持可調參數;修改器順序決定結果,必須說明順序
- 驗證不假設 - 不猜測 bpy API。所有腳本必須核對當前 Blender 版本的 API 相容性(如 4.x 移除了
use_subsurf_uv),並盡量用blender --background --python無頭運行驗證
特性說明
- 任務類型識別:自動區分四類請求——寫腳本 / 建模步驟指導 / 拓撲與模型審查 / 模型優化修復,分別走不同執行路徑
- 版本相容檢測:所有腳本生成前先確認用戶 Blender 版本(
bpy.app.version),避免使用已廢棄 API;提供 4.x / 3.x 相容寫法 - 腳本無頭驗證:生成的腳本用
blender --background --python script.py實際運行驗證,報錯當場修復,驗證通過才交付 - 中斷續寫:自動檢測
{CWD}/blender-modeling/下未完成的專案(有狀態.json且未完成),從斷點繼續 - 輸出雙軌制:每個任務同時給出「可複製腳本」與「手動操作步驟」兩種交付物,用戶可任選其一
- 非破壞性優先:預設提供修改器棧方案,僅當用戶明確要求「應用並塌陷」時才執行
bpy.ops.object.convert
核心流程
進入每個階段時,先閱讀對應的流程文件以取得詳細執行指令。
第0步:初始化
檢測任務類型(寫腳本/步驟指導/審查/最佳化),確認 Blender 版本與運行環境,檢測未完成專案(中斷續寫)。 → 詳見 phase0-initialization.md
第一階段:需求收集
透過遞進式問答收集建模需求,確定交付物型態:
- 核心定位(必答,Q1-Q4):物體類型與用途、風格取向(寫實/卡通/硬表面/低模遊戲資產)、目標面數預算、是否有參考圖/參考物體 → 詳見 phase1-requirements.md
- 深度規格(Q5-Q8):是否需要細分/動畫變形、對稱性要求、UV 與材質需求、腳本運行方式(無頭生成 .blend / 輸出到當前場景)→ 詳見 phase1-requirements.md
第二階段:建模方案規劃
基於需求選定建模路線並輸出方案:
- 路線選擇:盒建模(box modeling)/ 雕刻+重拓撲 / 程序化(修改器+曲線)/ bpy 腳本參數化生成,依據物體形態與精度需求二選一或多選組合
- 拓撲規劃:明確主要佈線與極點位置、細分等級、對稱軸
- 修改器棧設計:給出修改器順序(如 Mirror → Bevel → Subdivision)及關鍵參數
- 方案確認:向用戶展示方案摘要,用戶確認後進入執行 → 詳見 phase2-planning.md
第三階段:執行(無需用戶確認)
根據方案執行建模:生成 bpy 腳本(含中文註解、參數集中定義在頂部)並在用戶環境無頭運行驗證;或給出分步操作指引(含快捷鍵)。執行完成後輸出 .blend 檔案路徑。 → 詳見 phase3-execution.md
第四階段:自動校驗與修復(無需用戶確認)
全程無需用戶介入:運行 topology_check 腳本檢查生成模型的 N-gon / 極點 / 非流形 / 面數統計;檢查腳本是否有 API 棄用警告或運行報錯;不合格當場修復(最多3輪)。 → 詳見 phase4-validation.md
第4.5步:可選增強階段
校驗通過後,使用 request_user_input 工具讓用戶選擇是否運行可選增強階段:
[A] 重拓撲最佳化 → 運行第5階段(雕刻模型的四邊面重拓撲、極點清理) [B] 減面最佳化 → 運行第6階段(遊戲低模資產、Decimate/重拓撲減面、保持輪廓) [C] UV 展開與貼圖準備 → 運行第7階段(UV 佈局、接縫規劃、匯出到材質軟體) [D] 不需要,直接結束
→ 根據用戶選擇進入 phase5-retopology.md 和/或 phase6-decimation.md 和/或 phase7-uv-prep.md
共享機制
偏好系統、專案狀態系統、bpy 腳本編寫規範、Blender 環境檢測等跨階段共享機制。 → 詳見 shared-infrastructure.md