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

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

---

自适应接入

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

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

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

	A 已有协议	B 新提供商
什么时候	文档对上 OpenAI 兼容 / ModelVerse / 可灵 / Runway / Vidu / Veo / MiniMax	对不上任何现成 mode
你要填的	baseURL + caps	create.body 映射 + poll 或 syncResult
生成入口	仍是 directorx_generate_image / video / audio，可带 model	同左，mode=generic-rest

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

---

它做什么

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

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

看 拉片、抽帧、成片质检走确定性 ffmpeg，不靠模型「感觉过了」。	拍 图像 / 视频 / 音频生成，首尾帧与角色锚点写进规格。角色设定图走白底胸像 + 正/侧/背三视图。没有 Key 时用 mock 先跑通链路。
剪 时间线、智能精剪、混音闪避、字幕。图片 / 视频编辑台 16 套调色（荒土、青橙、漂白、胶片…），自然语言即可打开。	排 无限画布是分镜板：16:9 镜头卡、实时连线、⌘K 搜索。UI 只投递意图，节点由 DSH 写。工作区会话浮在画布右侧。
编 directorx_brief 给出配方和阶段（plan → create → refine）。成片人格先确认再落板。用现有工具自己串，不必走单一入口。	知 348 篇知识库（Google OKF v0.2）、105 条方法论、12 套配方、39 套主技能。生成前按 type/tag 检索，质检引用规则编号。

---

知识库（OKF）

知识库按 Google Open Knowledge Format (OKF) v0.2 治理，不是一堆无结构 Markdown。每篇概念文必须带：

• type：Reference / Method / Playbook / Spec / Case
• title / description / tags
• sources（出处）与 verified（核验）
• status、stale_after（过期日）
• path 即身份：旧编号走 aliases + _meta/redirects.json，不另起一篇同名文

INDEX.md 与 log.md 是保留根文件。维护：npm run knowledge:audit / knowledge:check。

做到了什么

指标	结果
有效文章	348（Reference 268 · Method 27 · Playbook 30 · Spec 8 · Case 15）
已合并旧编号	90，检索旧 id 仍能读到现行文
精确重复正文	0
结构错误 / 审计警告	0
检索	directorx_knowledge_search 可按 type / tag / group 过滤，综合篇降权

好处

• 检索对型：要规格读 Spec，要打法读 Playbook，要案例读 Case，agent 不会把总合成篇当成镜头事实。
• 身份稳定：合并、改名不打断旧引用；DSH 按 id 精读，不必两边各搜一遍。
• 可核验、可过期：每篇有出处和核验记录；模型/平台/法规文带 stale_after，过期会降权而不是假装仍准。
• 生成前少噪音：先 search 再 read，综合篇让路给基础篇，占位和成稿引用的是规范文而不是重复导航。

---

成片

同一块分镜板剪出来的短片。片源 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，不再依赖模型供应商白名单。

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

阶段	做什么
现在	四个能力都切 mock，先把 brief → 确认 → 画布 → 时间线跑通
有 Key 之后	填 Base URL 与 API Key，再开对应能力
新厂商	交文档和 Key，走入驻六步，不要手写适配器

开发与自测：

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 套调色、回写节点，并打开对应编辑台。旋转、翻转、裁切、变速、去掉片头这类改动先 directorx_edit_plan 路由，再走 directorx_image_edit / directorx_video_process / directorx_edit，同样回写该镜头，不重绘。

---

画布

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

谁来做	做什么
DSH	想、问、批、写节点、领取生成意图、调色、剪辑
画布 UI	看、连、缩放、搜索；底部生成条只 POST 意图
右侧浮窗	当前工作区会话：流式正文、skill： 工具行、「思考中」、DSH 标准提问、新会话

约定：

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

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

---

工具箱里有什么

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

工作面	代表工具	作用
分诊	directorx_brief / chengpian	类型、平台、时长、澄清问题、是否该确认 / 生成
镜头	directorx_shot / shot_sequence / shot_gate	景别运镜布光 → 提示词；相邻镜承接；生成前门禁
占位	directorx_propose / canvas_shotlist / directorx_confirm	完整导演稿入队；编号分镜表；DSH 标准提问签字。人也可 /directorx 看制片板
画布	canvas_plan / group / sequence / node / intents	确认后落板；增删改查、分组、按幕写分镜；领取 UI 意图
生成	generate_image / generate_video / generate_audio	文生图/视频/音频；角色锚点与三视图规格；可选 model 覆盖
入驻	provider_ingest / classify / draft / smoke / commit	用户给模型+文档+Key；A 复用已有协议，B 走 generic-rest
提问	directorx_ask / directorx_confirm	分叉与签字都走 DSH 标准提问，禁止正文菜单
检索	skill_route / skill_search / read · knowledge_search / read	路由同时点名技能与文章 id；两边命中互相带对岸
阶段	directorx_stage	成片阶段账本与产物路径，过闸再进下一阶段
剪辑	edit_plan / image_edit / video_process / edit / timeline / smart_cut / studio	先路由再动手；图片几何、单段处理、人话 cut list、时间线、精剪、16 调色；带 nodeId 回写画布
质检	directorx_qa / qa_report	时长、画幅、黑场、响度、节奏
知识	directorx_knowledge_search / read	348 篇 Google OKF v0.2 语料，可按 type/tag/group 检索

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

---

和别的方案

	提示词清单	剪辑软件	成片平台	DirectorX
理解任务	靠人	否	黑盒	DSH + brief
分镜可见、可改	否	部分	少	无限画布
改计划不重花生成费	—	是	否	时间线重渲染
知识可引用	否	否	否	规则编号 + 知识库
agent 归谁	—	—	平台	始终是 DSH

---

FAQ

没有 API Key 能用吗？

能。四个能力切 mock 即可跑通工具链、画布和剪辑。有 Key 再回设置页填写。

支持哪些视频模型？

Sora 2、可灵（新旧协议）、Runway、MiniMax H3、Vidu、Google Veo、豆包 Seedance。协议按官方文档接入，在 Settings → DirectorX 里按能力配置。

多镜头怎么保持同一张脸？

directorx_character_register 注册锚点；生成时带参考图和身份描述。角色设定走三视图。相邻镜头用 shot_sequence 写承接，长片用画布连续性锁。

剪辑和调色会花模型钱吗？

不会。剪辑、16 套调色、混音、字幕、质检都是本地 ffmpeg。花钱的只有你确认过的生成占位。

必须走 orchestrate 吗？

不必。directorx_brief.compose 给出配方和工具序列，用现有工具自己编排。directorx_orchestrate 只是可选加速。

画布上谁写生成中的节点？

只有 DSH。生成条把意图推进 directorx_canvas_intents，DSH 领取后再改画布。UI 不绕过 agent。

为什么 DSH 不直接往画布上堆节点？

剧本、分镜、角色表要先和你对齐。directorx_confirm 或你明确说「落到画布」之后，才 canvas_plan / 批量占位。一张图补位可以随时加。

画布右侧的会话是另一套 agent 吗？

不是。那是当前工作区绑定的 DSH 会话：流式输出、标准提问、批准、新会话都走官方 Session。插件不另起 loop。

怎么加一个文档里的新厂商？

给 DSH 模型 id、API 文档（粘贴或 URL）和 Key。它会填一份封闭的 AdapterSpec，做最小回归，再写入 Settings。刷新后仍用 directorx_generate_*，不要为每家厂商加新工具。

要哪一版 DSH？

0.1.0-rc.7 及以上。插件同时注册 settings.section 与按命名空间配对的 settings.plugin.item（key=directorx）。

---

文档

文档	内容
架构	插件边界、画布归属、路由
验证	测试与验收口径
Changelog	用户可见变更
配方	宣传片 / 改编 / 拉片复刻 / 单元化制作

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

---