前言¶
做機械、打印或遊戲資源相關開發時，倉庫裏常會堆着 STL、STEP、GLB 等模型文件。要確認幾何是否正確，往往得打開 Fusion 360、Blender 或專用 CAD 查看器，切換成本高，也不適合在對話裏讓 AI 協助排查。
下面介紹 SkillHub 上的社區 Skill「3D模型查看器」（@user_ec1a4d28/3d-viewer）。它把「在本地打開並瀏覽模型」的能力交給 Agent 調度，無需再爲常見格式單獨裝一套大型桌面軟件。
這是什麼¶
「3D模型查看器」是發佈在 SkillHub 的 Agent Skill，座標 @user_ec1a4d28/3d-viewer，當前版本 1.8.0，來源爲 community，分類 design-media。頁面標註 requires_api_key=false，不依賴額外 API Key。
Skill 基於通用的 SKILL.md 約定：安裝到當前 Agent 的 skills 目錄後，模型文件仍在本地，由 Skill 指導 Agent 完成查看與交互，而不是把文件上傳到第三方 SaaS。
核心功能¶
根據 SkillHub 頁面與已抓取元數據，可覈實的能力如下。
多格式本地查看
- 支持 29+ 種 3D 模型格式，在本地直接查看，無需安裝其它大型查看軟件。
- 明確列出的格式包括：STL、3MF、STEP、STP、GLB、GLTF、OBJ、PLY、FBX、USDZ 等；較新版本說明中還提到 FCStd、igs/iges、brp/brep、stpz 等擴展。
分發與合規
- 通過 SkillHub 安裝與更新，與國內 Skill 商店同一套 CLI 與目錄規範。
- 標籤表明不需要 API Key，適合在內網或限權環境裏先裝 Skill、再處理本地模型路徑。
未在官方頁面或已抓取資料中出現的能力（例如具體測量菜單、材質編輯器名稱、動畫管線細節），本文不展開，避免與 Skill 實際實現不一致。
安裝與啓用¶
官方推薦讓 AI 按 SkillHub 安裝文檔操作，提示詞如下。
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_ec1a4d28/3d-viewer`。
若你自行用 CLI，可先確認 skillhub 是否已安裝，再安裝到當前 Agent 的 skills 目錄（裝錯目錄 Agent 不會加載）。
command -v skillhub && skillhub --version
未安裝 CLI 時，可按 SkillHub 文檔執行完整安裝（節選）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill 時，--dir 必須指向當前環境的 skills 路徑。常用路徑如下（摘自 SkillHub 安裝說明）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
示例（將 <skills 目錄> 換成上表對應路徑）：
skillhub install @user_ec1a4d28/3d-viewer --dir <skills 目錄>
安裝後按你所用 Client 的要求重啓或刷新 Agent，使新 Skill 被索引。
典型用法¶
官方頁面未給出固定 CLI 子命令，典型路徑是：在對話中說明要查看的本地文件路徑與格式，由 Agent 按 SKILL.md 調用查看能力。可復現的表述示例：
- 指明文件，例如：
請查看項目裏的 models/part.stl。 - 對 CAD 交換格式，例如：
瀏覽這個 STEP 模型：/path/to/bracket.step。 - 對 Web/實時 3D 常用格式，例如：
打開 /assets/scene.glb 並確認模型是否完整。
經過上面的步驟，Agent 應能識別已安裝的 @user_ec1a4d28/3d-viewer，在本地渲染或打開查看界面（具體交互以 Skill 內說明爲準）。
適用場景與注意¶
適合誰
- 需要在 Cursor、Claude Code、Codex 等環境裏快速覈對 STL/STEP/GLB 等文件，又不想爲每種格式裝獨立軟件的團隊或個人。
- 模型路徑已在工作區或本機可讀位置，希望用自然語言讓 Agent 代爲打開的場景。
使用注意
- 社區來源（
community）的 Skill，升級前可在 SkillHub 查看版本說明；當前記錄版本爲 1.8.0。 - SkillHub 統計（以已抓取資料爲準）：評分 100000，下載 2517；安裝計數爲 0 僅表示商店側統計口徑，不代表無法本地安裝。
- 超大 STEP 或高面數 FBX 可能受本機性能與 Skill 實現限制，複雜裝配仍建議用專業 CAD 做最終籤核。
- 安裝務必使用
--dir指向正確 skills 目錄，否則默認落到./skills/，Agent 可能識別不到。
結尾¶
「3D模型查看器」把多格式 3D 文件的本地預覽能力封裝成 Agent Skill，減少在 CAD 與代碼環境之間來回切換。需要安裝或查看詳情時，可打開 SkillHub 頁面：
- 技能頁：https://www.skillhub.cn/skills/user_ec1a4d28/3d-viewer
- 官方地址：https://api.skillhub.cn/user_ec1a4d28/3d-viewer
