DirectorX

AI video director plugin for DeepSeek Harness

给 DSH 装上取景器、剪辑台和无限分镜板。大脑仍是 DSH，插件只负责手脚。

自适应接入 · 能力 · 成片 · 安装 · 流程 · 画布 · 工具 · 对比 · FAQ · 文档

_{项目「临界点：看见之后」——节点是镜头，连线是承接。右侧 DSH 浮窗绑定当前画布工作区，生成条只投递意图。}

自适应接入

用户只给三样东西：模型 id、API 文档、API Key。 DSH 按固定流程自己完成配置、最小回归，刷新页面后即可生成。不需要你改插件代码，也不为每家厂商加新工具。

这是 DirectorX 的接入面：已有协议走捷径（A），对不上的新 HTTP 走 generic-rest（B，主路径）。

ingest 收文档和 Key（Key 不进会话）
  → classify 判断 A / B
  → draft 只填封闭 AdapterSpec（禁止写代码）
  → ask 提问卡确认协议 / 是否打最短真调用
  → smoke 契约 + 探活（可选一发最短生成）
  → commit 写入 Settings，热挂工具

设置页有「接入新模型」表单；或直接对会话说「接入这个模型」。分叉一律走 提问卡（directorx_ask），不要在聊天里列 1. 2. 3.

它做什么

DirectorX 是 DeepSeek Harness 的 dsh-plugin。它不实现第二套 agent loop，也不改画布上的生成节点——DSH 负责想、批、跑；插件提供媒体工具、导演知识、配方和无限画布。

每个项目一份画布。复杂任务先出脚本 / 分镜 / 角色表，用户确认后再落到画布、再花钱生成。改时间线是重渲染，不是重新生成：本地 ffmpeg 剪辑、调色、混音、字幕、质检可以无限重跑。

成片

同一块分镜板剪出来的短片。片源 1440p，仓库里是便于浏览的 1080p。GitHub 网页若不内嵌播放，点封面或链接即可打开。

_{《临界点：看见之后》· 约 89 秒 · demo.mp4}

快速开始

需要 DeepSeek Harness 0.1.0-rc.7+ 的 Web 配置，以及 Node.js 22.19+。

# 在插件目录里装进 Web 配置
dsh plugin --profile web add .

# 打开 WebUI
dsh web

然后打开 Settings → DirectorX，四个能力各自开关：Vision / Image / Video / Audio。RC.7 起设置项按命名空间 directorx 挂到 Host，不再依赖模型供应商白名单。

复杂任务的分叉（时长、画幅、提示词、落画布、是否付费测试）一律用 提问卡，不要在正文里写编号菜单。知识用 directorx_knowledge_search / read（同义词 + 分组），技能用 directorx_skill_search / read 读全文。阶段产物写入 directorx_stage（brief → … → deliver）。

开发与自测：

npm test          # typecheck + build + node:test

一次制作怎么走

复杂任务默认 确认后再落板、占位后再花钱：先写完整规格（提示词 + 推荐模型 + 画幅/时长），分镜表签字、用户同意落到画布之后，才生成。

flowchart LR
  A[brief 分诊] --> B[调研 / 配方]
  B --> C[一次澄清]
  C --> D[分镜 / 角色锚]
  D --> E[directorx_confirm]
  E --> F[落到画布]
  F --> G[propose 占位]
  G --> H[用户确认后生成]
  H --> I[timeline / studio]
  I --> J[qa 质检]
  J -->|返修该镜| G

简单请求（一张图、一个短镜头）可以直接生成。多镜头、复刻、改编、小说改编走上面这条。

对画布里的 DSH 说「帮我把这张照片调成末日荒土配色」，会走 directorx_studio：ffmpeg 套调色、回写节点，并打开对应编辑台。

画布

画布是分镜文档，不是第二套聊天。每个项目一份 canvas.json（OCC 写入），新项目不会混用旧板。

约定：

• 剧本 / 分镜 / 角色表未用 directorx_confirm、用户也没说「落到画布」之前，不要批量占位。
• 生成中的节点只能由 DSH 写。UI 不得把卡片标成 generating。
• 角色设定 / 三视图按白底胸像 + 正面 / 侧面 / 背面一次出图。
• 镜头卡按 16:9 横条分镜排布；canvas_arrange / canvas_plan 走同一套。

快捷键：空白拖移、滚轮缩放、G 打开生成条、⌘K 搜索节点与命令。双击媒体卡进编辑台。

工具箱里有什么

100+ 个 directorx_* 工具，按工作面分组：

视频协议（设置页按能力配置，不绑死一家）：Sora 2、可灵（两代）、Runway、MiniMax H3、Vidu、Veo、Seedance。

和别的方案

FAQ

文档

dsh-directorx
├── src/           工具、画布、媒体、配方编排
├── skills/        方法论、工坊、novel-* 门禁
├── knowledge/     351 篇导演/生成语料
├── recipes/       内容类型先例（按素材改，不是目录）
├── workflows/     可选并行模板
├── docs/assets/   画布截图与成片演示
└── tests/         node:test