前言¶
做 3D 資產時，常見做法是拆成多段工具鏈：生成或手建網格、展 UV、做 PBR、渲染出圖，再減面、轉格式給引擎或打印。每換一步就要換軟件或腳本，提示詞也很難覆蓋「從描述到可導出文件」的完整約束。若你希望在同一次對話裏，用自然語言驅動建模、材質、渲染和導出相關步驟，可以把 SkillHub 上的 3D建模師（@user_df5e9a0b/3d-model）裝進當前 Agent，由技能文檔約束流程與術語。
這是什麼¶
3D建模師 是 SkillHub 分類 design-media 下的社區技能（來源：community），座標 @user_df5e9a0b/3d-model，當前版本 1.0.0，發佈者爲 user_df5e9a0b。
官方簡介將其定位爲「完整 3D 建模全流程」技能：在需要從文字描述或參考圖得到三維模型、做多邊形/曲面/雕刻/參數化建模、製作 PBR 材質與 UV 展開、配置實時或離線渲染與光影后期、或做拓撲優化/減面/LOD/格式轉換導出時使用。場景覆蓋遊戲資產、3D 打印、電商展示、影視預演等，並寫明支持 AI 生成 與 Blender 腳本 兩條技術路線。頁面標籤 requires_api_key=false，表示未標註必須配置 API Key（具體仍取決於你本地環境與 Agent 所調用的外部服務）。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_df5e9a0b/3d-model
- API 元數據：https://api.skillhub.cn/user_df5e9a0b/3d-model
（SkillHub 抓取元數據：評分 100000，下載 6104。）
核心功能¶
下列能力均來自官方簡介，未在公開頁單獨拆步驟的環節不展開臆測。
- 輸入與生成：從文字描述或參考圖生成/推進三維模型。
- 建模方式：多邊形、曲面、雕刻、參數化建模。
- 材質與 UV：PBR 材質製作、UV 展開。
- 渲染與後期：實時或離線渲染、光影與後期相關設置。
- 資產優化與交付：拓撲優化、減面、LOD、格式轉換與導出。
- 實現路徑：AI 生成路線與 Blender 腳本路線並行說明，便於在對話裏選型。
安裝與啓用¶
SkillHub 頁面給出的安裝提示是：按 SkillHub 安裝文檔 安裝座標 @user_df5e9a0b/3d-model。下面介紹與文檔一致的 CLI 方式；若你更習慣對話安裝，可把頁面上的提示詞發給 Agent，效果等價於引用同一座標與安裝說明。
1. 檢查或安裝 skillhub CLI¶
先確認本機是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可用官方腳本（完整安裝含默認 Skill；僅需 CLI 時加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安裝到當前 Agent 的 skills 目錄¶
安裝技能時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別。官方文檔列出的常見路徑包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
在 Cursor 中示例（將目錄換成你的環境）：
skillhub install @user_df5e9a0b/3d-model --dir ~/.cursor/skills/
也可先搜索再安裝：
skillhub search 3d-model
skillhub install @user_df5e9a0b/3d-model --dir ~/.cursor/skills/
經過上面的步驟後，按你所用 Client 的要求重啓或刷新 Agent，使新技能被加載。公開資料未提供該 Skill 包內 SKILL.md 的逐條觸發詞；啓用後一般以「任務描述是否落在簡介所列場景」爲準。
典型用法¶
公開頁未附帶可複製的建模命令或 Blender 腳本片段，典型用法是：安裝技能 → 在對話中說明目標與約束 → 由 Agent 按技能文檔組織流程。可按簡介中的觸發條件組織需求，例如：
- 文生/圖生模型：說明主體、比例、面數或用途（遊戲/打印/電商），並是否提供參考圖。
- 材質與 UV：說明貼圖通道需求（PBR）、分辨率與是否需展開 UV。
- 渲染：說明實時預覽還是離線出圖，以及光照/後期傾向。
- 交付：說明目標格式、LOD 層級或減面比例。
若你選擇 Blender 腳本路線，在對話中明確要求生成或調整 bpy 相關步驟即可與技能自述一致；AI 生成路線則依賴 Agent 與本地已配置的可調用能力，SkillHub 頁面未列出具體模型或接口名，文中不虛構。
適用場景與注意¶
適合誰：需要在同一 Agent 會話裏串聯 3D 工作流的產品、技術美術、獨立開發者，或希望用自然語言驅動 Blender/生成類任務、又不想每次手寫完整流程說明的人。
場景：遊戲資產、3D 打印、電商展示、影視預演等，與官方簡介一致。
注意：
- 全流程能力依賴 Agent 對技能內容的遵循程度，以及你本機是否安裝 Blender、是否具備可用的生成類工具；SkillHub 元數據未承諾一鍵出成品網格文件。
requires_api_key=false僅表示技能標籤未強制 API Key；若對話中接入第三方生成服務，仍需你自行配置密鑰與合規審查。- 評分與下載量來自 SkillHub 頁面元數據，會隨時間變化，引用時以官網爲準。
結尾¶
3D建模師 把從描述/參考圖到建模、PBR 與 UV、渲染後期、減面與導出的需求收攏到一條 Skill 座標上，並標明 AI 與 Blender 腳本雙路線，適合作爲 design-media 類 Agent 的常駐能力。安裝與座標以 SkillHub 爲準：
- https://www.skillhub.cn/skills/user_df5e9a0b/3d-model
- 安裝說明：https://skillhub.cn/install/skillhub.md
