前言¶

在 DSH 这类智能体插件工作流里，3D 创意需求常常停在“想要一个镜头”的描述层。实际开始制作之前，还需要镜头、构图、灯光、材质、几何、运动、渲染参数和制作步骤。

DSH Director Toolkit 针对这个位置：它把一份粗略 brief 整理成面向 Blender、Three.js、Houdini 或 C4D 的 direction pack，供后续落地制作。

这是什么¶

DSH Director Toolkit 是一个 DeepSeek Harness 插件，由 lhmd 维护，许可证为 MIT。它面向 3D 创作者和技术设计者，用来把粗略 3D 想法转成可以开始搭建的 shot。

仓库中，scene_director 是本地优先的确定性工具；scene_director_v4 是可选的 Harness/server 适配器，默认使用 deepseek-v4-pro，并且只从服务器环境读取 DEEPSEEK_API_KEY。

核心功能¶

下面介绍它已经核实的输出能力：

• 把粗略 brief 转成 Blender、Three.js、Houdini 或 C4D 的 direction pack。
• 覆盖 camera and composition。
• 覆盖 lighting、materials、geometry 和 motion。
• 提供 software-aware render settings。
• 提供五个制作步骤，从 greybox pass 开始。
• 输出 negative prompt、titles、bilingual showcase copy、hashtags 和 risk flags。

安装与启用¶

先安装 DSH 客户端，再把本地插件目录加入 web profile，最后启动 dsh web。命令中的路径需要替换为本地仓库的绝对路径：

npm install -g @deepseek-ai/dsh
dsh plugin --profile web add /absolute/path/to/dsh-director-toolkit
dsh web

如果启用可选 V4 pass，需要在 Harness/server 环境中配置密钥。示例中应使用已轮换的密钥，不要把真实密钥写入命令历史或仓库：

export DEEPSEEK_API_KEY="replace-with-a-rotated-key"

插件声明的 peerDependencies 包括：

• @deepseek-ai/dsh-skill ^0.0.1
• @deepseek-ai/dsh-tools ^0.0.1
• cordis ^4.0.0-rc.7

典型用法¶

下面按可复现顺序说明。

1、查看 showcase。打开 GitHub Pages showcase，查看 Blender short film、一个 four-chapter multi-asset story，以及一个 browser-native Three.js study。

2、本地 playground。在仓库目录中启动本地静态服务，用于查看可编辑 playground：

python3 -m http.server 4175 --directory playground

3、开发与检查。运行测试、发布检查、打包检查和 demo：

npm test
npm run check:release
npm run check:package
npm run demo

适用场景与注意¶

适合对象：

• 使用 Blender、Three.js、Houdini 或 C4D 的 3D 创作者。
• 需要在 DSH 工作流中把创意 brief 拆成镜头和制作步骤的技术设计者。
• 需要统一输出渲染设置、展示文案和风险标记的团队。

使用注意：

• 该插件会在当前 dsh 进程权限下运行，安装前应检查源码、依赖与许可证。
• DEEPSEEK_API_KEY 只应在 Harness/server 环境配置，scene_director_v4 只从服务器环境读取该变量。
• 仓库中没有 .codex-plugin 目录，也没有文件式 Skill 文件夹。
• 许可证为 MIT。

结尾¶

DSH Director Toolkit 的价值在于把“一个 3D 想法”推进到“可以开始搭建的镜头”：它输出方向、制作步骤、软件感知渲染设置，以及可用于展示和风险提示的文案。

GitHub：

https://github.com/lhmd/dsh-director-toolkit