前言¶
在 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/...;资料明确写明验收工具不上传文件,工程留在本地。
工作流概要:
SKILL.md做路由并设定 D1–D4 循环。preflight.py分类为proceed、proceed_core、ask或block。load_router.py按 preflight 结果生成加载计划,仅加载选中模块;proceed_core只加载核心文档。source_audit.py在模块交付前检查标准/书籍/论文的 TTL、撤回/替代及管辖区块缺失。- 验收脚本对本机
.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。