企业官网建设流程全解析

dsh-blender-plugin（DSH × Blender 直连实时插件）把 AI 助手直接接进你正在使用的 Blender：AI 能实时查看你的场景、一步步建模、检查、验收并导出模型，全程只需约 40 分钟即可完成安装。本文是一份面向新手的快速开始教程，带你从零装好这个 AI 直连 Blender 插件，并跑通第一帧画面。

🧩 这个插件能帮你做什么？

简单来说，安装后 AI 就多了一双"手"和一双"眼"，可以直接操作真实 Blender 会话：

插件提供15 个模型工具，能力目录覆盖 33 family / 217 op（当前版本 v2.6.0）。工具明细与源码入口可参考 README.zh-CN.md 和 runtime/ 目录。

📋 安装前：4 条前置条件缺一不可

动手前先花 2 分钟核对以下清单（来自 docs/给第三方的安装清单.md）：

1. DSH（DeepSeek Harness）已安装可用 ——dsh --version有输出；
2. Node.js 20+——node -v有输出（插件后端运行环境）；
3. Blender 4.x / 5.x—— GUI 版最方便；没有图形界面也能走无头模式；
4. 端口空闲——9876（addon 通道）与9877（插件后端），默认都监听本机127.0.0.1。

⚠️ 重要提醒：Blender 侧只能安装本仓库自带的 addon（addon/dsh_blender_bridge.py），不要装 MCP for Blender 或任何其他 Blender 插件，否则会抢占 9876 端口导致连不上。详见 addon/README.md。

🤖 方案 A：让 AI 帮你装（最省事）

如果你用的 AI 助手能执行命令，直接把仓库里准备好的安装提示词交给它即可。这份提示词的核心逻辑是：先读文档 → 再安装 → 按判据验收，没验收不许宣布成功，全文见 docs/AI-安装提示词.md。

简化版提示词模板：

请帮我安装 DSH × Blender 插件（仓库：dsh-blender-plugin）： 1. 先完整阅读 README.zh-CN.md 的前置条件与安装章节，逐条核对； 2. 先安装并启用 addon/dsh_blender_bridge.py，不要用其他 Blender addon； 3. 按 bundle 方式装进我的 DSH profile，然后重启 DSH； 4. 最后必须验收：doctor 返回 kind=ok，且 blender_rt_see 能回一帧图。 没到判据不许说"安装成功"。

🔧 方案 B：手动安装 4 步走

第 1 步：获取插件仓库

git clone https://gitcode.com/gh_mirrors/ds/dsh-blender-plugin cd dsh-blender-plugin ls lib/index.js # 有这个文件就不用构建（仓库已提交构建产物）

仓库已提交lib/构建产物，普通用户无需构建；只有修改 src/ 源码时才需要执行scripts/build.sh。

第 2 步：安装 Blender 侧 addon 并连接

1. 打开 Blender →Edit ▸ Preferences ▸ Add-ons ▸ Install...，选择 addon/dsh_blender_bridge.py；
2. 勾选启用DSH Blender Bridge（v1.10 / protocol 11）；
3. 在 3D 视图按N打开右侧栏 → 找到「DSH Blender Bridge」面板 → 点击Connect（默认端口 9876）。

懒人操作：装完插件后直接调用blender_viewport(op="launch")，它会一键拉起 Blender、自动启用 addon 并 Connect，实测约 11 秒连上。

第 3 步：把插件装进 DSH profile（bundle 方式）

# ① 软链到 profile 的 node_modules ln -s /绝对路径/dsh-blender-plugin <profile>/node_modules/@dsh-external/dsh-blender-plugin

然后在 profile 的package.json中加两处：

{ "dependencies": { "@dsh-external/dsh-blender-plugin": "link:/绝对路径/dsh-blender-plugin" }, "dsh": { "profile": { "bundles": ["@dsh-external/dsh-blender-plugin"] } } }

预演装配并重启：

dsh --profile <profile> --dump-config # 能看到本插件即成功 # ② 重启 DSH（插件是启动时装载的模块，不重启不生效）

第 4 步：验收 —— doctor 返回 kind=ok 才算装好

GUI 路线只有一条验收判据：

curl -sS http://127.0.0.1:9877/health # 后端进程活着 curl -sS http://127.0.0.1:9877/doctor # ⭐ 唯一判据：kind=ok

在 DSH 会话里还可以跑一轮工具自检（完整脚本见 docs/AI-安装提示词.md §③）：

blender_rt_plan(op="catalog") # 应列出 33 family / 217 op blender_rt_see(max_size=560) # 应返回一张视口图，50–100 ms blender_rt_commands() # 应列出 addon 39 条命令

🌙没有图形界面？走交互式无头路线：blender_rt_worker(op="start")启动持久 worker，再op="see"能回一帧图即代表通道正常（此时 doctor 的 bpy 往返不可达属预期现象）。

🚀 装完先玩什么？新手三个动作

v2.5 起 N 面板活动状态置顶（AI 操作时显示红色警告），并有一键**「暂停 AI 操作」**按钮：暂停后写操作被拒绝、只读仍可用，恢复只能由人在 Blender 里点击，让你随时掌握主动权。

想让 AI 按标准流程建模，加载随包技能即可（v2.2.0 起随插件自动注册，无需另装）：

skill(name="blender-modeling")

技能全文与建模决策树见 skills/blender-modeling/SKILL.md。

🩺 常见问题快速排查

完整排障表（含处置命令）见 docs/给第三方的安装清单.md §5 与 docs/部署SOP.md。

📚 延伸阅读

装好只是开始，仓库里的文档足以支撑你走到"顺手"：

• 操作教程（从零到顺手）：docs/操作教程.md
• 配置参考（端口 / 工作目录 / 租约等）：docs/配置参考.md，样例配置见 dsh-blender.config.example.json
• 部署与自检标准流程：docs/部署SOP.md
• 版本变更记录：CHANGELOG.md
• 离线自检：在仓库根目录执行npm test即可验证安装完整性

按照本文走下来，你现在应该已经拥有一个能"看一眼 → 改一步 → 再确认"的 AI 直连 Blender 环境。接下来，试着对 AI 说一句："帮我在场景里建一个简单的小桌子，每步做完给我看画面"，体验 40 分钟安装换来的即时反馈吧 🎉