blender-mentor:把 DSH 变成 Blender 全栈导师与技监

前言

在 DSH 或 Cursor 里问「这段走路循环哪里不对」,常见结果是泛泛的建模建议,缺少可对照的评分尺度和可执行的验收步骤。Blender 侧又有大量 .blend 资产、曲线与渲染结果需要本地校验,单靠对话很难形成「教学 → 自评 → 修清单 → 机验」的闭环。

下面介绍社区插件 blender-mentor(维护者 Memory175,GitHub 仓库 Memory175/blender-mentor)。它把 Agent Skill 的 playbook 挂进 DSH,让智能体按固定流程做水平诊断、结构化教学、0–3 分制评分,并在本机对 .blend 跑资产与动画相关的验收脚本。需要说明的是:这不是 Blender 插件(add-on),不会替你操作 Blender 界面;本机仍需安装 Blender 才能打开工程并执行验收。

这是什么

blender-mentor 的定位是:把 Claude Code / DSH / Cursor 等客户端变成「资深 Blender 导师 + 技术导演」——诊断学员层级、按模块授课、用 rubric 打分,并对资产、曲线、渲染、ESD 次级动画与生物力学等做机器验收(README 中的 ESD/BIO 即与此相关)。

在 SkillHub 目录中归类为模型推理;仓库当前星标为 0。插件通过 package.json 声明 DSH bundle patch(cordis.patch.yml),挂载打包后的 skills/blender-mentor/;许可证为 MIT(见仓库 LICENSE)。

核心能力(资料已列项)

导师行为与交付循环

组件 作用
导师行为 L0–L3 水平诊断;explain / coach / accept / firefight / review 等模式
D1–D4 交付环 交付 → 自评 → P0/P1/P2 修清单 → 明确下一步问题
0–3 rubric 关键否决项、打分锚点、自评模板(详见 references/rubric.md)

评分含义简述:0 表示关键项否决交付;2 表示可交付(如走路循环接触帧锁定、无穿插);3 表示可进生产(在 2 的基础上满足如脚跟滚动、可复用步频等锚点)。

课程与工程检查

  • M0–M6 课程:建模与拓扑 → UV/材质/灯光/渲染 → 动画/绑定 → 物理/几何节点/管线。
  • ENG-001 工程预检:稳定性、壁厚、拔模、悬垂/支撑、干涉、间隙等。
  • 交付 QA 门:地面/坐标、网格/UV、相机/导出、专业边界检查。
  • 知识库:130 条常见误区 + 40 条红线(README 表格)。

可执行工具与验收

仓库提供 24 个可执行工具,包括 6 个 .blend 验收脚本、工程预检、模块治理(preflight/lint/conflict/claim audit/self-audit index)、来源治理(audit/refresh)、回归/路由工具等。验收通过无头 Blender 在本机执行,例如 blender -b ... --python scripts/...;资料明确写明验收工具不上传文件,工程留在本地。

工作流概要:

  1. SKILL.md 做路由并设定 D1–D4 循环。
  2. preflight.py 分类为 proceed、proceed_core、ask 或 block。
  3. load_router.py 按 preflight 结果生成加载计划,仅加载选中模块;proceed_core 只加载核心文档。
  4. source_audit.py 在模块交付前检查标准/书籍/论文的 TTL、撤回/替代及管辖区块缺失。
  5. 验收脚本对本机 .blend 运行。

实验性室内模块 INT-001、INT-002 及室内建模规则(需独立 INT-* 模块并声明 styles/layouts)在 README 中有说明,部分尺寸与来源仍标注为 pending。

环境要求

依赖 用途
Blender 4.2 LTS / 5.x .blend 验收脚本
Python 3 selftest.py、persona_lint.py、load_router.py、preflight.py 等
Node.js ^22.19.0 \|\| >=24.0.0 DSH 插件适配(package.json engines)
可选:Shell 或 Blender MCP/RT 桥接 自动执行脚本;无桥接时需手动在 Scripting 或终端执行命令

安装与启用

插件以当前 dsh 进程权限运行;安装前请自行审阅仓库源码与 MIT 许可证。DeepSeek Harness 生态强调「一切皆插件」;SkillHub 目录页 为社区站点,与 DeepSeek / 幻方无官方从属关系。

DSH 插件市场(资料原文)

目录上架通过后,可使用:

dsh plugin --profile web add github:Memory175/blender-mentor

package.json 当前版本为 5.16.1;通过 dsh.bundle.patch 指向 cordis.patch.yml,由 Cordis skill-filesystem provider 挂载 bundled skill。

免克隆安装包

若不想在文档流程里手动拉仓库,可从 最新 Release 下载并运行附带的 dsh-install.ps1(Windows)或 dsh-install.sh(Linux / macOS / WSL)。README 中亦给出在已克隆仓库内执行 dsh/install.ps1 或 dsh/install.sh 的方式;按你环境选择其一即可。

启用后如何对话

新开一轮 Agent 会话,可用 README 示例起手:

Use blender-mentor to walk me through M1 modeling and topology.

在 Cursor 等客户端也可将仓库中的 SKILL.md 作为 Skill 入口(例如 @SKILL.md 或项目规则引用)。

典型交互长什么样

README 给出了一段 review 模式示例:用户要求按 rubric 评走路循环并给出 P0/P1/P2 清单;导师返回 L2、分数、关键问题(如 foot sliding)分级修复项,以及 asset_gate、curve_audit、render_probe 等验收摘要。这类输出依赖本机能否实际跑验收脚本,而不是仅生成文字点评。

适用场景与注意

更适合:需要在 DSH 里系统学 Blender 全栈(建模到管线)、希望交付物有统一 rubric 与 P0/P1/P2 修清单、并愿意在本机用 Blender 做 .blend 验收的学习者与小型团队。

务必注意:

  • 不是 Blender add-on,不能替代你在 Blender 里的手工操作;无 Shell/Blender 桥接时,智能体只能给出命令,由你复制执行。
  • 机验与预检脚本在本机执行,安全边界取决于你对 dsh 与仓库脚本的信任程度。
  • 实验性 INT 模块与部分来源数据尚未完备,涉及室内方案时应以模块内声明与 source_audit 结果为准。

结尾

blender-mentor 把教学节奏、评分尺度和本机 .blend 验收绑进一套 Agent Skill,适合已经使用 DSH、并本地安装 Blender 4.2 LTS / 5.x 的开发者。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库;中文说明见仓库 README.zh-CN.md。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye