@q253595422/dsh-imagegen-video 1.17.1 → 1.17.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,39 @@ Attribution for third-party code is in [NOTICE](./NOTICE).
5
5
 
6
6
  ## Releases
7
7
 
8
+ ### 1.17.2 — Windows 上 ffmpeg 找得到、失败不再被记成通过、视频任务重启不丢
9
+
10
+ - **修 Windows 上所有 ffmpeg 能力不可用。** 「本机找不到 ffmpeg」但
11
+ `where ffmpeg` 有输出——因为同一个问题有四份独立实现,没有一份能在
12
+ Windows 上成立:候选目录只列 POSIX 路径且从不查 PATH(而 winget / scoop /
13
+ 官方 zip 全靠加 PATH 安装)、`path.join(dir, 'ffmpeg')` 匹配不到
14
+ `ffmpeg.exe`、`X_OK` 在 Windows 上无意义。现在收敛成一个入口,
15
+ `locateFfmpeg()` 只剩 `return findTool('ffmpeg')`,两个测试脚本也改用宿主
16
+ 自己的查找。`FFMPEG_PATH`/`FFPROBE_PATH` 由共享查找处理,「填了路径只修好
17
+ 一半功能」不再出现。
18
+ - **修「缺工具的用例被记成 PASS」。** `smoke-code-render` 用 `return` 静默跳过,
19
+ 而 `check()` 把正常返回记 PASS,于是 C5(产出可播放 MP4)、C7(片段可拼接)
20
+ 在缺 ffmpeg 的机器上一直显示「通过」却一行没执行——这正是上一条能藏那么久的
21
+ 原因。三处改为 `skip()`(含顺带发现的 C4c:它原来在缺工具时反而**报红**),
22
+ 汇总固定打印 `N skipped: <名字列表>`。跳过仍退出 0。
23
+ - **修其余 10 处 Windows 假设。** `verify-tracked` 的路径分隔符(150 个文件全被
24
+ 判成未跟踪)、`pnpm` 的 `.cmd` shim、目录符号链接改 junction、
25
+ `cpSync({recursive:true})` 静默退出 127、`URL.pathname` 当文件路径、
26
+ `pnpm pack --ignore-scripts` 在 pnpm 10 已移除、tar/du 把盘符冒号当远程主机、
27
+ `.bin/tsc` 在 Windows 是 POSIX 脚本、`findChrome()` 缺 Windows 候选、
28
+ 跨行正则与 CRLF 检出。CRLF 做了两层:读取处统一归一(`scripts/lib/source-text.mjs`)
29
+ 加 `.gitattributes`。
30
+ - **带上 v1.17.1 之后未发布的五条视频可靠性修复。** 重启后重连正在渲染的远端
31
+ 任务(不再重复提交和扣费)、取消只停本地并如实报 `unsupported`、工作流
32
+ fail-fast 不再误杀独立分支、分镜 carry 重跑标脏下游、跨渠道模型别名歧义以
33
+ 显式 `channelId` 优先。
34
+ - **验证**:`tsc` 0 错、`tsdown` 通过、全量 `pnpm test` EXIT=0 零 FAIL
35
+ (`16/16 code-render checks pass`、`0 skipped`、`UI CONTRACTS VERIFIED` 等)。
36
+ Windows 规则靠 `platform`/`env`/`home` 可注入在 macOS 上验证 15 项断言;
37
+ 「跳过真的显示成 SKIP」用空 `HOME` 实测确认;新增三条反向用例均确认变红。
38
+ - **已知缺口**:Windows 上的行为未在真机实测,机理依据报告者实测的根因;
39
+ `verify-native-ui` 的 DSH token 检查在 Windows 上仍跳过(宿主包在 `app.asar`)。
40
+
8
41
  ### 1.17.1 — 导航不重影、侧栏换座不丢、上限不再自相矛盾
9
42
 
10
43
  - **修「点 A+ 详情页后导航栏出现两个标题」。** 根因在 `GooeyNav` 的
package/README.md CHANGED
@@ -297,7 +297,7 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-1.15.2.tgz
297
297
  <img src="docs/images/wechat-group-qr.png" alt="微信群「龙虾吹水🦞群」的加群二维码" width="360" />
298
298
  </div>
299
299
 
300
- > 二维码 7 天内有效(2026 年 10 月 25 日前)。过期或人数已满时,请改到
300
+ > 二维码 7 天内有效(2026 年 11 月 1 日前)。过期或人数已满时,请改到
301
301
  > [Issues](https://github.com/q253595422/dsh-imagegen-video/issues) 提问题,
302
302
  > 并提醒维护者换一张新码。安全敏感的问题不要发在群里,也不要贴 API 密钥。
303
303
 
@@ -346,8 +346,8 @@ pnpm run upstream:adopt v1.8.3 # 记录「已整合到哪个版本」
346
346
 
347
347
  `upstream:plan` 会把每个改动文件按**能否干净应用到当前树**分类:新增(整份复制)、
348
348
  可直接应用、冲突(需人工读)、本项目自有(视频链、发布说明、授权,不覆盖)。
349
- 它只生成报告,不改任何源码。GitHub Actions 每六小时跑一次检测,有新版本时
350
- 自动开一条带报告的 issue。
349
+ 它只生成报告,不改任何源码。这几个命令都是**手动**跑的——本项目不跟随上游版本线,
350
+ 所以没有定时检测;要跟进时自己跑一次 `upstream:check`。
351
351
 
352
352
  本地打包并安装到 DSH 验收:
353
353
 
@@ -0,0 +1,83 @@
1
+ # v1.17.2 — Windows 上 ffmpeg 找得到、失败不再被记成通过、视频任务重启不丢
2
+
3
+ 一句话概括:Windows 用户第一次能真正用上视频链路;同时修掉一处会让「功能全废但测试全绿」的测试缺陷,并补上 v1.17.1 之后未发布的五条视频可靠性修复。
4
+
5
+ ## 为什么
6
+
7
+ v1.17.1 发布后收到两份 Windows 环境的报告。第一份说所有依赖 ffmpeg 的能力全部拒绝运行——画布拼接、时间线、代码渲染、字幕,一个都跑不了;但 `where ffmpeg` 明明有输出,目录也在 PATH 里。
8
+
9
+ 第二份更值得注意:`npm test` 在 Windows 上跑不绿,11 条独立缺陷。其中最后一条解释了第一份为什么能藏那么久——
10
+
11
+ > `check(name, fn)` 看到 `fn` 正常返回就记 PASS。而缺 ffmpeg 的用例是 `return` 而不是 `skip()`,所以 C5(产出可播放 MP4)和 C7(渲染片段可被拼接)在缺工具的机器上**一直在报告里显示「通过」,实际一行没执行**。
12
+
13
+ 也就是说:**测试全绿,功能全废**。这一版把这两件事一起修掉。
14
+
15
+ ## 做了什么
16
+
17
+ ### ffmpeg 发现:四份实现收敛成一份
18
+
19
+ 同一个问题在仓库里有四份彼此独立的答案,且没有一份能在 Windows 上成立:
20
+
21
+ - `localVideoToolDirs()` 只列四个 POSIX 目录(`~/.local/bin`、Homebrew、`/usr/local/bin`、`/usr/bin`),Windows 上一个都不存在,且**从不查 PATH**——而 winget、scoop、官方 zip 全都靠加 PATH 安装。
22
+ - `findTool()` 用裸名拼接,`path.join(dir, 'ffmpeg')` 永远匹配不到 `ffmpeg.exe`。
23
+ - `locateFfmpeg()` 是第二份候选列表,和上面不共享任何代码。两份列表已经漂了:`/snap/bin` 只在其中一份里。
24
+ - 两个测试脚本又各自内联了一遍。
25
+
26
+ 最关键的证据来自报告者:先改完 `video-tools.ts` 和 `code-render.ts` 之后,`smoke-compose` 的跳过信息里**已经列出了 `D:\Program Files\Kdenlive\bin`**,却仍然判定找不到——因为它在用自己那份逻辑。只修看得见的一处,症状会换个面貌回来。
27
+
28
+ 现在 `locateFfmpeg()` 只剩一行 `return findTool('ffmpeg')`,两个测试脚本也改为调用宿主自己的 `findTool()`。`FFMPEG_PATH` / `FFPROBE_PATH` 由共享的查找处理,所以「手工填了路径只修好一半功能」这个现象不会再有。
29
+
30
+ `findTool` 在 win32 上同时试 `name` 与 `name.exe`,并把可执行性判断退化为 `isFile()`——`X_OK` 在 Windows 上是基于只读属性的模拟,对普通文件是否返回成功并不稳定。
31
+
32
+ ### 测试里「跳过」不再冒充「通过」
33
+
34
+ `smoke-code-render` 里三处 `return` 静默跳过全改成 `skip()`:
35
+
36
+ - **C5**(产出可播放 MP4)、**C7**(渲染片段可被拼接)——原先缺 ffmpeg 时记 PASS。
37
+ - **C4c** 顺带挖出来的反向问题:它同样依赖 ffmpeg,但原来没有守卫,在缺工具的机器上拿到 `render-no-ffmpeg` 而不是 `render-timeout`,于是**报红**。同一台机器,一边假绿一边假红。
38
+ - C5 里还有一层更隐蔽的:`probeWithFfprobe()` 返回 undefined 时整段 ffprobe 断言被 `if` 跳过,于是「PLAYABLE」这个名字在有 ffmpeg、没 ffprobe 时是没人验证过的断言。现在无 ffprobe 就整个 C5 记 SKIP,有则硬断言。
39
+
40
+ 汇总行固定打印 `N skipped: <名字列表>`,有跳过时通过行写 `, N not exercised`。跳过仍然退出 0——跳过不等于失败。
41
+
42
+ ### 其余 Windows 兼容(同一份报告的 11 条)
43
+
44
+ | 位置 | 问题 |
45
+ |---|---|
46
+ | `verify-tracked` | `path.relative` 返回反斜杠,`git ls-files` 返回正斜杠,150 个已跟踪文件全被判成「不在仓库里」 |
47
+ | `verify-reproducible` | `pnpm` 在 Windows 是 `.cmd` shim,Node 不允许 `execFile` 执行;改跑 pnpm 自己的 JS 入口 |
48
+ | 同上 | 目录符号链接在 Windows 需要特权,改用 `'junction'` |
49
+ | 同上 | `cpSync({recursive:true})` 在 Windows 上让进程以退出码 127 静默消失,改手写递归拷贝 |
50
+ | `smoke-storyboard`、`ppt-browser-test` | `URL.pathname` 不是文件路径,Windows 上得到 `/E:/%E3%80%90...` |
51
+ | `verify-pack` | `--ignore-scripts` 在 pnpm 10 被移除;tar/du 把盘符冒号当成远程主机;tar 列表按 `\n` 切会留下 `\r` |
52
+ | `verify-ui-contracts` | `node_modules/.bin/tsc` 在 Windows 是 POSIX shell 脚本,改跑 TypeScript 自己的 JS 入口 |
53
+ | `headless-chrome` | 没有 Windows 浏览器候选,三个浏览器守卫在 Windows 上永久 SKIP |
54
+ | 全部守卫 | 跨行正则写死 `\n`,而 Git for Windows 检出 CRLF;改为读取时统一归一 |
55
+
56
+ `findChrome()` 补上了 Chrome / Edge / Chromium 的 Windows 路径。完整版浏览器需要 `--headless=new` 而 `chrome-headless-shell` 不认它——按可执行文件名判断,放在 `launchChrome()` 内部,调用方零改动。
57
+
58
+ CRLF 那一项做了两层:脚本侧新增 `scripts/lib/source-text.mjs`(读源码统一归一),仓库侧新增 `.gitattributes`(`* text=auto eol=lf`)。归一放在读取处而不是逐个正则加 `\r?`,是为了让以后新写的正则默认就是对的。
59
+
60
+ ### v1.17.1 之后未发布的视频可靠性修复
61
+
62
+ `v1.17.1` 的 tag 停在 10-25 12:19,但之后还有几条修复从未进入任何发布,这次一并带上:
63
+
64
+ - **重启后重连正在渲染的任务。** 队列原本只在内存里,也不带服务商自己的任务 id,所以重启后无法回到一个已经付过费的渲染。现在提交时持久化该 id(只存索引,不存帧),重启后的第一次轮询重连**同一个**远端任务并继续下载,而不是重新提交、重新扣费。任何终态都会清掉记录,索引不会无限增长。
65
+ - **取消只停本地,不编造远端请求。** 各协议族都没有实测过的取消端点——OpenAI 的 `DELETE /videos/{id}` 删的是已完成/已失败的视频,不取消运行中的,而它所属的 Sora API 已于 2026-09-24 关停。所以每个族都报 `unsupported`,面板如实说「渲染可能仍在运行并计费」,而不是假装扣费已停。
66
+ - **工作流 fail-fast 不再误伤独立分支。** 任一节点失败曾被视为整轮结束,杀掉无关分支;现在只阻塞失败节点自己的下游闭包,独立分支跑完时状态报 `partial`。
67
+ - **分镜 carry 重跑会标脏下游。** 从旧尾帧构建的片段原本会静默失配;现在这些镜头标记为 stale(文件保留)并退出拼接。
68
+ - **模型别名跨渠道歧义。** 同名别名原本解析到先遇到的那个渠道,显式选择可能被覆盖并计到另一把 key 上;现在显式 `channelId` 优先。
69
+
70
+ ## 验证
71
+
72
+ - `tsc` 0 错,`tsdown` 构建通过,`verify-reproducible` 跨目录逐字节一致。
73
+ - 全量 `pnpm test` **EXIT=0**,零 `FAIL`;含 `SMOKE TEST OK`、`16/16 code-render checks pass`、`0 skipped: the real ffmpeg encode path ran`、`timeline: 24 checks ok`、`cast: 13 checks ok`、`T6 PART B: 34 PASS / 0 FAIL`、`FRAME GRAB VERIFIED`、`UI CONTRACTS VERIFIED`。
74
+ - **Windows 规则的验证方式**:`findTool` 的 `platform` / `env` / `home` 全部做成可注入,于是一个临时目录加一条假 PATH 就能在 macOS 上证明 `.exe` 后缀、分号分隔、PATH 参与查找、覆盖优先级、执行位差异——15 项断言全过。`home` 可注入不是洁癖:本机 `~/.local/bin/ffmpeg` 真实存在且正是第一个候选目录,不隔离的话所有断言都会「通过」,只是原因不对。
75
+ - **「跳过真的显示成 SKIP」是实测的**,不是推断:`HOME=<空目录> FFMPEG_PATH= node scripts/smoke-code-render.mjs` 得到三行 `SKIP`、`13/16 pass, 3 not exercised`,退出码 0。
76
+ - 反向用例新增三条(`.exe` 后缀、PATH 参与、CRLF 归一),均确认会变红。CRLF 那条注入的是「转成 CRLF」而不是「去掉归一」——在 LF 检出上去掉归一是个 no-op,会报 FALSE GREEN。
77
+ - 一次 CI 红而本地绿的插曲:最初断言「POSIX 查找必须什么都找不到」,而 CI 会在跑测试前把 ffmpeg 装进 `/usr/bin`,POSIX 候选里正好有它。断言测的是机器不是规则,已收窄为「绝不把 `.exe` 当工具」。
78
+
79
+ ## 已知缺口
80
+
81
+ - **Windows 上的行为未在真机实测。** 这台开发机是 macOS。纯语义修复(路径分隔符、`fileURLToPath`、换行归一)可直接推断成立;`pnpm` 入口、junction、tar 盘符、`.bin/tsc`、Chrome 候选这几条是依据报告者实测的根因写的,机理对得上但没有在 Windows 上跑过。报告者已表示会在那边重跑确认。
82
+ - `verify-native-ui.mjs` 的 DSH token 检查在 Windows 上仍然跳过:宿主包在 `app.asar` 里,不是可扫描目录,需要解包才能做文本匹配。这条不算 bug,未动。
83
+ - 缺工具时跳过仍然退出 0。是否让 `skip` 数量 > 0 时返回非零码,留给 CI 显式决定,本版没有启用。