前言¶
在 DeepSeek Harness（DSH）里做 3D，常见做法是反复调用零散脚本或外部工具：场景状态不连续、改完难以对照渲染结果、从参考图重建时缺少独立验收环节。智能体很难在同一任务里「建模 → 观察 → 修正 → 沉淀可复用代码」。
dsh-3d 是维护者 OOOHS 发布的 DSH 工作流类插件，基于 CheshireJCat/blender（dsh-blender）扩展工具、技能与分析能力，把 Blender 变成智能体可长期编辑的 3D 创作环境，覆盖产品建模、场景组装、材质与灯光、动画、资产编辑以及从图像重建等任务。
这是什么¶
一句话定位：面向 DSH 的 Blender 插件，用于基于 Blender 的 3D 建模与图像重建（仓库描述与 SkillHub 简介一致）。
它在 dsh-blender 之上增加共享编辑状态、原生笔刷与视觉反馈、独立视觉评审，以及可在任务中改写与重放的项目工具。社区目录页：ooohs/dsh-3d；源码与文档：GitHub OOOHS/dsh-3d。
设计思路与工作区能力¶
下面分三块说明 README 中强调的机制，以及工作区具体提供什么。
持续改进：评审与可复用代码¶
资产本身和「怎么做」都可以迭代。图像重建场景下，独立的生成式视觉评审（GRM）会把渲染结果与参考图对比、描述差异并给出是否接受的判断；建模智能体可据此修改并再次提交。每次评审基于当前证据，并保存观察与结论。
智能体还可在任务中编写、调用、修改自己的工具，把有效操作保留为代码，供后续任务复用参数或重组流程。几何构建、网格编辑、笔刷、观察与交付可组合成可重放的程序。
工具扩展与技能裁剪¶
Python、网格编辑与原生笔刷共用同一 Blender 场景；工具反馈包括视图、局部前后对比图与度量变化，便于评估单次操作效果。主 skill 说明目标、能力、调用约定与完成标准， specialist 参考按需加载，减少固定流程对探索空间的占用。快照与检查点支持「试一种做法 → 观察 → 保留或回滚再试」。
工作区清单（README 原文归纳）¶
- 持久编辑：代码、网格操作与笔刷作用于同一资产；选择、编辑模式与工具设置在多次调用间保持；快照与检查点用于保存、恢复与对比候选方案。
- 广覆盖 Blender 能力：Python 可触及几何、曲线、修饰器、Geometry Nodes、材质、灯光、绑定与动画；原生控件支持网格选择、比例编辑、挤出与雕刻。
- 视觉动作反馈：视图控制、组件隔离、相机渲染、裁切与局部前后对比，支撑观察与纠错。
- 可复用项目工具：执行过程中编写与修订工具，下次调用加载最新源码；会话笔记保留使用条件与观察结果。
- 评审与交付：图像重建可走独立视觉评审；资产工具涵盖导入导出、结构检查、导出往返校验与动画帧采样。
仓库 package.json 当前版本为 0.2.3-dev.20；README「Made with DSH 3D」示例注明由两个独立 dsh 会话使用 dsh-3d dev.20 设计、建模并渲染（如 MERIDIAN 陶瓷杯、AURA 桌面风扇），提示与任务说明见 examples/dev20-showcase/。
安装与启用¶
环境要求（README Getting started）：Node.js 22.12+、pnpm、Blender 在 PATH 中或通过绝对路径配置、Python 3.10+（图像分析辅助脚本）。
在本地按仓库 README 取得源码并安装依赖后，使用下列命令注册插件并启动 Web 配置（命令与版本号来自 README，勿自行拼接 dsh plugin add github:owner/repo）：
cd dsh-3d
pnpm install --frozen-lockfile
npx @deepseek-ai/dsh@0.2.1-alpha.2 plugin --profile web add .
npx @deepseek-ai/dsh@0.2.1-alpha.2 plugin --profile web exec dsh-3d-setup
npx @deepseek-ai/dsh@0.2.1-alpha.2 web
（完整克隆与进入目录步骤见 GitHub README。）
Web 配置里插件显示为 DSH 3D (Development)。若在本插件与原版 dsh-blender 之间切换，README 要求同一时间只启用一个版本：先关闭当前版本，再开启另一个。
自定义 Blender 可执行文件时，在 web profile 的 cordis.patch.yml 中增加（路径替换为实际绝对路径）：
- id: dsh-3d
config:
blenderExecutable: /absolute/path/to/blender
模型提供商凭据应放在 dsh 环境或配置中；API 密钥与本地 .env 不要纳入版本控制。
典型用法：建模预设与会话¶
创建会话时可选择建模预设（README）：
- DSH 3D 建模（
dsh-3d-modeler）：直接使用 Python、原生编辑、笔刷与观察工具。 - DSH 3D 代码建模（
dsh-3d-code-modeler）：在run_code内通过await tools.name(...)组合授权工具，适合维护可重放程序；需要宿主支持程序化工具运行时。 - DSH 3D 原生建模实验（
dsh-3d-native-modeler）：基元、原生网格编辑与笔刷，用于动作空间对比实验。
README 示例任务表述：「Create a ceramic mug with a small whale relief. Save the editable project, a GLB and renders from several viewpoints.」智能体自行选择方法、观察渲染并修订资产。
建模与评审分别在 agents/modeler.json 与 agents/reviewer.json 中配置，可通过 modelerAgent、reviewerAgent 覆盖。默认使用 deepseek-official / deepseek-flash，建模为高 reasoning effort、评审为低；会话里显式指定的模型仍生效。
连续编辑与工具入口¶
blender_execute 在当前场景中运行 Python；blender_scene 用于创建、打开、检查与保存场景。项目工具可定义 run(params)，经 tool_path 反复调用，每次加载最新源码。Python 可继续编辑经原生笔刷塑形的网格；代码建模预设还可把笔刷步骤记入完整程序并重放。Blender Python 内提供 dsh.edit、dsh.sculpt、dsh.project、dsh.emit 等编辑、雕刻、投影与出图能力。
原生笔刷支持体量塑形、轮廓变化、弯曲、褶皱与表面细节；雕刻模式下可连续笔触、切换视图、撤销重做，提交保留编辑、丢弃则回到进入时状态。更细的共享场景、代码重放契约与编辑反馈说明见仓库内 skills/create-3d-model/references/ 与 docs/editing-feedback.md。
适用场景与注意¶
适合谁：已在用 DSH、希望智能体在 Blender 里自主完成建模/场景/动画/图像重建，并需要持久场景、视觉反馈与可选独立评审闭环的开发者。
生态说明：DSH 采用「一切皆插件」思路；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文不作「官方应用商店」表述。
安全与权限：插件以当前 dsh 进程权限运行，会调用本机 Blender 与 Python 辅助环境。安装前请阅读仓库源码、LICENSE 与 NOTICE，确认许可证与本地安全策略后再启用。
SkillHub 页面显示该仓库星标为 0（以目录页为准）；功能与命令以 GitHub README 与随包文档为准。
结尾¶
dsh-3d 把 Blender 绑进 DSH 工作流，让智能体在同一持久工作区里构造资产、观察渲染、接受独立评审，并把常用操作沉淀为可修订、可重放的项目工具。若要查看分类与简介，可打开 SkillHub 目录页；安装、预设与示例以 GitHub 仓库 README 为准。
