资讯动态

WSL / Windows / macOS 三平台部署:dsh-blender-plugin 部署 SOP 与自检排障清单

发布时间:2026/10/23 7:24:48 来源:尧图企业网站定制
【免费下载链接】dsh-blender-pluginDSH × Blender 直连实时插件15 个模型工具让 AI 驱动 GUI Blenderv2.5 活动状态置顶并可一键暂停 AI原生选中/集合/子元素直送 DSH随包建模 skill支持 WSL / Windows / macOS。项目地址https://gitcode.com/gh_mirrors/ds/dsh-blender-plugin点击查看免费下载本文带你完成dsh-blender-plugin在 WSL、Windows、macOS 三个平台的部署把这款 DSH × Blender 直连实时插件装进 DSH profile接通 GUI 或无头通路再用一张自检排障清单完成验收。插件提供15 个模型工具装好全程约 10–15 分钟每一步都有可验证的判据失败也有明确的下一步。当前版本口径插件v2.6.0· plan catalog33 family / 217 op· addonv1.10protocol 11· 后端127.0.0.1:9877/ addon127.0.0.1:9876。 唯一验收判据GUI 路线doctor返回kindok纯无头路线worker(start)see能回一帧图。一、部署前5 条前置条件一次确认#需要什么怎么确认1DSH插件装在 DSH 的 profile 里dsh --version有输出2Blender 4.x / 5.xGUI 最方便无 GUI 也可能打开窗口或能跑blender -b3本仓附带 addon唯一支持addon/dsh_blender_bridge.pyv1.10 / protocol 114Nodenode -v有输出5端口9877后端/9876addon空闲见下文排障表⚠️ 旧的MCP for Blenderaddon 自 v2.3 起不再支持如已安装请先停用迁移要点见 MIGRATIONS.md。二、三平台差异速览各要配什么插件的配置优先级为环境变量 → 配置文件 → 自动探测 → 内置默认值完整规则见 docs/配置参考.md。三个平台的关键差异如下Windows原生blender 可执行文件自动探测%ProgramFiles%\Blender Foundation\Blender*\blender.exe与 Steam 路径工作目录默认取%LOCALAPPDATA%\dsh-blender-rt找不到时可用set DSH_BLENDER_EXED:\Program Files\Blender Foundation\Blender 5.2\blender.exe显式指定。WSLDSH 在 WSLBlender 在 Windows —— 推荐自动扫描/mnt/{c,d,e,f}/Program Files/Blender Foundation/Blender*/blender.exe及各盘 SteamLibrary 路径工作目录必须配 Windows 形式路径如D:\work\dsh-blender-rt插件会自动映射成/mnt/d/...❌ 不要把workDir配成 WSL 内部路径如/home/me/xWindows 侧 Blender 只能通过 UNC 访问而UNC 写入会静默失败❌ 别配到只读挂载WSL 里/mnt/c通常只读。macOS自动探测/Applications/Blender*.app/Contents/MacOS/Blender任意版本名如Blender 4.2.app及挂载卷/Volumes/*/Applications/…工作目录默认~/.dsh-blender-rt持久目录不会像tmpdir那样被清理宿主与 Blender 同机同 OS所有跨 OS 路径改写都必须是恒等——项目为此提供了回归自检 tests/mac_selftest.mjs 与原生 Linux 版 tests/linux_selftest.mjs防止/Users/...被错拼成\\wsl.localhost\...这类 Blender 打不开的串。 任何平台都可以复制样例配置快速上手cp dsh-blender.config.example.json dsh-blender.config.json样例见 dsh-blender.config.example.json支持的键包括workDir、blenderExe、addonPort、httpPort、leaseTtlMs等。三、一键安装步骤clone → addon → 装进 profile → 重启1. 拿到插件本仓已提交 lib/一般不用构建git clone https://gitcode.com/gh_mirrors/ds/dsh-blender-plugin dsh-blender-plugin cd dsh-blender-plugin ls lib/index.js # 有这个文件就不用构建只有要改src/时才需要构建DSH_CHECKOUT/path/to/dsh-harness bash scripts/build.sh。2. Blender 侧装 addon 并 Connect人工一步Blender →Edit ▸ Preferences ▸ Add-ons ▸ Install...→ 选择addon/dsh_blender_bridge.py启用DSH Blender Bridgev1.103D 视口按N→「DSH Blender Bridge」面板 →Connect默认127.0.0.1:9876自检blender_rt_cmd(nameget_addon_info)应返回addon_version[1,10]、protocol11。3. 装进 DSH profilebundle 方式ln -s /path/to/dsh-blender-plugin profile/node_modules/dsh-external/dsh-blender-plugin在 profile 的package.json中加两行dependencies里加dsh-external/dsh-blender-plugin: link:/path/to/dsh-blender-plugindsh.profile.bundles里加dsh-external/dsh-blender-plugin。然后dsh --profile profile --dump-config # 预演能看到本插件即成功最后重启 DSH插件是启动时装载的。重启后会话技能目录会自动多出blender-modeling建模 skill无需单独下载。4. 拉起并复核blender_viewport(oplaunch) # 一键拉起 GUI Blender 并自动 Connect幂等也可以直接把手动流程交给 AI把 docs/AI-安装提示词.md 粘给能执行命令的 AI 即可完整人工版见 docs/给第三方的安装清单.md。四、部署后自检清单全绿才算装好curl -sS http://127.0.0.1:9877/health # 后端活着 curl -sS http://127.0.0.1:9877/doctor # ⭐ GUI 路线唯一判据kindokDSH 侧再补几条工具级自检自检项期望结果blender_rt_plan(opcatalog)33 family / 217 opblender_rt_commands()addon39 条命令 5 个集成状态blender_rt_perf(opstatus)能返回engine字段默认BLENDER_EEVEEblender_rt_plan(opqc_self_check)iou_self 1.0且渲染产出不是黑图blender_rt_worker(opstart)→opsee纯无头路线能回一帧图即通道可用✅ 通用项 你所选路线GUI / 无头全部满足才算装好。逐工具上手见 docs/操作教程.md。五、自检排障清单常见故障对照表症状常见原因处置工具报后端不可用Blender 没启动 / addon 没 Connect / 后端没起来blender_viewport(oplaunch)或opstartdoctor报blender-unreachableaddon 不是本仓 v1.10或没 Connect停用旧 addon → 启用本仓 addon →oprestartdoctor报main-thread-busy主线程被渲染 / 模态操作占住等它空下来或改走blender_rt_headless/blender_rt_worker工具数不是 15、catalog 不是 33/217装完 v2.6.0 后没重启 DSH重启 DSH--dump-config确认 bundle 已加载写操作 409leased别的会话持有写租约blender_viewport(opwho)看持有者别强抢WSL 下产物读不到workDir配成了 WSL 内部路径UNC 静默失败改配 Windows 形式路径/doctor的workDir.shared可自证渲染暗部纯黑Shader to RGB只含直接光见 docs/EEVEE-工作要点.md §2双 Background Is Camera Ray 或加环境灯渲染很慢EEVEE 首帧着色器编译约 16 s用blender_rt_worker热会话QC 分数与历史不可比换了引擎EEVEE ↔ Cycles判据只在同引擎内可比看回执engine_at_qcvalue is not lossless JSON宿主与插件回执契约不匹配升级 v2.6.0 后重启 DSH更细的 SOP 与 AI 执行标准作业程序见 docs/部署SOP.md。六、延伸阅读配置项 引擎索引docs/配置参考.md工具逐个上手与三通道心智模型docs/操作教程.md无头路线的设计决策docs/headless优先-路线决定.md离线自检不需要 Blendernpm test全绿即为通过 记住这条主线先探测、别猜—— 每一步都有自检命令卡住就先跑自检doctor再往下走验收以kindok为唯一判据不要凭看起来通了就宣布装好。赞分享【免费下载链接】dsh-blender-pluginDSH × Blender 直连实时插件15 个模型工具让 AI 驱动 GUI Blenderv2.5 活动状态置顶并可一键暂停 AI原生选中/集合/子元素直送 DSH随包建模 skill支持 WSL / Windows / macOS。项目地址https://gitcode.com/gh_mirrors/ds/dsh-blender-plugin点击查看免费下载相关推荐如何用14B参数模型让你的角色动画制作变得简单又专业如何用14B参数模型让你的角色动画制作变得简单又专业 你是否曾经看着那些精美的角色动画心想这需要多么复杂的软件和专业技能才能完成或者你曾经尝试过传统动基础模型计算机视觉跨平台部署paqet指南Linux、macOS与Windows Npcap配置清单跨平台部署paqet指南Linux、macOS与Windows Npcap配置清单 paqet 是一款基于 原始数据包raw packets 的代理工具dsh-wallpaper-engine 三平台原生指南Windows/macOS/Linux 同一包安装与常见故障排查清单dsh wallpaper engine 三平台原生指南Windows/macOS/Linux 同一包安装与常见故障排查清单 dsh wallpaper en上一篇Orleans代码重构工具自动化重构与安全检查下一篇终极DINOv2实战指南从零开始掌握自监督视觉Transformer创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑