如何在Modly中安装扩展？从GitHub一键安装的完整步骤
【免费下载链接】modlyDesktop app to generate 3D models from images or prompt using local AI — runs entirely on your GPU项目地址: https://gitcode.com/GitHub_Trending/mo/modly
Modly 是一款完全在本地 GPU 上运行的开源桌面应用，可用 AI 将图片或提示词生成为 3D 模型。它的核心能力来自扩展（Extension）系统：通过「从 GitHub 一键安装」，你可以把 Hunyuan3D、TripoSG 等生成模型和 3D 处理工具装进自己的 Modly，无需配置任何命令行。本文带你用最简单的方式完成 Modly 扩展安装，全程只需 3 步。
Modly 扩展系统是什么？两种类型一文看懂
Modly 的每个扩展都是一个包含manifest.json清单文件的代码仓库，分为两类：
| 类型 | 作用 | 典型例子 |
|---|---|---|
| 🧠 模型扩展（Model） | 提供图生 3D 的生成能力，需额外下载模型权重 | Hunyuan3D Mini、TripoSG |
| ⚙️ 进程扩展（Process） | 对 3D 网格做修复、平滑、重拓扑等处理 | 网格优化器、网格修复 |
官方提供了 5 个开箱即用的扩展：Hunyuan3D 2 Mini（含 Standard / Turbo / Fast 三个版本）、Hunyuan3D Mini Turbo、Hunyuan3D Mini Fast、TripoSG和Trellis2 GGUF，完整清单见 README.md。
从 GitHub 一键安装扩展：完整步骤
步骤 1：打开扩展页，点击「Install from GitHub」
在左侧导航进入Models页面（页面标题为 Extensions），点击页面右上角的Install from GitHub按钮，会展开一个仓库地址输入框。该按钮位于 ModelsPage.tsx 中实现。
步骤 2：输入 GitHub 仓库地址，确认安装
在输入框中粘贴扩展仓库的 HTTPS 地址（格式形如https://github.com/owner/repo），然后点击Install。
点击安装后，Modly 会自动走完 4 个阶段，进度条实时显示：
- Downloading…下载扩展仓库，带百分比进度
- Extracting…解包到扩展目录
- Validating…校验
manifest.json是否合法（例如检查id字段、generator.py是否存在，校验逻辑见 extension-install-utils.ts） - Setting up environment…自动为扩展创建隔离的 Python 虚拟环境，并按你的 GPU 计算能力运行
setup.py（见 extensions.py）。这一步可能需要几分钟，请耐心等待。
完成后会显示绿色的 “Extension installed successfully!” 提示，扩展卡片随即出现在列表中。
步骤 3：模型扩展需额外下载模型权重
如果是模型扩展，扩展代码装好后，卡片上会列出各模型版本（如 Standard / Turbo / Fast），点击对应Install按钮即可开始下载权重，支持暂停和取消，进度以百分比实时显示。
💡进程扩展（Processors）安装并设置完成后即可直接使用，无需下载模型。
Modly 扩展安装报错？常见错误速查
安装失败时，错误会以红色提示框直接显示在安装表单下方，无需翻日志。常见原因如下：
| 错误提示 | 原因 | 解决办法 |
|---|---|---|
Must be a GitHub URL | 地址不是 GitHub 链接 | 检查是否粘贴了完整的 HTTPS 仓库地址 |
manifest.json: required field "id" missing | 清单缺少必填字段 | 确认仓库根目录的manifest.json格式正确 |
generator.py missing | 模型扩展缺少生成器入口 | 确认仓库根目录包含generator.py |
entry file "processor.js" missing | 进程扩展缺少入口文件 | 检查manifest.json中entry指向的文件是否存在 |
如果扩展列表中某张卡片显示加载错误，可点击工具栏的Reload（刷新）按钮重新扫描扩展目录并重新注册生成器（接口见 extensions.py）。
安装完成后：在 Workflows 中使用扩展
模型扩展安装并下载好权重后，它的生成节点会出现在Workflows工作流编辑器中。比如 TripoSG 扩展安装后，即可将Image → TripoSG → Add to Scene三个节点连起来，在生成页选中该工作流并点击 “Generate 3D Model” 即可出模。
如果生成遇到问题，可到Settings → Logs/Errors查看具体原因。
更多扩展管理技巧
- 🔍 按/快捷键聚焦搜索框，可按名称、作者过滤扩展；
- 顶部分类标签（All / Processors / Models / Official）快速筛选，官方扩展带Official徽章；
- 点击卡片打开详情抽屉，可安装单个模型变体或Install All一键全装；
- 删除扩展：点击卡片右上角的卸载按钮，模型扩展会列出已下载的权重，可勾选一并删除以释放磁盘空间；
- 📁 开发者也可点击Link local folder直接关联本地扩展文件夹，无需走 GitHub（前端逻辑见 extensionsStore.ts）。
至此，你已掌握 Modly 扩展的全部安装方法：从 GitHub 粘贴一个地址、等待几分钟，新的 3D 生成模型即可在本地 GPU 上跑起来。
【免费下载链接】modlyDesktop app to generate 3D models from images or prompt using local AI — runs entirely on your GPU项目地址: https://gitcode.com/GitHub_Trending/mo/modly
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
