dsh-video-pipeline 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.1.1 — 仅文档与工具（待发布）
+
+代码与 `0.1.0` 完全一致，`lib/` 无改动；本版只为让 npm 页面显示新的 README（npm 渲染的是**该版本 tarball 里的 README**，改了仓库不会回流）。
+
+- README 增加「19 个 skill 的关系与数据流」编排图，并配一张逐条列出 skill 交接关系的表。
+- 新增 `tools/make-flow-diagram.mjs`：声明式生成 `docs/skill-flow.svg` + 2x `docs/skill-flow.png`（用本机 Chrome 无头渲染）；skill 集合变化时改数据重跑即可。图片列为 `screenshots.json`，但**不进制品包**——README 用 raw 绝对地址取图，`files` 白名单无需包含 `docs/`。
+- 新增 `tools/setup-repo.mjs`：建仓 + 设 topics + 推送 + 核对远端 SHA；幂等，token 只从环境变量或 `~/.secrets/keys.env` 读，输出里不含 token。
+- `tools/preflight.mjs` 修正 npm 名字检查：区分「名字被第三方占用」与「本版本已发布」，并把 maintainers 纳入核对，不再在首发之后永远失败。
+- `tools/import-skills.mjs` 可移植性修复：`.py` 检查器按 `PYTHON` → `python3` → `python` 探测，缺失时如实报「跳过」而非误报语法失败（CI runner 只有 `python3`）。
+- 新增 `docs/`（图与源码）与 `.gitattributes`（行尾统一 LF）。
+
 ## 0.1.0
 
 首发。

package/README.md

@@ -2,12 +2,33 @@
 
 把一条**跑通过的真实短视频生产流水线**作为内置 skill 装进 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)：共 19 个技能（1 个总入口 + 1 个编排 + 17 个原子），随插件一起出现在 agent 的技能目录里。
 
-![流水线编排图](https://raw.githubusercontent.com/439436269-ctrl/dsh-video-pipeline/main/skills/tangshi-pipeline/references/orchestration-flow.png)
+![19 个 skill 的关系与数据流](https://raw.githubusercontent.com/439436269-ctrl/dsh-video-pipeline/main/docs/skill-flow.png)
 
-> 图：`tangshi-pipeline` 的编排流程图——左列是编排层（选题 → 门①报价 → 配音/素材/成片调度 → 门②发布确认 → 并行发布 → 回写），右列是被调用的原子 skill。素材生产分「图片运镜」与「Seedance t2v」两条路线，在 `video-compose` 汇合、可按镜头混用。
+> 图：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），覆盖选题、配音、出图、出视频、运镜、合成、封面、核验、数据复盘、多平台发布、进度回写。
@@ -136,14 +157,17 @@ dsh-video-pipeline/
 │   └── 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 / 三道门 / 凭据）
+│   ├── 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    # 规则回归：10 个用例各对应一个真实踩过的坑
+    └── rules.test.mjs    # 规则回归：每个用例对应一个真实踩过的坑
 ```
 
 ## 开发

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-video-pipeline",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "短视频流水线 skill 包：把一条「编排 skill + 原子 skill」的 AI 短剧生产流水线（TTS 读音校正、文生图/文生视频、图片运镜、成片合成、封面、成片核验、多平台发布）作为内置 skill 装进 DeepSeek Harness，装完即出现在 agent 的技能目录里。Bundled skill pack for DSH: one orchestration skill plus its atomic production skills, shipped inside the plugin and served through a built-in skill provider.",
   "keywords": [
     "dsh",
@@ -36,16 +36,25 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "compatibility": {
+      "dshReleases": {
+        "0.2.1-rc.2": "compatible",
+        "0.2.2-rc.1": "compatible"
+      }
     }
   },
   "scripts": {
     "test": "node --test test/provider.test.mjs test/rules.test.mjs",
-    "check": "node --check lib/index.js && node --check lib/provider.js && node --check lib/frontmatter.js && node --check lib/placeholders.js && node --check tools/scrub-rules.mjs && node --check tools/import-skills.mjs && node --check tools/verify-artifact.mjs && node --check tools/preflight.mjs",
+    "check": "node --check lib/index.js && node --check lib/provider.js && node --check lib/frontmatter.js && node --check lib/placeholders.js && node --check tools/scrub-rules.mjs && node --check tools/import-skills.mjs && node --check tools/verify-artifact.mjs && node --check tools/verify-repo-metadata.mjs && node --check tools/preflight.mjs && node --check tools/setup-repo.mjs && node --check tools/make-flow-diagram.mjs",
     "import:audit": "node tools/import-skills.mjs --audit",
     "import:write": "node tools/import-skills.mjs --write",
     "privacy-gate": "node tools/import-skills.mjs --verify",
     "verify:artifact": "node tools/verify-artifact.mjs",
-    "preflight": "node tools/preflight.mjs"
+    "verify:metadata": "node tools/verify-repo-metadata.mjs",
+    "preflight": "node tools/preflight.mjs",
+    "setup:repo": "node tools/setup-repo.mjs",
+    "diagram": "node tools/make-flow-diagram.mjs"
   },
   "license": "MIT",
   "author": {