dsh-blender-plugin：让 DeepSeek Harness 直连驱动 Blender 的实时控制插件
sixtysevenlf/dsh-blender-plugin
让 AI 模型通过直连 TCP 通道实时驱动 Blender 的 DSH plugin：15 个工具覆盖视口取帧、任意角度渲染、内循环搜索、渲染性能剖析与无头卸载。
dsh-blender-plugin 通过一条直连 TCP 通道，把 Blender 的视口画面、场景编辑与渲染调优变成 DeepSeek Harness 中模型可直接调用的工具，不再需要截图喂提示词或额外转发服务。它提供任意角度渲染、内循环搜索、渲染性能剖析、安全减面、无头进程卸载与契约层规划等能力，模型侧接口冻结为 15 个工具，规划通道覆盖 28 个族、183 个操作。判定是否装好只有一个标准：视口工具的 doctor 操作返回 kind=ok。插件由 sixtysevenlf 维护，采用 BSD-3-Clause 协议。
如何安装
dsh plugin --profile <your-profile> add github:sixtysevenlf/dsh-blender-plugin--profile 换成你本机实际使用的 profile 名（ls ~/.dsh/profiles/ 可查看目录名）：浏览器版通常是 web，桌面版通常是 desktop 或 desktop-NNN。
- 分类
- 工具与能力
- 平台
- DSH Plugin
- 作者
- sixtysevenlf
- 分发方式
- 插件
dsh-blender-plugin 核心特性
dsh-blender-plugin 仓库简介
它是做什么的？
DSH × Blender 直连实时插件是 DeepSeek Harness（DSH）的 Blender 控制插件，让 AI 模型通过一条直连 TCP 通道真正驱动 Blender。它解决的是「模型只能靠截图猜、靠 MCP 服务器转发」的麻烦，把视口画面、场景编辑、渲染调优都变成模型可直接调用的工具。插件由 sixtysevenlf 维护，采用 BSD-3-Clause 协议，v1.0 是首个稳定版，模型侧接口冻结为 15 个工具，规划通道则暴露 28 个族、183 个操作。
核心功能
- 视口与任意角度渲染：无需相机对象即可从指定位置和朝向出图，用户自己的视口不受影响，单次耗时约 85–280 毫秒。
- 内循环搜索：在插件内部跑成千上万次迭代而完全不消耗模型轮次，把「试参数」变成一次调用。
- 渲染性能剖析与预设：分析渲染瓶颈并给出可复用的性能预设，单次分析约 10–20 秒。
- 安全减面与几何优化：对物体做减面时安全合并、零几何损失，约每物体 1.4 毫秒。
- 无头进程卸载：把重渲染和批量几何计算丢给独立无头进程，冷启动约 0.9–1.2 秒，并支持热会话复用。
- 契约层与规划器：通过 blender_rt_plan 做判定、校验与导出，配合 AABB 扫描与 BVH 加速处理上百个物体。
怎么使用这个插件？
在 DSH 中启用插件并让 Blender 端插件与后端通道就绪后，模型即可直接调用这些工具：先用视口工具看一眼当前画面，再用编辑工具改一处并立即验证，需要判断「动没动、对不对」时用观察工具抓取时间窗口内的若干帧。重活交给无头进程或批量作业，长任务可回滚、可存参数预设，也能透传任意 Blender 插件命令。判定是否装好只有一个标准：视口工具的 doctor 操作必须返回 kind=ok，否则按 README 的排障章节逐条处理。
报错怎么排查？
插件把「没装好」定义得非常明确：doctor 检查未返回 kind=ok 就视为未安装成功，此时应按官方 README 的排障章节逐项核对，而不是反复重试。README 还建议让 AI 代理在动手前先读需求、安装与排障三节以及 AGENTS.md，再执行 doctor 自检，避免凭猜测操作。
本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准：sixtysevenlf/dsh-blender-plugin。插件是安装时就在你机器上运行的第三方代码；收录不代表背书——安装前请自行审阅源码。
DSH Plugin 常见问题
