Preface

In intelligent agent workflows like DSH, 3D creative needs often remain at the descriptive level of “wanting a shot.” Before actual production begins, details such as camera, composition, lighting, materials, geometry, motion, rendering parameters, and production steps are still required.

DSH Director Toolkit addresses this gap: it transforms a rough brief into a direction pack tailored for Blender, Three.js, Houdini, or C4D, facilitating subsequent production implementation.

What This Is

DSH Director Toolkit is a DeepSeek Harness plugin maintained by lhmd under the MIT license. It is designed for 3D creators and technical designers to convert rough 3D ideas into buildable shots.

In the repository, scene_director is a local-first deterministic tool; scene_director_v4 is an optional Harness/server adapter, which defaults to using deepseek-v4-pro and only reads the DEEPSEEK_API_KEY from the server environment.

Core Features

Below are its verified output capabilities:

  • Convert rough briefs into direction packs for Blender, Three.js, Houdini, or C4D.
  • Cover camera and composition.
  • Cover lighting, materials, geometry, and motion.
  • Provide software-aware render settings.
  • Provide five production steps starting with the greybox pass.
  • Output negative prompts, titles, bilingual showcase copy, hashtags, and risk flags.

Installation and Activation

First, install the DSH client, then add the local plugin directory to the web profile, and finally start dsh web. Replace the path in the command with the absolute path to your local repository:

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

To enable the optional V4 pass, configure the key in the Harness/server environment. In examples, use a rotated key and avoid writing real keys into command history or the repository:

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

The plugin declares the following peerDependencies:

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

Typical Usage

Described below in a reproducible sequence.

  1. View the showcase. Open the GitHub Pages showcase to see a Blender short film, a four-chapter multi-asset story, and a browser-native Three.js study.

  2. Local playground. Start a local static server in the repository directory to view the editable playground:

python3 -m http.server 4175 --directory playground
  1. Development and checks. Run tests, release checks, packaging checks, and demos:
npm test
npm run check:release
npm run check:package
npm run demo

Use Cases and Notes

Suitable for:

  • 3D creators using Blender, Three.js, Houdini, or C4D.
  • Technical designers who need to break down creative briefs into shots and production steps within the DSH workflow.
  • Teams requiring unified output of render settings, showcase copy, and risk flags.

Notes on usage:

  • The plugin runs under the current dsh process permissions; review the source code, dependencies, and license before installation.
  • The DEEPSEEK_API_KEY should only be configured in the Harness/server environment, and scene_director_v4 only reads this variable from the server environment.
  • The repository contains no .codex-plugin directory or file-based Skill folders.
  • Licensed under MIT.

Conclusion

The value of DSH Director Toolkit lies in advancing “a 3D idea” to “a buildable shot”: it outputs direction, production steps, software-aware render settings, and copy for showcasing and risk notification.

GitHub:

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