前言¶
做机械、打印或游戏资源相关开发时，仓库里常会堆着 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
