前言¶

在 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