Blender

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

前提

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

安装

1. 安装 Blender 桥插件

dsh-blender-bridge 为单独发布的插件：在侧栏「插件」面板搜索安装并启用。打开插件详情页，在「Blender 桥」设置区可看服务状态、勾选「随 dsh 服务自动启动」、按需修改端口（留空使用默认 39210）并保存。

2. 在 Blender 里装扩展包

1. 取安装包路径：在对话里直接问「把 Blender 插件的安装包路径发给我」，Agent 会返回 dsh_blender_bridge.zip 的本机路径
2. 在 Blender：扩展 → 从磁盘安装，选择该 zip 文件（不要解压，也不要选单个 .py）
3. 启用 DSH Blender Bridge

若提示与官方扩展仓库目录相关的 WinError 3 … blender_org，一般可忽略，不影响本地 zip 安装。从旧版（单文件 .py）升级时，重新「从磁盘安装」覆盖 zip，再启用扩展。

3. 启动 Blender 内的桥

1. 打开要处理的 .blend 工程
2. 3D 视图按 N 打开侧栏 → DSH → Start DSH Bridge（默认 127.0.0.1:9876）
3. 确认插件详情页里「Blender 桥」状态为运行中

注意两个端口是两回事：插件详情页上的端口（默认 39210）是 Harness 一侧的桥接服务端口，可以改；9876 是 Blender 内扩展的 TCP 端口，固定不变。

可选：在 Blender 的 DSH 面板勾选 Poly Haven / Sketchfab 集成。需要 Blender 自带 Python 能 import requests，缺的话用 Blender 自带 pip 安装（python -m pip install requests，在 Blender 的 Python 环境下执行）。

使用示例

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

能力

• 场景查询：物体、材质、灯光、相机
• 视口截图（当前视角）
• 变换物体：移动 / 旋转 / 缩放
• 执行 bpy 片段（谨慎，Agent 应给出可审查的代码）
• 可选：Poly Haven / Sketchfab 资源导入

问题及解决方案

现象	先检查
不知道安装包在哪	先装好插件并启用，再在对话里问 Agent 要 dsh_blender_bridge.zip 的路径
对话里没有 Blender 工具	插件详情页里服务是否运行中；改过端口或刚装插件时，重启一次 dsh 服务，工具才进入会话
对话无响应 / 连不上	Blender 里是否已 Start DSH Bridge（N 侧栏 → DSH）；Blender 是否还开着那个工程
从旧版升级后异常	重新「从磁盘安装」zip 覆盖，禁用再启用扩展，重开 DSH Bridge
Blender 版本过旧	升级到 4.2+（推荐 5.x）