Workflow & Automation

dsh-video-pipeline

439436269-ctrl/dsh-video-pipeline · ★ 7

439436269-ctrl

短视频流水线 skill 包:把一条「编排 skill + 原子 skill」的 AI 短剧生产流水线(TTS 读音校正、文生图/文生视频、图片运镜、成片合成、封面、成片核验、多平台发布)作为内置 skill 装进 DeepSeek Harness,装完即出现在 agent 的技能目录里。

README body is shown in Chinese.

License
MIT
Added
2026-10-30
Maintenance
active
Install kind
npm
npm
dsh-video-pipeline
Manifest details
Manifest status
Declared
Manifest path
package.json#dsh
Manifest checked
2026-10-30T09:38:06.583Z
Lifecycle scripts
None found

Static manifest checks report declarations only; they are not compatibility or security review.

安装

dsh plugin --profile web add 'dsh-video-pipeline@0.1.1'

从 npm 安装预构建包

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: zh · Read Chinese README

Table of contents
  1. 这个插件做了什么
  2. 安装
  3. 包内 skill
  4. 配置
  5. 占位符
  6. 前置依赖
  7. 发布前的脱敏(重要)
  8. 已知边界
  9. 结构
  10. 开发
  11. 许可

把一条跑通过的真实短视频生产流水线作为内置 skill 装进 DeepSeek Harness:共 19 个技能(1 个总入口 + 1 个编排 + 17 个原子),随插件一起出现在 agent 的技能目录里。

19 个 skill 的关系与数据流

图:19 个 skill 按流水线阶段排列,以及它们之间的交接。实线=产物数据流,虚线=编排 skill 对原子 skill 的调度,橙色=质量门,红色虚线=数据复盘闭环。(源码 docs/skill-flow.svg,由 node tools/make-flow-diagram.mjs 生成——skill 集合变了改数据重跑即可。)

列间空隙只有十几像素,图上不写字,所以交接关系列在这里:

交接 传的是什么
chinese-tts → video-compose 配音 wav(先过读音校正,字幕仍写原字)
ark-agent-plan-image / ark-seedream-image / dreamina-canvas-cli → image-to-video 关键帧 → 运镜镜头(三条生图线三选一,也可按镜头混用)
三个生图 skill → ark-seedance-video 关键帧当 i2v 首帧,用来锁人物形象
三个生图 skill → video-cover 关键帧 → 双平台封面(图中以卡片注释表示,避免长线穿图)
image-to-video / ark-seedance-video → video-compose 镜头 mp4(路线①图片运镜与路线②t2v 在这里汇合)
video-compose → media-verify 成片(先核验再交付)
media-verify → quad-platform-publish 核验通过才允许发布(质量门)
quad-platform-publish → bilibili-upload / tencent-upload / douyin-publish / xiaohongshu-skills 一平台一个 agent 并行发布
multi-platform-publish-orchestrator 与上一条并行的另一条路径:按 JSON 配置顺序批量发
发布 → feishu-bitable 链接与状态回写
tangshi-data-review → tangshi-pipeline 三平台数据复盘修正选片权重与发布节奏(闭环)
video-pipeline → 其余全部 总入口:说明这包是什么、每个环节该加载哪个 skill

被内置的 tangshi-pipeline 另自带一张更细的编排流程图(含两道确认门与并行发布的时序):skills/tangshi-pipeline/references/orchestration-flow.png。

装完不需要往 ~/.agents/skills 或 ~/.dsh/skills 复制任何文件——插件自己注册一个 skill provider,把包内的 skills/ 目录提供给 ctx.skills。

同一套 skill 还有一个宿主中立版,给 Claude Code / Codex 用(不带 DSH 的插件机制,占位符已落成可读值):https://github.com/439436269-ctrl/video-pipeline-skills。

这个插件做了什么

  • 提供 19 个 skill(总入口 1 + 编排 1 + 原子 17),覆盖选题、配音、出图、出视频、运镜、合成、封面、核验、数据复盘、多平台发布、进度回写。
  • 自撰一个总入口 skill(video-pipeline),说明这包是什么、每个环节该加载哪个原子 skill、占位符怎么填。安装者没有原作者本机那套同名 skill,所以入口 skill 是这里唯一的起点。
  • 不含任何运行时依赖:只 import Node 内建模块,通过 ctx.inject(['skills']) 拿到注册表。没有 dependencies,也没有需要宿主解析的 peerDependencies,因此不存在 peer 范围解析失败(ERESOLVE)问题。
  • 不动别人的 skill:provider 以 rank 600 报告候选(内置 rank),如果你自己的项目/用户 skill 同名(rank 100-500),你的版本胜出,本包不会遮蔽它。

安装

# 从 npm
dsh plugin --profile web add dsh-video-pipeline

# 从 GitHub
dsh plugin --profile web add github:439436269-ctrl/dsh-video-pipeline

# 本地开发(软链到源码目录)
dsh plugin --profile web add "link:/path/to/dsh-video-pipeline"

# 卸载
dsh plugin --profile web remove dsh-video-pipeline

装完重启 DSH Desktop,然后问 agent「有哪些视频流水线的 skill」即可看到目录。

包内 skill

skill 类型 作用
video-pipeline 总入口(本包自撰) 流水线骨架、环节与原子 skill 对照、占位符与前置依赖
tangshi-pipeline 编排 双版本(读诗版/故事版)批量生产与发布全流程:规格定稿、时序、成本基线、质量门
chinese-tts 原子·生产 中文配音:多音字读音校正(朝zhāo/还huán/重chóng/骑jì/教jiào/载zǎi)、音色与 context 模板
ark-agent-plan-image 原子·生产 火山 Agent Plan 通道文生图(扣 Plan 配额)
ark-seedream-image 原子·生产 火山标准通道文生图(按量后付费),含价格表与开通指引
ark-seedance-video 原子·生产 Seedance 文生视频 / 图生视频单条镜头,含 token 用量公式与任务管理
image-to-video 原子·生产 单张关键帧 → ffmpeg zoompan 运镜镜头
dreamina-canvas-cli 原子·生产 即梦画布 CLI(备用生成线)
video-compose 原子·合成 镜头列表 + 配音时间轴 + SRT → 竖屏成片(一条 manifest)
video-cover 原子·合成 B 站 16:10 与竖屏双封面一次出图
media-verify 原子·核验 astats 音频对位、线上音频版本比对、抽帧白屏检测
tangshi-data-review 原子·复盘 三平台播放数据采集、衰减分档与复盘报告
quad-platform-publish 编排·发布 四平台发布总控(含发布前读音核查与确认门)
multi-platform-publish-orchestrator 编排·发布 按 JSON 配置顺序执行多平台发布
bilibili-upload 原子·发布 B 站投稿与合集管理(biliup)
tencent-upload 原子·发布 视频号上传与合集管理
douyin-publish 原子·发布 抖音创作者中心上传发布与合集管理
xiaohongshu-skills 原子·发布(第三方) 小红书图文/视频发布、检索与互动,见 THIRD-PARTY-NOTICES.md
feishu-bitable 协作 飞书多维表格读写(进度回写)

配置

在 profile 的 cordis.patch.yml 里按 entry id 覆盖。patch 对 config 是整块替换,想保留的键要一并写出:

- id: dsh-video-pipeline
  config:
    enabledSkills:            # 省略或空数组 = 放出全部 19 个
      - video-pipeline
      - video-compose
      - media-verify
    placeholders:             # 覆盖内置占位符;加载 skill 时替换正文里的 {{TOKEN}}
      FEISHU_BASE_APP: your_base_app_token
      FEISHU_TABLE: tblXXXXXXXXXX
      FEISHU_RECORD: recXXXXXXXXXX
      NAS_DELIVERABLE_DIR: /your/nas/deliverables
      ARK_API_KEY_FILE: /your/path/ark_key.txt
键 默认值 作用
enabledSkills [](全部) 只放出指定 skill;用于把包装成只做某一段能力
placeholders {} 覆盖 {{TOKEN}} 的取值。取值优先级:本配置 → 环境变量 → 内置可读默认值

占位符

发布前把原作者环境相关的内容全换成了占位符。加载 skill 正文时按上表优先级替换成你的值:

占位符 含义 可用的环境变量
USER_HOME 本机用户目录 USERPROFILE / HOME
WORKSPACE 工作区根目录 DSH_WORKSPACE / WORKSPACE
ARK_API_KEY 火山方舟 API key ARK_API_KEY / ARK_STD_KEY
ARK_API_KEY_FILE 本地存放 key 的文件 ARK_API_KEY_FILE
FEISHU_BASE_APP / FEISHU_TABLE / FEISHU_RECORD 飞书多维表格坐标 同名
NAS_DELIVERABLE_DIR / NAS_DELIVERABLE_PARENT / NAS_HOST NAS 交付目录与主机 同名

只替换 skill 正文。skills/*/scripts/ 下是真实脚本文件,里面的占位符需要你自己改成实际值——skill 正文会说明每个值的含义。

前置依赖

本包只提供 skill(指令与脚本),不安装任何工具:

  • ffmpeg:合成、运镜、核验都依赖。xfade/ass/loudnorm 等滤镜需要较新版本。
  • Python 3 + Pillow:scripts/ 下的 py 脚本(封面、图处理、封面比对)。
  • Node.js:scripts/ 下的 mjs 脚本。
  • playwright:发布类 skill 需要时自行安装。
  • 各平台凭据:B 站 biliup 凭据、视频号/抖音/小红书登录态,必须你自己登录获取。本包不含任何凭据、cookie 或真实账号 ID。

发布前的脱敏(重要)

本包基于一条真实生产流水线,公开前做了逐文件的剔除与替换,并有独立的复扫门(tools/import-skills.mjs --verify)来证明结果:

  • 删除:真实 API key 文件、登录态缓存、Python 字节码、以及 170 个只属于原作者项目历史的文件(真实播放数据快照、合集映射、逐集一次性脚本、当时操作截图)。
  • 替换为占位符:飞书 base/table/record ID、NAS 路径与内网地址、本机绝对路径、以及真实账号/作品标识(视频号 FINDER_ID、抖音 aweme_id、B 站 UID 与 seasonId、小红书笔记与合集 ID、B 站稿件号)。
  • 保留但清空为模板:4 个「被剔除但脚本仍要读」的输入文件,以空结构随包(heji-state.json、map-dushi.json、map-gushi.json、dy_t.example.json)。

复扫门检查 4 类东西:密钥/账号标识/本机路径/内网地址残留、33 个脚本的语法可解析性(防止脱敏改写坏代码)、被剔除文件仍被引用、以及 SKILL.md 是否可被 provider 正常解析。当前结果:85 个文件、0 处残留、语法全通过。

已知边界

  • 部分脚本的输入是采集脚本自己写出的产物(posts.json、*-stats.json、dy_works_all.json),首次运行前并不存在——先跑采集再跑分析。tools/import-report.txt 列出了全部这类引用。
  • 不含真实运营数据:tangshi-pipeline 的五份数据复盘文档(references/data-review-*.md)已按作者要求剔除,正文里对作者账号播放表现的绝对数字与实测倍率也一并改写成定性规则(改写与脱敏分开计数,见 tools/import-report.txt)。保留下的是提炼后的可执行规则——产能上限、发布时段、采样制度、选片权重;要复现同样的口径,用 tangshi-data-review 的采集脚本对自己的账号重跑。
  • xiaohongshu-skills 是第三方 MIT 代码;上游 README(含赞助位与作者联系方式)未随包。
  • 有一处正文提到本包未含的外部 skill:bilibili-upload 的「论文视频投稿」路径依赖外部 skill paper-bilibili-uploader(来自第三方 yhbcode000/paper-share-skills)。本包不含它,相关章节已标明为外部;B 站投稿引擎 biliup 本身已包含。导入报告里会列出所有这类「提到但未打进包」的 skill(tools/import-report.txt)。

结构

dsh-video-pipeline/
├── package.json          # dsh.bundle.patch 是市场收录的硬性要求
├── cordis.patch.yml      # 往 profile 插一行宿主插件行
├── lib/
│   ├── index.js          # 插件入口:apply() 里向 ctx.skills 注册 provider
│   ├── provider.js       # 扫描 skills/、解析 frontmatter、rank 600、resourceBase
│   ├── frontmatter.js    # 无依赖的 YAML frontmatter 子集解析(含块标量与嵌套 map)
│   └── placeholders.js   # {{TOKEN}} 取值与替换
├── skills/               # 19 个 skill(由 tools/import-skills.mjs 生成)
├── authored/             # 本包自撰的 skill 源文件(导入时写入 skills/)
├── docs/                 # skill-flow.svg + .png(由 tools/make-flow-diagram.mjs 生成;不进制品包,README 用 raw 地址取)
├── tools/
│   ├── import-skills.mjs # 可复现导入器:--audit / --write / --verify
│   ├── scrub-rules.mjs   # 剔除、脱敏、文档准确性改写、残留扫描的唯一规则来源
│   ├── verify-artifact.mjs # 打包 → 解包 → 真实加载解出来的入口
│   ├── preflight.mjs     # 只读发布自检(远端占用 / git / 三道门 / 凭据)
│   ├── setup-repo.mjs    # 建仓 + 设 topics + 推送 + 核对远端 SHA
│   └── make-flow-diagram.mjs # 生成 docs/skill-flow.svg + .png
└── test/
    ├── provider.test.mjs # provider 行为 + 对真实 skills/ 的集成断言
    └── rules.test.mjs    # 规则回归:每个用例对应一个真实踩过的坑

开发

node tools/import-skills.mjs --audit   # 只报告:会保留/脱敏/剔除哪些文件
node tools/import-skills.mjs --write   # 重建 skills/
npm run privacy-gate                   # 隐私与语法门(发布前必过)
npm test                               # 22 个单测:provider 行为 + 规则回归
npm run verify:artifact                # 打包 → 解包 → 真实加载解出来的 lib/index.js
npm run preflight                      # 发布前只读自检(含远端名字占用与凭据)

导入器默认从 %USERPROFILE%\.agents\skills 读源,可用 SKILLS_SOURCE 指定别的根。

npm run verify:artifact 是发布前最该跑的一条:源码树测试通过不代表 tarball 能用(files 白名单漏子目录、相对 import 的目标没进包,都会变成「装上就报错」,而 npm 包不可撤回)。它会把 tarball 解出来,直接 import 解出来的 lib/index.js,核对 19 个 skill 与全部占位符。CI 里也跑这条。

发布坐标与三条渠道的落地命令见 PUBLISH.md;验证记录见 VERIFY.md。

许可

MIT。第三方代码见 THIRD-PARTY-NOTICES.md。