dsh-plugin-blender-3d

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-plugin-blender-3d

A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugin that lets the agent **drive 3D modeling** through a JSON bridge — create primitives, run boolean CSG, transform, assign materials/modifiers, query the scene, and export `STL`/`OBJ`/`PLY`/`GLTF`/`GLB`.

It bundles **two interchangeable runtimes** speaking the same protocol:

| Runtime | Needs Blender? | Engine | Use when |
| --- | --- | --- | --- |
| `headless_bridge.py` (default) | ❌ no | `trimesh` + `manifold3d` | headless servers, CI, the harness |
| `blender_ai_bridge/` add-on | ✅ Blender 3.0+ | `bpy` | you want full Blender power |

Point the tool at a running Blender (set `AIB_PORT` to the add-on's port) and the same commands upgrade to real Blender — no code change.

## Install

```sh
dsh plugin --profile web add dsh-plugin-blender-3d
```

Restart `dsh web` (or let HMR pick it up). The plugin registers two model-facing tools:

- **`blender_model`** — `{ command, args }` → JSON result. Commands: `create_shape`, `boolean`, `transform`, `duplicate`, `delete`, `rename`, `material`, `modifier`, `mesh_edit`, `scene`, `selection`, `scene_clear`, `camera`, `light`, `render`, `export`, `import`, `script`, `command`, `document`.
- **`blender_scene`** — lightweight scene summary (names/types/counts, no mesh data).

It also contributes the **`blender-3d-modeling`** skill (auto-installed into `$DSH_HOME/skills` on first load if absent).

## OOM-safe by design

Heavy geometry **never** enters the Node/JSON tool channel. Exports return a `file_path`; the agent reads the model from disk with its own file tools. This is the fix for the Node `Ineffective mark-compacts near heap limit` crash that occurs when full meshes are stuffed into JSON.

## Configuration

| Env / config | Default | Meaning |
| --- | --- | --- |
| `AIB_PORT` | `13082` | bridge port (set to the add-on port to drive real Blender) |
| `AIB_HOST` | `127.0.0.1` | bridge host |
| `AIB_PYTHON` | `python3` | interpreter for the headless bridge |

## Headless runtime deps

```sh
pip install numpy trimesh manifold3d
```

## Publish to the marketplace

See [`PUBLISH.md`](./PUBLISH.md). TL;DR: `npm publish` → open a PR to
[`awesome-dsh-plugin/awesome-dsh-plugin`](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
adding [`registry-entry.json`](./registry-entry.json) to the list.

## License

MIT

## Example

```sh
node examples/carve_block.mjs   # box minus sphere -> carved.stl
```