MeshGen

使用 AI 代理通过自然语言控制 Blender。

功能

• 专注于将 AI 作为工具，而非替代品
• 多种后端选项：
  • 本地推理：使用 llama.cpp 或 Ollama
  • 远程推理：使用 Hugging Face、Anthropic 或 OpenAI
• 可选的 LLaMA-Mesh 集成，用于本地网格理解和生成
• 可选的 Hyper3D 集成，用于高保真 3D 网格生成

安装

1. 访问 最新发布 页面
2. 下载适用于您平台的插件 ZIP 文件
3. 在 Blender 中，依次进入 编辑 -> 偏好设置 -> 附加组件 -> 右上角箭头 -> 从磁盘安装...
4. 选择下载的 ZIP 文件

设置

1. 在 Blender 中，依次进入 编辑 -> 偏好设置 -> 附加组件 -> meshgen
2. 选择 本地 或 远程，并按照下方说明操作

本地后端

在 Blender 中直接免费运行模型。

仅当满足以下条件时才选择此选项：

1. 您拥有一块至少 8GB 显存的强大 NVIDIA 显卡
2. 在 安装 时已安装了带有 cuda 的插件版本
3. 您更倾向于直接在 Blender 中运行模型，而不是在本地 Ollama 服务器上运行

要设置本地后端，您可以：

1. 点击 下载推荐模型，以下载 Meta-Llama-3.1-8B-Instruct-GGUF
2. 手动下载一个 .GGUF 模型，并将其放入模型文件夹中（可通过点击文件夹图标找到该文件夹）

远程后端

MeshGen 支持多种远程后端。

1. Ollama：在免费的本地服务器上运行模型
2. Hugging Face、Anthropic 或 OpenAI：通过 API 运行强大的模型

对于大多数用户来说，推荐使用 Hugging Face，它提供对强大模型的有限免费使用。

Ollama

通过 Ollama 服务器在本地免费运行模型。

1. 安装 Ollama
2. 在终端中运行 ollama serve
3. 在 提供商 下拉菜单中选择 Ollama
4. 输入您的 Ollama 服务器地址和模型名称（默认设置通常适用于大多数用户）

Hugging Face

通过 Hugging Face API 运行各种模型，如 Llama、DeepSeek、Mistral、Qwen 等。

1. 在 Hugging Face 上创建一个账户
2. 前往 hf.co/settings/tokens 并创建一个新的令牌
3. 在 提供商 下拉菜单中选择 Hugging Face
4. 将您的 Hugging Face 令牌输入到 API 密钥 字段中
5. 您还可以根据需要更改 模型 ID，例如使用 meta-llama/Llama-3.3-70B-Instruct

Anthropic

使用 Anthropic API 运行 Anthropic 模型（如 Claude）。

1. 在 Anthropic 上创建一个账户
2. 前往 console.anthropic.com/settings/keys 并创建一个新的密钥
3. 在 提供商 下拉菜单中选择 Anthropic
4. 将您的 Anthropic 密钥输入到 API 密钥 字段中
5. 您还可以根据需要更改 模型 ID，例如使用 claude-3-5-sonnet-latest

OpenAI

使用 OpenAI API 运行 OpenAI 模型（如 ChatGPT）。

1. 在 OpenAI 上创建一个账户
2. 前往 platform.openai.com/api-keys 并创建一个新的密钥
3. 在 提供商 下拉菜单中选择 OpenAI
4. 将您的 OpenAI 秘密密钥输入到 API 密钥 字段中
5. 您还可以根据需要更改 模型 ID，例如使用 gpt-4o-mini

可选集成

要启用可选集成，请依次进入 编辑 -> 偏好设置 -> 附加组件 -> meshgen -> 集成。

启用这些功能后，代理会根据上下文自动获得对这些工具的访问权限。

LLaMA-Mesh

使用 LlamaMesh 进行本地网格理解和生成。

仅当满足以下条件时才选择此选项：

1. 您拥有一块至少 8GB 显存的强大 NVIDIA 显卡
2. 在 安装 时已安装了带有 cuda 的插件版本
3. 您正在使用远程 API 后端（如 Hugging Face、Anthropic 或 OpenAI），因为 LLaMA-Mesh 会在您的本地机器上加载

要启用 LLaMA-Mesh，点击 加载 LLama-Mesh，并等待模型加载完成。

Hyper3D

使用 Hyper3D 进行高保真 3D 网格生成。

启用步骤如下：

1. 勾选 启用 Hyper3D
2. 在 API 密钥 字段中输入您的 Hyper3D API 密钥（目前可以使用 awesomemcp 密钥免费使用）

每生成一个网格可能需要几分钟时间。

使用方法

• 按下 N 键 -> MeshGen（或依次进入 视图 -> 侧边栏 -> 选择 MeshGen 选项卡）
• 输入提示词，例如：创建一个雪人
• 点击 提交

故障排除

• 在控制台中查找错误信息：
  • Windows：在 Blender 中，依次进入 窗口 -> 切换系统控制台
  • Mac/Linux：从终端启动 Blender
• 如有错误，请在 问题页面 上报告

MeshGen 快速上手指南

MeshGen 是一款 Blender 插件，允许用户通过自然语言指令控制 AI Agent 进行 3D 网格的生成与编辑。它支持本地部署（需高性能显卡）或调用远程 API（如 Hugging Face、OpenAI 等）。

环境准备

在开始之前，请确保满足以下系统要求：

• 软件依赖：已安装 Blender（推荐最新稳定版）。
• 硬件要求（仅本地模式）：
  • 若选择本地后端或启用 LLaMA-Mesh 集成：需要配备至少 8GB 显存 的 NVIDIA GPU，并确保护展已安装 CUDA 支持版本。
  • 若使用远程后端（推荐）：对本地硬件无特殊要求，普通配置即可运行。
• 网络环境：访问 Hugging Face、Ollama 或大模型 API 需要稳定的网络连接。国内用户建议配置网络加速工具或使用国内镜像源下载模型文件。

安装步骤

1. 下载插件 前往 MeshGen Latest Release 页面，下载对应平台的 addon ZIP 文件。

   注意：若计划使用本地推理，请务必下载带有 cuda 标识的版本。

2. 导入 Blender 打开 Blender，依次点击菜单栏： Edit -> Preferences -> Add-ons 点击右上角箭头图标，选择 Install from Disk...，选中刚才下载的 ZIP 文件并确认安装。

3. 配置后端 在 Add-ons 列表中搜索并点击 meshgen 进入设置面板，根据需求选择后端模式：

   • 方案 A：远程后端（推荐大多数用户）

     1. 选择 Remote 模式。
     2. 在 Provider 下拉菜单中选择服务商（推荐 Hugging Face，提供免费额度；也可选 Anthropic 或 OpenAI）。
     3. 填入对应的 API Key。
        • Hugging Face: 在 hf.co/settings/tokens 创建 Token 并填入。
        • Anthropic/OpenAI: 分别在各自控制台创建 Key 并填入。
     4. （可选）修改 Model ID 以指定特定模型（例如 meta-llama/Llama-3.3-70B-Instruct）。

   • 方案 B：本地后端（需高配显卡）

     1. 选择 Local 模式。
     2. 点击 Download Recommended Model 自动下载模型，或手动将 .GGUF 模型文件放入插件指定的 models 文件夹中。

4. 可选集成（高级功能） 如需使用高精度生成或本地网格理解，可在 Integrations 标签页中：

   • LLaMA-Mesh：点击 Load LLama-Mesh（需本地 CUDA 环境且配合远程 API 使用）。
   • Hyper3D：勾选 Enable Hyper3D 并填入 API Key（当前可使用 awesomemcp 作为免费测试 Key）。

基本使用

安装配置完成后，即可通过自然语言生成 3D 模型：

1. 打开面板 在 Blender 界面右侧按下快捷键 N 打开侧边栏，点击 MeshGen 标签页（或通过菜单 View -> Sidebar 查找）。

2. 输入指令 在文本框中输入你的创作意图，例如：

   Create a snowman
   

3. 执行生成 点击 Submit 按钮，AI Agent 将自动调用 Blender 工具链完成建模。

提示：操作过程中如遇错误，Windows 用户可通过 Window -> Toggle System Console 查看控制台日志；Mac/Linux 用户请在终端启动 Blender 以查看输出信息。