Blender 交互

用对话操作本机已打开的 Blender：查看场景、改物体、视口截图、执行 bpy，以及可选的 Poly Haven / Sketchfab 资源导入。

安装

1. 安装 Blender

安装 Blender 4.2+（推荐 5.x；3.6 等旧版可能不支持「从磁盘安装」扩展流程）。

2. 安装伴生与扩展包

1. 设置 → 伴生服务 → Blender 交互 → 安装 / 配置
2. 点 打开安装包（zip）（或「打开插件目录」），找到 dsh_blender_bridge.zip
3. 在 Blender：扩展 → 从磁盘安装，选择该 zip（不要解压，也不要选单个 .py）
4. 启用 DSH Blender Bridge

若提示与官方扩展仓库目录相关的 WinError 3 … blender_org，一般可忽略，不影响本地 zip 安装。

从旧版（单文件 .py）升级时，请重新「从磁盘安装」覆盖 zip，再启用。

配置

1. 打开要处理的 .blend 工程
2. 3D 视图按 N 打开侧栏 → DSH → Start DSH Bridge（默认 127.0.0.1:9876）
3. 回到桌面端，启动「Blender 交互」伴生（或打开自动启动）

可选：在 DSH 面板勾选 Poly Haven / Sketchfab 等集成（需 Blender 自带 Python 能使用相应依赖）。

使用示例

• 「列出当前场景里的物体」
• 「截一张当前视口」
• 「给选中物体沿 Z 抬高 1 米」
• 「在原点加一个立方体」
• 「用 bpy 给选中物体换个材质颜色」

能力

• 查询场景与物体信息
• 视口截图（便于 Agent「看见」当前画面）
• 常见变换与基础建模
• 在 Blender 内执行 bpy 代码
• 可选：Poly Haven / Sketchfab 等资产库（需在面板启用）

需保持 Blender 打开，且侧栏里的 DSH Bridge 已 Start。伴生设置页上的 HTTP 端口与插件 TCP 9876 是两回事。

问题及解决方案

现象	处理
找不到安装包	先点「安装 / 配置」，再点「打开安装包（zip）」
装错文件	只选 dsh_blender_bridge.zip，不要选解压后的源码目录或单独 .py
对话无响应	确认侧栏已 Start DSH Bridge；伴生状态为运行中
升级后异常	重新「从磁盘安装」覆盖 zip，禁用再启用扩展后重启 Bridge
Blender 版本过旧	使用 4.2+（推荐 5.x）