# DSH × Blender 直连实时插件

> DSH（DeepSeek Harness）插件：让 AI 模型通过一条 TCP 直连通道驱动 **GUI Blender** —— 看视口 / 改场景 / 连续观察 / 内环搜索 / 渲染性能 / 对象精简 / 无头跑重活 / 事务回滚 / 契约层与规划器，共 15 个工具（v2.3 删除视口面板与 `blender_rt_pick`）。
> 本包**附带且只支持** Blender addon `addon/dsh_blender_bridge.py`（v1.8 / protocol 11）；旧 `MCP for Blender` 自 v2.3 起不再支持（迁移见 MIGRATIONS.md）。
> 当前版本 **v2.3.0**：随包 `blender-modeling` skill 自动注册（v2.2）+ **Blender 原生选中 → DSH 草稿**与统一 human/agent activity 判定（v2.3，addon v1.8+）。

## Blender 原生选中 → DSH（v2.3）

- 在 Blender 视口里原生选中 → `N` ›「DSH Blender Bridge」› **Selection → DSH** ›「发送选中到 DSH」；
  选中会进 **DSH 当前会话草稿**（不自动发送）。N 面板两种模式：**多选** / **集合**（大装配体整组发）。
  v2.3 已删除 DSH 侧视口面板与 `blender_rt_pick`；`@` 提及保留。
- addon 新命令（常驻，总命令 39 = 24 常驻 + 15 集成门控）：
  `get_activity_state`（`idle/human/agent/both`，查询自身不计入 agent）· `get_selection` · `send_selection_to_dsh` ·
  `get_collections`（集合列表+件数）· `send_collection_to_dsh`（整组发送，大装配体免逐个选）。
- 后端新路由（零 Blender 往返）：`POST /host/selection` · `GET /host/selection/latest` · `POST /host/selection/consume`；
  诊断字段 `last_consume` 会如实记录"是否插入草稿"。
- 契约：`docs/宿主集成-接口契约-v2.3增补.md`（判据 S1–S8）；已知边界：TUI 暂不支持草稿插入、必须重启 DSH。

## 安装（先读，别猜）

- [README（中文）](https://raw.githubusercontent.com/sixtysevenlf/dsh-blender-plugin/main/README.zh-CN.md): §2 前置条件（5 条）· §3 安装（5 步）· §7 常见故障 —— **安装前必读**
- [README (English)](https://raw.githubusercontent.com/sixtysevenlf/dsh-blender-plugin/main/README.md)
- [AI 安装提示词](https://raw.githubusercontent.com/sixtysevenlf/dsh-blender-plugin/main/docs/AI-安装提示词.md): 可直接粘贴给 AI 助手
- [AGENTS.md](https://raw.githubusercontent.com/sixtysevenlf/dsh-blender-plugin/main/AGENTS.md): 助手自动加载的仓库约定
- [配置参考](https://raw.githubusercontent.com/sixtysevenlf/dsh-blender-plugin/main/docs/配置参考.md): 配置文件 / 环境变量 / 路径映射 / 自动探测

## 随包 skill（v2.2.0+，无需另装）

- **`blender-modeling`** —— 建模 / 装配流程与验收判据（选形决策树 · 24 条编号配方 · 六条必踩的坑 · 数值门清单 · 多 Agent 分工协议）。
  随包在 `skills/blender-modeling/`，DSH 启动时自动注册为 `bundled` skill（rank 600；用户 `~/.dsh/skills` 的 400 副本仍优先）。
  独立仓库 <https://github.com/sixtysevenlf/dsh-skill-blender-modeling> 仅作非 DSH 宿主的镜像。

## 验收判据（没到就是没装好）

- `curl -sS http://127.0.0.1:9877/doctor` → `kind=ok`
- `blender_viewport(op="doctor")` → `kind=ok`；`blender_rt_see(max_size=560)` → 能回一帧图

## 文档

- [操作教程](https://raw.githubusercontent.com/sixtysevenlf/dsh-blender-plugin/main/docs/操作教程.md): 从零上手 → 连通 → 工具 → 配方 → 排错
- [假设驱动建模 cookbook](https://raw.githubusercontent.com/sixtysevenlf/dsh-blender-plugin/main/docs/假设驱动建模-cookbook.md): 假设 / 区间 / 证据 / 三态判定
- [CHANGELOG](https://raw.githubusercontent.com/sixtysevenlf/dsh-blender-plugin/main/CHANGELOG.md): 逐版实测数据
