dsh-blender-bridge

DSH 的 Blender 插件，通过官方 MCP 客户端提供场景查询、视口截图、bpy 执行、场景导出及 Poly Haven / Sketchfab 资源工具。版本 0.1.2。

安装与使用

需要 Node.js 22+、带有 @deepseek-ai/dsh-mcp-client 与 @deepseek-ai/dsh-home-paths 的 DSH，以及本机 Blender 4.2+ / 5.x。官方运行时验证基线为 DSH 0.2.1-alpha.3。

1. 在 NanoAI 插件平台找到 Blender 桥并安装到当前 DSH profile，也可使用官方 dsh plugin 安装下载的 npm 包。安装包已包含 Host、Web Client、技能和 Blender 扩展 ZIP，不需要执行构建脚本。
2. 启用插件后，在会话中调用 blender_addon_path，取得 zipPath。ZIP 位于本插件的 server/addon/dsh_blender_bridge.zip。
3. 在 Blender 的“偏好设置 → 扩展 → 从磁盘安装”中选择该 ZIP，启用扩展。
4. 打开 3D 视图侧栏（N），选择 DSH → Start DSH Bridge。默认 TCP 地址为 127.0.0.1:9876。
5. 在 DSH 中调用 blender_status，确认连接后使用场景和建模工具。

插件详情页显示服务状态，可设置 HTTP 端口和自动启动。默认 HTTP 端口为 39210；被占用时自动选择空闲端口并使用实际地址连接 MCP。保存端口或自动启动设置立即生效；关闭自动启动会停止服务并释放工具，重新启用后恢复。HTTP 端口与 Blender 的 TCP 9876 是两个不同端口。

生命周期与数据

Host 通过 Cordis 管理子进程，在健康检查成功后创建属于当前插件的官方 MCP 客户端。停用、卸载或更改端口会清理连接与子进程。插件不会改写 profile 配置文件。

设置保存在 $DSH_HOME/companion-data/blender-bridge/settings.json，沿用旧版本位置；未设置 DSH_HOME 时遵循官方默认目录 ~/.dsh。内置 blender-bridge 技能直接注册到 DSH 技能服务，停用插件时同步移除，不复制到共享技能目录。

从旧版升级时，如果以前自动写入的 dsh-blender-bridge-mcp 或 desktop-mcp-blender 条目仍存在，请在对应 profile 的配置中删除该旧的独立 MCP 条目后重启 DSH。新版本由插件自行创建连接；保留旧条目会重复占用 blender 工具命名空间。以前复制到共享技能目录的同名技能可按需手动删除。升级不会自动修改这些已有用户文件。

Blender TCP 目标可通过启动 DSH 前设置 DSH_BLENDER_HOST、DSH_BLENDER_PORT 调整。Poly Haven / Sketchfab 需要在 Blender 的 DSH 面板启用对应集成，并让 Blender Python 可导入 requests。

权限

此插件以本机用户身份启动 Node 子进程并监听本机回环 HTTP 端口。工具可通过 Blender 执行 Python、修改场景、读写导入/导出文件，并根据所选资源集成访问网络。仅在你信任的本机 Blender 环境启用。

开发与验证

npm test
npm pack --ignore-scripts

测试使用临时设置目录和模拟 Blender TCP 响应，检查 MCP 协议、官方客户端工具发现、子进程启停与清理，不修改现有 Blender 场景。Web 设置页随包交付为官方 window.__ModuleLoader__ 模块，无需单独构建。实际 Blender GUI、真实资源库下载和 macOS/Linux 实机行为需要在目标设备验证。

官方契约依据：DSH 安装包中的 @deepseek-ai/dsh-package-manifest、@deepseek-ai/cordis、@deepseek-ai/dsh-mcp-client、@deepseek-ai/dsh-skill 和 @deepseek-ai/dsh-client-ui-plugin-manager；上游项目为 deepseek-ai/deepseek-harness。

许可

MIT。Blender 扩展来自 ahujasid/mcp-for-blender，保留原有 ZIP；完整许可与第三方说明随包提供。