FBX → GLB Converter Skill

无损 FBX 转 GLB 格式转换，提供 CLI 和 Web 两种方案。

可用资源

使用方式

方式 1：CLI 命令行转换（推荐日常使用）

适用于用户直接提供 FBX 文件路径，需要快速转换。

前置条件： 项目目录需安装 assimpjs：

cd <项目目录>
npm install assimpjs

执行转换：

node <skill-dir>/scripts/convert.js <输入.fbx> [-o <输出.glb>] [--force]

示例：

# 基本转换
node scripts/convert.js "C:/Users/xxx/model.fbx"

# 指定输出路径和覆盖
node scripts/convert.js "C:/Users/xxx/model.fbx" -o "C:/Users/xxx/model.glb" --force

# 从 skill 路径执行（用户未安装时）
node ~/.workbuddy/skills/fbx-to-glb/scripts/convert.js "文件路径.fbx"

方式 2：部署网页版转换器

适用于用户要分享给他人、或部署到托管平台。

网页版包含以下文件：

• assets/web/index.html — 主页面（拖拽上传 + 3D 预览 + 一键下载）
• assets/web/assimpjs.js — Assimp WASM JS 绑定
• assets/web/assimpjs.wasm — Assimp WASM 引擎（~4MB）
• assets/web/robots.txt — SEO 爬虫配置
• assets/web/sitemap.xml — 搜索引擎站点地图

部署步骤：

1. 将 assets/web/ 下所有文件复制到目标目录
2. 推送到 GitHub Pages 或任意静态托管（Vercel、Netlify、CloudStudio 等）

CloudStudio 部署（推荐最简单）：

# 复制文件到 dist 目录
mkdir -p dist && cp assets/web/* dist/

# 调用 cloudstudio-deploy skill

GitHub Pages 部署：

1. 在 GitHub 创建仓库
2. 将 assets/web/ 文件放入仓库的 docs/ 目录
3. Settings → Pages → Source: Deploy from a branch → Branch: master → Folder: /docs
4. 等待 1-2 分钟后通过 https://<用户名>.github.io/<仓库名>/ 访问

关键技术细节

• 引擎： assimpjs（Assimp 编译为 WASM），工业级 FBX 解析
• 贴图： assimpjs 使用 FS.readFile(GetPath(), encoding: 'binary') 获取文件内容（返回 Uint8Array），非 GetName()/GetContent() 方法
• 转换流程： assimp.FS.readFile → 读取原始 FBX → assimp.ConvertFileList 转换 → 遍历结果文件找到 .glb → FS.readFile 读取 blob → 写入磁盘
• Web 版特性： 单向数据流（拖拽→解析→预览→导出），支持 OrbitControls 3D 旋转/缩放
• 文件限制： CLI 无限制，Web 版建议 ≤500MB

故障排除