Repolode
sixtysevenlf

sixtysevenlf/dsh-blender-plugin

让 AI 模型通过直连 TCP 通道操控正在运行的 Blender,提供 16 个工具,覆盖视口截图、场景编辑与无头渲染。

Star
715
Fork
32
未关闭 Issue
10
最近提交
昨天

这是什么?

DSH x Blender 是 DSH(DeepSeek Harness)智能体环境的一个插件,让 AI 模型通过本地 TCP 通道直接操控 Blender,无需 MCP 服务器。随附的 Blender 插件监听 127.0.0.1:9876,Node.js 后端监听 127.0.0.1:9877 负责转发指令,模型因此可以截取 3D 视口、在 Blender 主线程执行 Python、从自定义视角渲染,并运行迭代式参数搜索。

除了实时编辑场景,插件还提供渲染性能分析与预设配置、安全的对象减面、用于重渲染和批量几何处理的无头 `blender -b` 进程、支持快照与对象级回滚的事务功能、可复用的预设库,以及面向长任务的作业层。规划工具把契约检查、网格审计、装配门禁和导出校验归入 28 个系列、186 个操作。

实时通道需要 Blender 4.x 或 5.x 并保持图形界面运行,另需 Node.js 20 及以上版本和 DSH 环境。插件支持 WSL 调用 Windows 版 Blender、原生 Windows、原生 Linux 与 macOS,采用 BSD-3-Clause 许可证。

核心功能

  • 01可截取用户视口或任意自定义视角的画面,且不改动场景。
  • 02通过持久内核在 Blender 主线程执行 Python,支持多步编辑。
  • 03在 Blender 内运行带迭代次数与时间上限的参数搜索循环。
  • 04分析渲染设置并应用持久化数据与降噪预设,支持还原。
  • 05将重渲染和批量几何处理分流到无头 Blender 进程。
  • 06提供文件级快照与对象级事务,用于回滚操作。

适用场景

  • 让 AI 智能体在打开的 Blender 场景中建模、调整并验证对象。
  • 运行参数扫描,使模型轮廓贴合参考图。
  • 在无头 Blender 中批量渲染或处理几何,同时保持图形界面可用。
  • 在 3D 打印前检查机械装配的间隙与干涉。

快速上手

  1. 1

    克隆仓库并进入目录

    cd dsh-blender-plugin
  2. 2

    将插件作为 DSH 配置包安装(创建符号链接,在配置的 package.json 中添加链接,然后重启 DSH)

  3. 3

    启动 Blender,连接随附的 DSH Blender Bridge 插件,然后用 doctor 接口检查安装是否成功

    curl -sS http://127.0.0.1:9877/doctor

使用前须知

  • 需要以 GUI 模式运行 Blender,实时通道不支持后台模式。
  • 需要 DeepSeek Harness(DSH)宿主环境以及 Node.js 20 或更高版本。
  • 不再支持上游 MCP for Blender 插件,必须改用随附的插件。

标签

常见问题

dsh-blender-plugin 是什么?
让 AI 模型通过直连 TCP 通道操控正在运行的 Blender,提供 16 个工具,覆盖视口截图、场景编辑与无头渲染。 DSH x Blender 是 DSH(DeepSeek Harness)智能体环境的一个插件,让 AI 模型通过本地 TCP 通道直接操控 Blender,无需 MCP 服务器。随附的 Blender 插件监听 127.0.0.1:9876,Node.js 后端监听 127.0.0.1:9877 负责转发指令,模型因此可以截取 3D 视口、在 Blender 主线程执行 Python、从自定义视角渲染,并运行迭代式参数搜索。
dsh-blender-plugin 可以免费使用吗?用的什么许可证?
dsh-blender-plugin 以 BSD-3-Clause 许可证开源。用于商业产品前,请先确认许可证条款。
dsh-blender-plugin 还在维护吗?
活跃维护中。dsh-blender-plugin 最近一次提交是在 2026年10月19日。
dsh-blender-plugin 适合用来做什么?
让 AI 智能体在打开的 Blender 场景中建模、调整并验证对象。 运行参数扫描,使模型轮廓贴合参考图。 在无头 Blender 中批量渲染或处理几何,同时保持图形界面可用。 在 3D 打印前检查机械装配的间隙与干涉。
dsh-blender-plugin 怎么安装和运行?
克隆仓库并进入目录: cd dsh-blender-plugin 将插件作为 DSH 配置包安装(创建符号链接,在配置的 package.json 中添加链接,然后重启 DSH) 启动 Blender,连接随附的 DSH Blender Bridge 插件,然后用 doctor 接口检查安装是否成功: curl -sS http://127.0.0.1:9877/doctor
在哪里获取 dsh-blender-plugin?
源代码和安装说明在 GitHub 上:https://github.com/sixtysevenlf/dsh-blender-plugin

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目