内容
<p align="center">
<img src="plugins/blender-agent-studio/assets/blender-icon.png" width="112" alt="Blender logo">
</p>
# Blender 智能工作室
[](https://github.com/ifBars/blender-agent-studio/actions/workflows/validate.yml)
[](https://skills.sh/ifBars/blender-agent-studio/blender-agent-studio)
[](LICENSE)
使用可复制的 Python、固定的视觉证据、确定的质量门控和有界的本地 MCP，构建、检查、动画和基准测试 Blender 资产。
Blender 智能工作室包含一个总括路由技能、五个专业技能和评估工具，用于将用户请求转换为可检查的 `.blend` 和 GLB 可交付成果。它旨在回答一个比“Blender 是否生成了一个文件？”更难的问题：结果是否满足请求、经受住导出、在各个方面正确读取，并在代理工作流更改时改进？
## 快速开始
从 GitHub 市场安装完整的 Codex 插件：
```bash
codex plugin marketplace add ifBars/blender-agent-studio
codex plugin add blender-agent-studio@blender-agent-studio
```
启动新的 Codex 任务，然后询问：
> 使用 `$blender-agent-studio:blender-modeling-workflow` 和 `$blender-agent-studio:blender-asset-validation` 构建一个程式化、游戏-ready 的咖啡研磨机，作为可复制的 Python、`.blend` 和 GLB 文件。
当资产具有关节或动画部件时，添加 `$blender-agent-studio:blender-animation-workflow`。
<details>
<summary><strong>安装选项：完整插件或仅技能</strong></summary>
### 完整 Codex 插件
市场安装包括所有五个技能、Blender 图标和插件元数据，以及有界的本地 MCP：
```bash
codex plugin marketplace add ifBars/blender-agent-studio
codex plugin add blender-agent-studio@blender-agent-studio
```
更新 GitHub 支持的安装：
```bash
codex plugin marketplace upgrade blender-agent-studio
codex plugin add blender-agent-studio@blender-agent-studio
```
### 仅技能安装
通过 Vercel Agent Skills CLI 安装总括路由技能：
```bash
bunx skills add -g ifBars/blender-agent-studio --skill blender-agent-studio --agent codex -y
```
安装总括和所有五个专业技能：
```bash
bunx skills add -g ifBars/blender-agent-studio --skill "*" --agent codex --full-depth -y
```
仅技能路由不安装捆绑的 MCP 或 Codex 插件演示文稿元数据。
</details>
<details>
<summary><strong>Blender 可执行文件设置</strong></summary>
Blender 5.2 LTS 是已验证的运行时。 将 `blender` 放在 `PATH` 上，向基准命令传递 `--blender`，或设置 `BLENDER_EXECUTABLE`。
PowerShell:
```powershell
$env:BLENDER_EXECUTABLE = "C:\path\to\Blender\blender.exe"
```
macOS 或 Linux:
```bash
export BLENDER_EXECUTABLE="/path/to/blender"
```
可执行文件解析器在找不到 Blender 时会清楚地失败；公共包不包含任何特定于机器的安装路径。
</details>
## 选择工作流
| 目标 | 技能 |
| --- | --- |
| 构建或大幅改进模型 | [`blender-modeling-workflow`](https://skills.sh/ifBars/blender-agent-studio/blender-modeling-workflow) |
| 审计拓扑结构、层次结构、导出或视觉质量 | [`blender-asset-validation`](https://skills.sh/ifBars/blender-agent-studio/blender-asset-validation) |
| 创建或诊断关节机械运动 | [`blender-animation-workflow`](https://skills.sh/ifBars/blender-agent-studio/blender-animation-workflow) |
| 衡量基线与工作流质量 | [`blender-agent-benchmark`](https://skills.sh/ifBars/blender-agent-studio/blender-agent-benchmark) |
| 选择或评估 Blender MCP | [`blender-mcp-integration`](https://skills.sh/ifBars/blender-agent-studio/blender-mcp-integration) |
<details>
<summary><strong>命令手册：建模、验证和基准测试</strong></summary>
### 可复制模型
要求代理交付：
```text
create_asset.py
asset.blend
asset.glb
final_report.md
```
Python 脚本是持久的源。生成的 文件必须从干净的 Blender 进程中可复制。
### 无头 Blender 执行
```powershell
& $env:BLENDER_EXECUTABLE `
--background --factory-startup --python .\create_asset.py
```
### 确定性资产检查
```powershell
& $env:BLENDER_EXECUTABLE `
--background --factory-startup `
--python ".\plugins\blender-agent-studio\skills\blender-asset-validation\scripts\inspect_asset.py" -- `
--input ".\asset.glb" --output ".\evidence\metrics.json"
```
### 成对快速基准测试
将每个条件运行到新的输出目录：
```powershell
cd .\plugins\blender-agent-studio
bun install
bun run benchmark --suite quick --mode baseline `
--output C:\bench\baseline --blender $env:BLENDER_EXECUTABLE
bun run benchmark --suite quick --mode skills `
--output C:\bench\skills --blender $env:BLENDER_EXECUTABLE
```
单独运行 `skills_mcp` 以便 MCP 传输不会获得技能或提示改进的信用。
</details>
## 您获得的内容
- 具有语义对象和材质的合约优先程序化建模
- 作者场景和新鲜导入几何检查
- 视角、正交、联系表和关键帧证据
- 用于枢轴、支撑和连接端点的机械动画检查
- 具有干净源复制的不可变基准运行
- 硬门控评分加盲配对视觉判断
- 单独的基线、技能和技能加 MCP 条件
- 不能执行任意 Blender Python 的有界 MCP
<details>
<summary><strong>插件布局</strong></summary>
```text
SKILL.md
agents/openai.yaml
.agents/plugins/marketplace.json
plugins/blender-agent-studio/
.codex-plugin/plugin.json
.mcp.json
assets/
mcp/
scripts/
skills/
blender-agent-benchmark/
blender-animation-workflow/
blender-asset-validation/
blender-mcp-integration/
blender-modeling-workflow/
```
存储库根目录是一个 Codex 市场。可安装的插件位于 `plugins/blender-agent-studio/` 下。
</details>
## 要求
- 推荐 Blender 5.2 LTS
- 具有插件市场支持的 Codex CLI，用于完整安装
- 用于 MCP、测试和基准测试的 Bun 1.3.5+
- Blender 提供的 Python 用于资产生成和评估脚本
<details>
<summary><strong>开发和验证</strong></summary>
安装依赖项并运行 GitHub Actions 使用的相同检查：
```bash
bun install --cwd plugins/blender-agent-studio
bun run check
bun run test
```
检查验证市场和插件元数据、接口资产、技能前言、有界 MCP 发现和基准评分。
生成的模型、导出、渲染、基准运行和代理跟踪被排除在源代码控制之外。
</details>
## 验证的基准快照
2026 年 7 月的快照使用了 Blender 5.2.0 LTS、Codex CLI 0.145.0 和 `gpt-5.6-terra`，推理级别为中等。
| 任务 | 确定性结果 | 盲视结果 |
| --- | --- | --- |
| 信号灯烟雾 | 两者 100；两者通过 | 插件 1–0 |
| 台面压力机 | 两者 100；两者通过 | 插件 3–0 |
| 修订后的起重机桥梁 | 两者 100；两者通过 | 插件 3–0 |
| 脚踏泵拦截 | 插件 100/通过；基线 91/失败 | 插件 3–0 |
最终插件运行获得了 10 个盲选偏好投票，没有硬门控回归。它们平均长约 48%，因为它们执行了自己的验证和证据工作。
这是从每个条件中选择一个生成的结果，而不是在提示、模型、样式或随机变化中普遍主张的定向证据。参见方法和验证结果。
## 安全
Blender 使用当前用户的权限执行 Python。请在执行前查看不受信任的脚本和 `.blend` 文件。捆绑的 MCP 故意公开版本、检查和证据渲染工具，而不是通用任意 Python。
请勿提交私有模型、生成的渲染、基准跟踪或敏感提示。参见 [SECURITY.md](SECURITY.md)。
## 许可证和商标
项目源代码在 [MIT License](LICENSE) 下可用。
Blender 和 Blender 徽标是 Blender 基金会的商标。本项目与 Blender 集成，但未得到 Blender 基金会的关联或认可。参见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
MCP 市场