{
  "markdown": "<div align=\"center\">\n\n<img src=\"docs/logo.svg\" width=\"88\" alt=\"DirectorX\">\n\n# DirectorX：第一个以 DeepSeek Harness 为内核的 Video Agent Harness\n\n**The first DeepSeek Harness-native video agent harness for end-to-end AI video production.**\n\nDirectorX 是一个运行在 **DeepSeek Harness (DSH)** 里的开源 `dsh-plugin`：让一个真正的 video agent 从需求理解、导演决策、剧本与分镜，到图像 / 视频 / 音频生成、剪辑、质检和交付，沿着同一条可审计的生产链完成工作。\n\n> **一句话定位**：DeepSeek Harness 负责 agent loop、上下文、提问、审批与编排；DirectorX 负责 AI video production 的工具、知识、配方、媒体管线和无限分镜画布。\n\n这不是另一个提示词合集，也不是把聊天窗口包成视频生成器。它是 **DeepSeek Harness 的第一个 video agent harness**：让视频 agent 有状态、有工具、有知识、有确认闸门，并能把计划落成可编辑、可重渲染的成片。\n\n**中文关键词**：DeepSeek Harness 视频 Agent、AI 视频 Agent、视频生成工作流、AI 导演、分镜画布、智能剪辑、成片质检、FFmpeg 视频管线。\n\n**English keywords**: DeepSeek Harness video agent, AI video agent harness, AI video generation workflow, text-to-video, image-to-video, storyboard canvas, smart video editing, FFmpeg media pipeline.\n\n一句话进入视频工作坊：DSH 负责导演、审批与编排，DirectorX 提供无限分镜板、生成、镜头拆解、粗剪、批处理和交付工具。\n</div>\n\n<br>\n\n<p align=\"center\">\n  <a href=\"#为什么是-deepseek-harness-video-agent-harness\"><strong>定位</strong></a> ·\n  <a href=\"#自适应接入\"><strong>自适应接入</strong></a> ·\n  <a href=\"#它做什么\"><strong>能力</strong></a> ·\n  <a href=\"#知识库okf\"><strong>知识库</strong></a> ·\n  <a href=\"#成片\"><strong>成片</strong></a> ·\n  <a href=\"#快速开始\"><strong>安装</strong></a> ·\n  <a href=\"#一次制作怎么走\"><strong>流程</strong></a> ·\n  <a href=\"#画布\"><strong>画布</strong></a> ·\n  <a href=\"#工具箱里有什么\"><strong>工具</strong></a> ·\n  <a href=\"#和别的方案\"><strong>对比</strong></a> ·\n  <a href=\"#faq\"><strong>FAQ</strong></a> ·\n  <a href=\"#文档\"><strong>文档</strong></a>\n</p>\n\n<p align=\"center\">\n  <img src=\"docs/assets/canvas.jpg\" alt=\"DirectorX DeepSeek Harness AI video agent 无限分镜画布：DSH 会话编排镜头与视频生产工作流\" width=\"100%\">\n</p>\n\n<p align=\"center\">\n  <sub>项目「临界点：看见之后」——节点是镜头，连线是承接。右侧 DSH 浮窗绑定当前画布工作区，生成条只投递意图。</sub>\n</p>\n\n---\n\n## 为什么是 DeepSeek Harness Video Agent Harness\n\n搜索 **DeepSeek Harness video agent**、**AI video agent harness** 或 **DeepSeek Harness 视频 Agent** 时，DirectorX 对应的是一个明确的产品类别：**以 DeepSeek Harness 作为运行时内核的垂直视频生产 harness**。\n\n| 你要解决的问题 | DirectorX 的答案 |\n| --- | --- |\n| 只会生成单张图或单个镜头 | 把 brief、剧本、分镜、角色锚点、生成和交付串成可追踪工作流 |\n| Agent 记不住项目上下文 | 每个项目绑定一份画布和 DSH 工作区会话，节点、阶段和产物可回溯 |\n| 生成前无法控制成本 | `confirm` → 落板 → `propose` → 用户确认 → 生成；先占位，后花钱 |\n| 改剪辑就要重新生成 | 本地 FFmpeg 完成剪辑、调色、混音、字幕和质检，时间线可无限重渲染 |\n| 每接一家模型都要写插件 | 给 DSH 模型 id、API 文档和 Key，已有协议复用，未知 HTTP 走 `generic-rest` |\n\n### 适合谁\n\n- 想在 DeepSeek Harness 中构建可复用 **AI video agent** 的开发者与 AI 工程团队。\n- 需要从文字 brief 交付宣传片、短剧、分镜预演、产品视频或社媒短片的创作者与制作团队。\n- 需要审批、成本控制、知识引用、素材连续性和可审计产物的企业视频工作流。\n\n### 关键事实\n\n- 开源、Apache-2.0、Node.js 22.19+，作为 `dsh-plugin` 安装到 DeepSeek Harness。\n- 原生使用 DSH 的 agent loop、Session、`userQuestions`、工具注册和 Settings；不复制第二套 agent runtime。\n- 默认 Vision 走 DeepSeek 第一方多模态 `deepseek-chat` / `deepseek-v4-flash-vision-exp`，也支持 OpenAI-compatible VL endpoint。\n- 支持 mock 模式：没有 API Key 时也能先验证 brief → 确认 → 画布 → 时间线 → 质检链路。\n- 包含 348 篇 OKF 知识库文章、39 套主技能、12 套配方和 100+ `directorx_*` 工具。\n\n\n## 自适应接入\n\n**用户只给三样东西：模型 id、API 文档、API Key。** DSH 按固定流程自己完成配置、最小回归，刷新页面后即可生成。不需要你改插件代码，也不为每家厂商加新工具。\n\n这是 DirectorX 的接入面：已有协议走捷径（A），对不上的新 HTTP 走 `generic-rest`（B，主路径）。\n\n```text\ningest 收文档和 Key（Key 不进会话）\n  → classify 判断 A / B\n  → draft 只填封闭 AdapterSpec（禁止写代码）\n  → directorx_ask（DSH 标准提问）确认协议 / 是否打最短真调用\n  → smoke 契约 + 探活（可选一发最短生成）\n  → commit 写入 Settings，热挂工具\n```\n\n| | A 已有协议 | B 新提供商 |\n| --- | --- | --- |\n| 什么时候 | 文档对上 DeepSeek 第一方 / OpenAI 兼容 / ModelVerse / 可灵 / Runway / Vidu / Veo / MiniMax | 对不上任何现成 mode |\n| 你要填的 | baseURL + caps | create.body 映射 + poll 或 syncResult |\n| 生成入口 | 仍是 `directorx_generate_image` / `video` / `audio`，可带 `model` | 同左，mode=`generic-rest` |\n\n设置页有「接入新模型」表单；或直接对会话说「接入这个模型」。分叉一律走 **DSH 标准提问**（`directorx_ask` / `userQuestions.ask`），不要在聊天里列 1. 2. 3.\n\n---\n\n## 它做什么\n\nDirectorX 是 DeepSeek Harness 的 **dsh-plugin**：把一句话需求展开为剧本、镜头、资产、生成、剪辑和交付；它不实现第二套 agent loop，也不改画布上的生成节点——DSH 负责想、批、跑，插件提供媒体工具、导演知识、配方和无限画布。\n\n每个项目一份画布和工作区会话。右侧会话坞可直接进入六步视频工作坊、分析参考视频、一键粗剪、一键交付；长回复默认折叠。复杂任务先出脚本 / 分镜 / 角色表，**用户确认后再落到画布、再花钱生成**。改时间线是重渲染，不是重新生成：本地 ffmpeg 剪辑、调色、混音、字幕、质检可以无限重跑。\n\n<table>\n<tr>\n<td width=\"50%\" valign=\"top\">\n\n#### 看\n\n拉片、抽帧、成片质检走确定性 ffmpeg，不靠模型「感觉过了」。视觉问答默认 **DeepSeek 第一方多模态**（`deepseek-chat` 模式，`deepseek-v4-flash-vision-exp`）：图片内联成 data URL 走官方 chat 协议，配 `DEEPSEEK_API_KEY` 即用；也可切 `openai-chat` 走任意 OpenAI 兼容 VL 端点。\n\n</td>\n<td width=\"50%\" valign=\"top\">\n\n#### 拍\n\n图像 / 视频 / 音频生成，首尾帧与角色锚点写进规格。角色设定图走白底胸像 + 正/侧/背三视图。没有 Key 时用 `mock` 先跑通链路。\n\n</td>\n</tr>\n<tr>\n<td width=\"50%\" valign=\"top\">\n\n#### 剪\n\n时间线、智能精剪、混音闪避、字幕。图片 / 视频编辑台 16 套调色（荒土、青橙、漂白、胶片…），自然语言即可打开。\n\n</td>\n<td width=\"50%\" valign=\"top\">\n\n#### 排\n\n无限画布是分镜板：16:9 镜头卡、实时连线、⌘K 搜索。UI 只投递意图，节点由 DSH 写。工作区会话浮在画布右侧。\n\n</td>\n</tr>\n<tr>\n<td width=\"50%\" valign=\"top\">\n\n#### 编\n\n`directorx_brief` 给出配方和阶段（plan → create → refine）。成片人格先确认再落板。用现有工具自己串，不必走单一入口。\n\n</td>\n<td width=\"50%\" valign=\"top\">\n\n#### 知\n\n348 篇知识库（Google OKF v0.2）、105 条方法论、12 套配方、39 套主技能。生成前按 type/tag 检索，质检引用规则编号。\n\n</td>\n</tr>\n</table>\n\n---\n\n## 知识库（OKF）\n\n知识库按 **Google Open Knowledge Format (OKF) v0.2** 治理，不是一堆无结构 Markdown。每篇概念文必须带：\n\n- **type**：`Reference` / `Method` / `Playbook` / `Spec` / `Case`\n- **title / description / tags**\n- **sources**（出处）与 **verified**（核验）\n- **status**、**stale_after**（过期日）\n- **path 即身份**：旧编号走 `aliases` + `_meta/redirects.json`，不另起一篇同名文\n\n`INDEX.md` 与 `log.md` 是保留根文件。维护：`npm run knowledge:audit` / `knowledge:check`。\n\n### 做到了什么\n\n| 指标 | 结果 |\n| --- | --- |\n| 有效文章 | **348**（Reference 268 · Method 27 · Playbook 30 · Spec 8 · Case 15） |\n| 已合并旧编号 | **90**，检索旧 id 仍能读到现行文 |\n| 精确重复正文 | **0** |\n| 结构错误 / 审计警告 | **0** |\n| 检索 | `directorx_knowledge_search` 可按 **type / tag / group** 过滤，综合篇降权 |\n\n### 好处\n\n- **检索对型**：要规格读 Spec，要打法读 Playbook，要案例读 Case，agent 不会把总合成篇当成镜头事实。\n- **身份稳定**：合并、改名不打断旧引用；DSH 按 id 精读，不必两边各搜一遍。\n- **可核验、可过期**：每篇有出处和核验记录；模型/平台/法规文带 `stale_after`，过期会降权而不是假装仍准。\n- **生成前少噪音**：先 search 再 read，综合篇让路给基础篇，占位和成稿引用的是规范文而不是重复导航。\n\n---\n\n## 成片\n\n同一块分镜板剪出来的短片。片源 1440p，仓库里是便于浏览的 1080p。GitHub 网页若不内嵌播放，点封面或链接即可打开。\n\n<p align=\"center\">\n  <a href=\"docs/assets/demo.mp4\">\n    <img src=\"docs/assets/demo-poster.jpg\" alt=\"成片《临界点：看见之后》封面，点击播放\" width=\"100%\">\n  </a>\n</p>\n\n<video src=\"docs/assets/demo.mp4\" poster=\"docs/assets/demo-poster.jpg\" controls playsinline preload=\"metadata\" width=\"100%\"></video>\n\n<p align=\"center\">\n  <sub>《临界点：看见之后》· 约 89 秒 · <a href=\"docs/assets/demo.mp4\">demo.mp4</a></sub>\n</p>\n\n---\n\n## 快速开始\n\n需要 **DeepSeek Harness 0.1.1-rc.2+** 的 Web 配置（`npm i -g @deepseek-ai/dsh@next`，尚未打 `@latest`），以及 Node.js 22.19+。\n\n```bash\n# 在插件目录里装进 Web 配置\ndsh plugin --profile web add .\n\n# 打开 WebUI\ndsh web\n```\n\n然后打开 **Settings → DirectorX**（或 **Plugins** 里的 DirectorX 卡片），四个能力各自开关：Vision / Image / Video / Audio。设置项按命名空间 `directorx` 挂到 Host，浏览器半侧读 `settingsScope` 镜像，不再单独打 `settings.describe`。\n\n复杂任务的分叉（时长、画幅、提示词、落画布、是否付费测试）一律用 **DSH 标准提问**，不要在正文里写编号菜单。知识用 `directorx_knowledge_search` / `read`（同义词 + 分组），技能用 `directorx_skill_search` / `read` 读全文。阶段产物写入 `directorx_stage`（brief → … → deliver）。\n\n| 阶段 | 做什么 |\n| --- | --- |\n| 现在 | 四个能力都切 `mock`，先把 brief → 确认 → 画布 → 时间线跑通 |\n| 有 Key 之后 | 填 Base URL 与 API Key，再开对应能力 |\n| 新厂商 | 交文档和 Key，走入驻六步，不要手写适配器 |\n\n开发与自测：\n\n```bash\nnpm test          # typecheck + build + node:test\n```\n\n---\n\n## 一次制作怎么走\n\n复杂任务默认 **确认后再落板、占位后再花钱**：先写完整规格（提示词 + 推荐模型 + 画幅/时长），分镜表签字、用户同意落到画布之后，才生成。\n\n```mermaid\nflowchart LR\n  A[brief 分诊] --> B[调研 / 配方]\n  B --> C[一次澄清]\n  C --> D[分镜 / 角色锚]\n  D --> E[directorx_confirm]\n  E --> F[落到画布]\n  F --> G[propose 占位]\n  G --> H[用户确认后生成]\n  H --> I[timeline / studio]\n  I --> J[qa 质检]\n  J -->|返修该镜| G\n```\n\n简单请求（一张图、一个短镜头）可以直接生成。多镜头、复刻、改编、小说改编走上面这条。\n\n对画布里的 DSH 说「帮我把这张照片调成末日荒土配色」，会走 `directorx_studio`：ffmpeg 套调色、回写节点，并打开对应编辑台。旋转、翻转、裁切、变速、去掉片头这类改动先 `directorx_edit_plan` 路由，再走 `directorx_image_edit` / `directorx_video_process` / `directorx_edit`，同样回写该镜头，不重绘。\n\n---\n\n## 画布\n\n画布是分镜文档，不是第二套聊天。每个项目一份 `canvas.json`（OCC 写入），新项目不会混用旧板。\n\n| 谁来做 | 做什么 |\n| --- | --- |\n| DSH | 想、问、批、写节点、领取生成意图、调色、剪辑 |\n| 画布 UI | 看、连、缩放、搜索；底部生成条只 POST 意图 |\n| 右侧浮窗 | 当前工作区会话：流式正文、`skill：` 工具行、「思考中」、DSH 标准提问、新会话 |\n\n约定：\n\n- 剧本 / 分镜 / 角色表未用 `directorx_confirm`、用户也没说「落到画布」之前，不要批量占位。\n- 生成中的节点只能由 DSH 写。UI 不得把卡片标成 generating。\n- 角色设定 / 三视图按白底胸像 + 正面 / 侧面 / 背面一次出图。\n- 镜头卡按 16:9 横条分镜排布；`canvas_arrange` / `canvas_plan` 走同一套。\n\n快捷键：空白拖移、滚轮缩放、`G` 打开生成条、`E` 编辑所选媒体、`⌘K` 搜索节点与命令、`Tab` 换镜。双击节点居中缩放。双击空白添加节点，右键空白导入，右键节点出生成 / 编辑 / 复制 / 删除等当前对象可用的菜单。\n\n---\n\n## 工具箱里有什么\n\n100+ 个 `directorx_*` 工具，按工作面分组；高频动作在画布会话坞直接点，不必记工具名：\n\n| 工作面 | 代表工具 | 作用 |\n| --- | --- | --- |\n| 分诊 | `directorx_brief` / `chengpian` | 类型、平台、时长、澄清问题、是否该确认 / 生成 |\n| 镜头 | `directorx_shot` / `shot_sequence` / `shot_gate` | 景别运镜布光 → 提示词；相邻镜承接；生成前门禁 |\n| 占位 | `directorx_propose` / `canvas_shotlist` / `directorx_confirm` | 完整导演稿入队；编号分镜表；DSH 标准提问签字。人也可 `/directorx` 看制片板 |\n| 画布 | `canvas_plan` / `group` / `sequence` / `node` / `intents` | 确认后落板；增删改查、分组、按幕写分镜；领取 UI 意图 |\n| 生成 | `generate_image` / `generate_video` / `generate_audio` | 文生图/视频/音频；角色锚点与三视图规格；可选 `model` 覆盖 |\n| 入驻 | `provider_ingest` / `classify` / `draft` / `smoke` / `commit` | 用户给模型+文档+Key；A 复用已有协议，B 走 generic-rest |\n| 提问 | `directorx_ask` / `directorx_confirm` | 分叉与签字都走 DSH 标准提问，禁止正文菜单 |\n| 检索 | `skill_route` / `skill_search` / `read` · `knowledge_search` / `read` | 路由同时点名技能与文章 id；两边命中互相带对岸 |\n| 阶段 | `directorx_stage` | 成片阶段账本与产物路径，过闸再进下一阶段 |\n| 剪辑 | `edit_plan` / `image_edit` / `video_process` / `edit` / `timeline` / `smart_cut` / `studio` | 先路由再动手；图片几何、单段处理、人话 cut list、时间线、精剪、16 调色；带 nodeId 回写画布 |\n| 快捷生产 | `media_scene_split` / `media_auto_cut` / `media_batch` / `media_package` | 参考视频检查帧、区间/脚本粗剪、批量拼接/标准化、预告与封面交付包 |\n| 质检 | `directorx_qa` / `qa_report` | 时长、画幅、黑场、响度、节奏 |\n| 知识 | `directorx_knowledge_search` / `read` | 348 篇 Google OKF v0.2 语料，可按 type/tag/group 检索 |\n\n视频协议（设置页按能力配置，不绑死一家）：Sora 2、可灵（两代）、Runway、MiniMax H3、Vidu、Veo、Seedance。\n\n---\n\n## 和别的方案\n\n| | 提示词清单 | 剪辑软件 | 成片平台 | **DirectorX** |\n| --- | :---: | :---: | :---: | :---: |\n| 理解任务 | 靠人 | 否 | 黑盒 | DSH + `brief` |\n| 分镜可见、可改 | 否 | 部分 | 少 | 无限画布 |\n| 改计划不重花生成费 | — | 是 | 否 | 时间线重渲染 |\n| 知识可引用 | 否 | 否 | 否 | 规则编号 + 知识库 |\n| agent 归谁 | — | — | 平台 | **始终是 DSH** |\n\n---\n\n## FAQ\n\n<details>\n<summary><b>没有 API Key 能用吗？</b></summary>\n\n能。四个能力切 <code>mock</code> 即可跑通工具链、画布和剪辑。有 Key 再回设置页填写。\n\n</details>\n\n<details>\n<summary><b>支持哪些视频模型？</b></summary>\n\nSora 2、可灵（新旧协议）、Runway、MiniMax H3、Vidu、Google Veo、豆包 Seedance。协议按官方文档接入，在 Settings → DirectorX 里按能力配置。\n\n</details>\n\n<details>\n<summary><b>多镜头怎么保持同一张脸？</b></summary>\n\n<code>directorx_character_register</code> 注册锚点；生成时带参考图和身份描述。角色设定走三视图。相邻镜头用 <code>shot_sequence</code> 写承接，长片用画布连续性锁。\n\n</details>\n\n<details>\n<summary><b>剪辑和调色会花模型钱吗？</b></summary>\n\n不会。剪辑、16 套调色、混音、字幕、质检都是本地 ffmpeg。花钱的只有你确认过的生成占位。\n\n</details>\n\n<details>\n<summary><b>必须走 orchestrate 吗？</b></summary>\n\n不必。<code>directorx_brief.compose</code> 给出配方和工具序列，用现有工具自己编排。<code>directorx_orchestrate</code> 只是可选加速。\n\n</details>\n\n<details>\n<summary><b>画布上谁写生成中的节点？</b></summary>\n\n只有 DSH。生成条把意图推进 <code>directorx_canvas_intents</code>，DSH 领取后再改画布。UI 不绕过 agent。\n\n</details>\n\n<details>\n<summary><b>为什么 DSH 不直接往画布上堆节点？</b></summary>\n\n剧本、分镜、角色表要先和你对齐。<code>directorx_confirm</code> 或你明确说「落到画布」之后，才 <code>canvas_plan</code> / 批量占位。一张图补位可以随时加。\n\n</details>\n\n<details>\n<summary><b>画布右侧的会话是另一套 agent 吗？</b></summary>\n\n不是。那是当前工作区绑定的 DSH 会话：流式输出、标准提问、批准、新会话都走官方 Session。插件不另起 loop。\n\n</details>\n\n<details>\n<summary><b>怎么加一个文档里的新厂商？</b></summary>\n\n给 DSH 模型 id、API 文档（粘贴或 URL）和 Key。它会填一份封闭的 AdapterSpec，做最小回归，再写入 Settings。刷新后仍用 <code>directorx_generate_*</code>，不要为每家厂商加新工具。\n\n</details>\n\n<details>\n<summary><b>要哪一版 DSH？</b></summary>\n\n<strong>0.1.1-rc.2 及以上</strong>（<code>@deepseek-ai/dsh@next</code>）。该系列起宿主发布第一方多模态模型（<code>deepseek-v4-flash-vision-exp</code>），DirectorX Vision 默认走该模型。插件同时注册 <code>settings.section</code> 与按命名空间配对的 <code>settings.plugin.item</code>（key=<code>directorx</code>）。提问走 <code>userQuestions</code>，斜杠菜单走 <code>commandUi</code>。\n\n</details>\n\n---\n\n## 文档\n\n| 文档 | 内容 |\n| --- | --- |\n| [架构](docs/architecture.md) | 插件边界、画布归属、路由 |\n| [验证](docs/verification.md) | 测试与验收口径 |\n| [发版](docs/releasing.md) | CHANGELOG、打标签、GitHub Release |\n| [Changelog](CHANGELOG.md) | 用户可见变更 |\n| [配方](recipes/) | 宣传片 / 改编 / 拉片复刻 / 单元化制作 |\n\n```\ndsh-directorx\n├── src/           工具、画布、媒体、配方编排\n├── skills/        方法论、工坊、novel-* 门禁\n├── knowledge/     348 篇导演/生成语料（Google OKF v0.2）\n├── recipes/       内容类型先例（按素材改，不是目录）\n├── workflows/     可选并行模板\n├── docs/assets/   画布截图与成片演示\n└── tests/         node:test\n```\n\n---\n\n<div align=\"center\">\n\nApache-2.0 · [License](https://github.com/LaplaceYoung/dsh-directorx/blob/main/LICENSE)\n\n如果它让 DSH 第一次把一条片子剪完，点个 Star。\n\n</div>\n",
  "bytes": 12412,
  "sha": "108deab580f94c7ed3fd33096caeef208d892e4c9c885d81c8332179ca753b93",
  "repo_slug": "laplaceyoung/dsh-directorx",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_laplaceyoung_dsh_directorx_knowledge_ind_36f15028/readme"
}