trellis_blender

🚀 TRELLIS Blender 插件

这是一款强大的 Blender 插件，它将 TRELLIS 的 3D 生成能力完美集成到 Blender 中。TRELLIS 作为 SOTA 文本到 3D 和图像到 3D 的 AIGC 模型，让这款插件拥有了卓越的 3D 生成能力。现在，它还更新支持了文本到 3D 和 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，点击启动 MCP 服务器
2. 打开 Claude/Cursor/Windsurf，粘贴以下配置：

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

✨ 主要特性

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

📚 详细文档

生成参数

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

功能特性

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

💡 使用建议

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