lhmd/dsh-director-toolkit 预览 preview

lhmd/dsh-director-toolkit

插件Plugin 原生Native ⭐ 7 MIT 工具Tools视觉Visual

DSH导演工具包是一个适用于3D艺术家、技术设计师和创意编程者的DeepSeek管理插件。粘贴一个不成熟的想法、参考笔记或作品集说明,即可获得针对Blender、Three.js、Houdini或C4D的精简方向包。

项目介绍Project Overview

DSH 导演工具包是面向 3D 美术与技术设计师的 DeepSeek Harness 插件,可将粗略简报转为针对 Blender、Three.js、Houdini 或 C4D 的方向包,涵盖镜头构图、灯光材质几何动作、软件感知渲染、灰盒起步的五步流程、负向提示、标题、双语展示文案、话题标签与风险标记。包含本地确定工具 scene_director,以及默认调用 deepseek-v4-pro 的可选 scene_director_v4 适配器,后者仅从服务端环境读取 DEEPSEEK_API_KEY。安装时通过 dsh plugin --profile web add 加载路径。需注意 V4 通道依赖服务端环境变量配置密钥,凭证管理需谨慎。

DSH Director Toolkit is a DeepSeek Harness plugin for 3D artists and technical designers. It converts a rough brief into a direction pack targeting Blender, Three.js, Houdini, or C4D, covering camera and composition, lighting, materials, geometry, motion, software-aware render settings, a five-step build flow starting from greybox, negative prompts, titles, bilingual showcase copy, hashtags, and risk flags. The local deterministic tool is scene_director, while scene_director_v4 is an optional adapter that defaults to deepseek-v4-pro and reads DEEPSEEK_API_KEY only from the server environment. Install via dsh plugin --profile web add. Caveat: the V4 path requires careful server-side credential management.

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:lhmd/dsh-director-toolkit

lhmd/dsh-director-toolkit 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DSH Director Toolkit

DSH Director Toolkit

Pages Tests DeepSeek V4 Pro License

English · 中文入口 · Live showcase

Turn a rough 3D idea into a shot you can build.

DSH Director Toolkit is a DeepSeek Harness plugin for 3D artists and technical designers. It turns a rough brief into a direction pack for Blender, Three.js, Houdini, or C4D:

  • camera and composition;
  • lighting, materials, geometry, and motion;
  • software-aware render settings;
  • five build steps starting with a greybox pass;
  • negative prompt, titles, bilingual showcase copy, hashtags, and risk flags.

See it first

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

Cyclopean Porcelain

The film has three beats: reveal the cyan silhouette, let the eye find camera, then lift the relic above the plinth. The source scene is examples/cyclopean-porcelain.blend; the build script is scripts/blender-script-demo.py.

The four story frames are rendered from scripts/render-case-videos.py: chrome orbit, memory garden, brutalist archive, and cloth robot. The direction data is in docs/examples/scene-suite.json.

Chapter Render
Chrome Orbit Chrome Orbit
Memory Garden Memory Garden
Brutalist Archive Brutalist Archive
Cloth Robot Cloth Robot

Plugin shape

scene_director is the local-first deterministic tool. scene_director_v4 is an optional Harness/server adapter that defaults to deepseek-v4-pro and reads DEEPSEEK_API_KEY only from the server environment. The runtime director-toolkit Skill tells the agent when to direct a Blender, Three.js, Houdini, or C4D brief.

This repository follows the DSH Profile Bundle shape:

  • cordis.patch.yml mounts the package;
  • src/index.js exports apply(ctx) and registers tools;
  • src/skill.js registers the Skill through ctx.skills.register(...);
  • no .codex-plugin directory and no file-based Skill folder.

Install into Harness

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

For the optional V4 pass, configure the credential in the Harness/server environment:

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

Editable playground

The changeable local editor lives in playground/.

python3 -m http.server 4175 --directory playground

Development

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

License

MIT.

上一个 Prev dsh-bash-encoding 下一个 Next dsh-git-identity