TRELLIS Blender 插件

更新：支持文本到 3D 和添加 MCP 集成

一个 Blender 插件，将 TRELLIS 的 3D 生成能力集成到 Blender 中。TRELLIS 是 SOTA 文本到 3D 和图像到 3D AIGC 模型。

核心功能

• 文本到 3D：文本 -> 带纹理的 3D 网格
• 图像到 3D：图像 -> 带纹理的 3D 网格
• 文本条件下的细节变化：文本 + 3D 网格 -> 带纹理的 3D 网格
• 图像条件下的细节变化：图像 + 3D 网格 -> 带纹理的 3D 网格
• MCP 集成：与 MCP 集成，可以与 Cursor/Windsurf 通信。请参考 Trellis MCP

安装

要求

• Blender 3.6.0 或更高版本
• 运行 TRELLIS API 服务器（请参考 我的 TreLLIS 分支）

启用插件

1. 下载插件文件（克隆此仓库）
2. 在 Blender 中，转到编辑 > 偏好设置 > 插件
3. 点击“安装”并选择 trellis_for_blender.py 文件
4. 通过勾选“3D 视图：TRELLIS”旁边的框来启用插件

原生工作流程

1. 访问面板（打开 3D 视口并按 N 键打开侧边栏），找到 TRELLIS。
2. （可选）选择场景中的一个对象，选择一个图像作为条件输入。
3. 调整生成参数（经验上可以使用更少的步骤）
4. 插件会将对象（如果已选择）和图像/文本上传到 API 后端。
5. 完成后，可以将模型下载并导入到场景中。

您可以在主面板中查看历史请求

MCP 工作流程

1. 访问面板（打开 3D 视口并按 N 键打开侧边栏），找到 TRELLIS，点击 Start MCP Server
2. 打开 Claude/Cursor/Windsurf，粘贴以下配置：

"mcpServers": {
        "trellis": {
            "command": "uvx",
            "args": [
                "trellis-mcp"
            ]
        }
    }

生成参数

• 稀疏结构设置
  • 采样步数（结构扩散的采样步数，默认为 12）
  • CFG 强度（无分类器引导，默认为 7.5，值越高越能更好地对齐输入图像）
• 结构化潜在设置
  • 采样步数（SLAT 扩散的采样步数，默认为 12）
  • CFG 强度（无分类器引导，默认为 7.5，值越高越能更好地对齐输入图像）
• 后处理网格选项
  • 简化率（要移除的三角形数量，默认为 0.95）
  • 纹理大小（默认为 1024，可以设置为 2048 以获得更高的质量，但速度较慢）
  • 纹理烘焙模式（“fast”或“opt”，“opt”可能很慢但质量更高）

功能

• 异步请求处理
• 实时状态更新
• 错误处理
  • “未选择文件”：选择一个输入图像
  • “API 连接错误”：检查 API 服务器是否正在运行
  • “处理错误”：检查 API 服务器日志以获取详细信息

欢迎任何问题/讨论/贡献！