Community研究與資料分析github.com

CNOCTAVE/chinese-blender-modeling-cnoctave

用中文进行Blender建模的AI助手技能,涵盖脚本生成、步骤指导、拓扑审查与模型优化。

chinese-blender-modeling-cnoctave 是什麼?

此AI技能专为Blender建模设计,可自动识别四类任务:生成可复用bpy脚本、提供分步操作指导、审查拓扑与模型质量、优化并修复现有模型。它优先采用非破坏性工作流(Mirror/Bevel/Subdivision等修改器栈),并遵循“先拓扑后细节”的核心原则。技能支持版本兼容检测(自动适配Blender 4.x/3.x API),生成的脚本会通过`blender --background --python`无头运行验证,确保正确性。此外,它具备中断续写能力,可自动恢复未完成项目。输出采用双轨制:同时交付可复制脚本和手动操作步骤,用户可自由选择。该技能适用于Claude Code、Cursor、Codex等AI代理平台,为中文用户提供完整的Blender建模自动化体验。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add CNOCTAVE/chinese-blender-modeling-cnoctave

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

chinese-blender-modeling-cnoctave: Blender 建模助手

路徑約定:本文檔中所有 {CWD}/blender-modeling/ 開頭的路徑均指用戶工作目錄下的 blender-modeling/ 資料夾。{CWD} 即用戶啟動會話時的當前目錄(非 skill 所在目錄),所有生成的檔案/目錄都應建立在此路徑下。

三大黃金法則

  1. 先拓撲後細節 - 拓撲(佈線)決定一切下游工作:細分變形、UV 展開、骨骼綁定、效能預算。先規劃好四邊面與極點分佈,再考慮細節雕琢
  2. 腳本優先、可複現 - 能用 bpy 腳本表達的建模流程就寫成腳本(參數化、可復用、可回放),不要只給「點幾下滑鼠」的一次性操作
  3. 非破壞性工作流 - 優先使用修改器(Mirror / Subdivision / Bevel / Solidify…)而非手動塌陷網格,保持可調參數;修改器順序決定結果,必須說明順序
  4. 驗證不假設 - 不猜測 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

相關技能