@q253595422/dsh-imagegen-video 1.33.0 → 1.33.1

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,21 +5,22 @@ Attribution for third-party code is in [NOTICE](./NOTICE).
5
5
 
6
6
  ## Releases
7
7
 
8
- ### 未发布 — 导演台在桌面 App 里顶部两颗按钮点不动
8
+ ### 1.33.1 — 视频历史里那条删不掉的「3D 导演台导出」
9
9
 
10
- 只在 macOS 桌面 App(Electron)里出现,浏览器与 web 宿主都复现不出来,所以拖了这么久:宿主的窗口拖动条 `[data-window-drag]` 被 Electron 当成标题栏(`-webkit-app-region: drag`),**它不是一个 CSS 层,点在那里的事件由浏览器进程吃掉、页面根本收不到**。导演台面板是 `position: fixed; inset: 0`、`.shell` 又几乎铺满窗口,于是它最上面那一排——左栏的折叠与关闭——正好落在宿主窗口左上角那块拖动区里。
11
-
12
- - **修复**:给 `.shell` 补 `-webkit-app-region: no-drag`。动态面板不该被窗口手势穿透。规则挂在 `.shell` 而不是 `.root`,因为 `.root` 是 `pointer-events: none`,它根本不参与命中测试,拖动区照样赢。
13
- - **为什么以前测不出来**:`app-region` 在普通浏览器里是空操作,预览页、headless、web 宿主全都测不到。这次的证据是真 Electron 窗口(`titleBarStyle: 'hidden'`,与桌面版同款)里的一次真实 OS 点击:同一枚按钮、同一个坐标——不加规则时 DOM 收不到任何事件,加了之后立刻触发;同一窗口里放在拖动区外的对照按钮两种情况都正常,所以不是点击本身没到。
14
- - **回归守卫**:`verify-ui-contracts.mjs` 新增一条源码断言(`-webkit-app-region: no-drag` 必须在 `.shell` 上),并做过反向注入验证——把这条规则删掉,断言立刻报出这个失败。这条只能从源码守,因为任何浏览器都看不见这个差别。
10
+ 本版只修一件事:历史侧栏里那三条点垃圾桶没反应的「3D 导演台导出」。完整说明见 [docs/releases/v1.33.1.md](./docs/releases/v1.33.1.md)。
15
11
 
16
- ### 1.33.1 — 局域网部署不再 403;多模型对比从历史打开不再空白
12
+ 用户报的是「删不掉?」:历史侧栏里三条一模一样的「1:1 · 64x64 · 0.2s · ffmpeg」,蓝方块缩略图,点垃圾桶没有反应。
17
13
 
18
- 两条都来自用户上报(#50 / #49)。数据层没有改动:两处的磁盘与路由本来都是对的,坏在门口那道守卫和面板那一句 `Promise.all`。
14
+ **它们不是生成结果,是测试产物。** `scripts/smoke-stage-encode.mjs` 的 E9 真的调 `stageEncodeSession()`,而它在编码成功后会把成片写进视频库。那个脚本没有隔离数据目录——`import` 了 `mkdtempSync` / `rmSync` 却一次也没调用——于是 `DSH_HOME` 解析成 `~/.dsh/dsh-imagegen`,每跑一次 `pnpm test` 就往用户的真实视频库追加一条 64×64 纯蓝、6 帧 / 30fps(正好 0.2s)的测试片。缩略图那个蓝方块就是测试用的 `makePng(64, [40, 90, 160])`。
19
15
 
20
- - **#50 局域网访问时全部接口 403**:`isLoopbackRequest` 只认「连接来自回环地址」,而浏览器直连本机网卡(`192.168.x.y`)时 `remoteAddress` 永远是那个网卡地址——于是宿主把 `webServer.host` 绑到具体网卡后,插件每一条 `/api/dsh-imagegen` 都回 `403 forbidden: loopback-only`。现在认两种权威之一:连接来自回环,**或**请求的 `Host` 精确等于监听绑定地址。绑定地址本身就是用户的显式选择,所以它授予权威;`0.0.0.0` / `[::]` 是通配、不是某个地址,一律不授予。真正防 DNS rebinding 的 `sec-fetch-site` 与 Origin 同源检查对两种权威都照旧生效——Host 校验只是让 Origin 比较有了意义,不是替代它。**没有新增 `allowLan` 开关**:多一个开关就多一个「开了就全放行」的误配面。绑定地址按运行时值宽松读取而不是按类型收窄——本地 devDependency 的 `Config.host` 还只写了两个字面量,照类型写会让新宿主支持的网卡地址在类型层就被抹掉。
21
- - **#49 多模型对比重启后点开只剩提示词**:`loadHistoryGroup` 用的是 `Promise.all`——对比组每个模型一个成员条目,**任何一个成员任何一张图取不到**(文件被清理、404、一次瞬时失败),整批 rejected,`setImages` 与 `setBoardView` 都不执行,结果板停在「提示词 + N 张」的空白。单条生成只有一个成员,所以照常出图;四条模型的对比把「什么都不显示」的概率放大了四倍,正好是报告里的形状。现在每个成员各自 settle,一个坏成员只损失它自己。失败数**如实返回**而不是吞掉:静默少画两张会被读成「这次对比只出了两张」。
22
- - **两条都是可复跑的用例,不是「改完看着没问题」**:`smoke-lan-bind-auth.mjs` 把真实路由表起在本机网卡上走真实 HTTP,10 条——含「外域 Host」「外域 Host 且自带自洽 Origin」「cross-site」「Origin 不匹配」四种仍然 403,以及**不传 `bindHost` 时局域网客户端保持旧 403** 这条反向控制(没有它,「一律放行」也能让正例全绿)。`smoke-history-group-images.mjs` 6 条,最后一条是反向对照:同样的输入交给旧的 `Promise.all` 折叠必须整组失败——否则断言太弱,测不出这个 bug。两个都进了 `pnpm test`,另有 `test:lan-auth` / `test:history-group` 单独入口。`smoke-lan-bind-auth.mjs` 自己探测本机非回环 IPv4,探测不到就明确 SKIP(不是「绿」)——测试只在作者那台机器上过,等于没测。
16
+ - **为什么删不掉**:会话 id 是固定的 `e9-real`,条目 id 因此恒为 `stage-e9-real`。索引里堆着三条同 id 的记录,而列表拿 `video:${id}` 当 React key——三行撞在同一个 key 上,React 会把它们当成同一行复用。同时 `removeVideoHistory` 用 `filter(id !== x)` 一次性抹掉全部同 id 条目、却只删第一条的文件,于是界面上看起来「删了一条,另外两条还在」,磁盘上还留下两个孤儿 mp4。
17
+ - **修 1:脚本隔离数据目录。** `smoke-stage-encode.mjs` 在最前面把 `DSH_HOME` 指到 `mkdtempSync(...)`,收尾删掉。跑一遍 `pnpm test` 不再碰真实库(已核对:跑完整套后 `videos/index.json` 的 mtime、条目数与 `files/` 文件数都没变)。
18
+ - **修 2:写入按 id 覆盖,不再追加。** `appendVideoHistory` 与 `appendHistory` 都改成「先删同 id 的旧条目(连同文件),再放到最前」。`id` 本来就是调用方给的稳定标识(导演台按会话 id、拼接按 compose id),重写指的是同一条结果被重新保存。代价写在注释里:被覆盖那条的 poster 若新条目没有,会一起删掉——那是正确的,否则就是永久孤儿。
19
+ - **修 3:删除清掉同 id 的全部文件。** `removeVideoHistory` / `removeHistory` 从 `find` 改成 `filter`,把每条同 id 条目的文件都 unlink。这条专门对付**已经写在盘上的旧索引**——去重只管新写入,用户机器上那三条还得靠它清干净。
20
+ - **修 4:前端兜底去重。** `unifiedHistory` 与 `groupHistoryEntries` 按 id 收口。存储层修好之后盘上仍可能有旧重复条目(已经收到过这种用户),列表是只读投影,在这里再挡一层。
21
+ - **修 5:守门扩到视频库。** `verify-test-isolation.mjs` 原来只认画布写入(`canvas/create`、`canvasStore.*`),所以 `smoke-stage-encode` 一路绿着把数据写进了用户的库。现在 `appendVideoHistory` / `stageEncodeSession` / `appendHistory` / `appendGallery` 都算写盘动作,提示文案也从「会写画布」改成「会写用户数据」。
22
+ - **反向验证**:新增两条断言(`smoke-history-canvas.mjs` 的「同一个 id 再保存一次是覆盖」与「删除一个 id 会连它名下所有旧文件一起清掉」)。把 `appendVideoHistory` 的去重改回追加 → 第一条立刻红;把 `smoke-stage-encode.mjs` 的隔离删掉 → 守门立刻报出这个文件。两处都做过注入验证再恢复。
23
+ - **数据现状**:用户库里那三条已经不在(`videos/index.json` 只剩 8 条真实记录,`files/` 下 0 个 `stage-*`),界面上若还留着行,是宿主进程里的旧渲染状态,重启 App 即可。
23
24
 
24
25
  ### 1.33.0 — 导演台换成真 3D + 时间轴;画布补上层级、锁定隐藏、套图、找节点、体检与目录
25
26
 
@@ -69,6 +70,22 @@ Attribution for third-party code is in [NOTICE](./NOTICE).
69
70
  - **分镜执行接上身份参考;「接上一镜尾帧会丢参考」写在板上**:`submitShot` 原先只做了 `carry` 的尾帧 → 首帧,`castRefsFor` / `castPromptOf` 只在两个 composer 里被调用,所以钉住「阿禾」后在分镜里连跑十条,十条都没有她的图。现在 `cut` 与 `carry` 首镜带最多 4 张身份参考(`MAX_SHOT_REFERENCES`),第一张进 `frames.image`、其余进 `frames.images`,读不出的那张跳过而不是整镜失败;顺带修掉 `castLine` 的 0 基序号(提示词里原本写「参考图 0 是角色…」)。`carry` 第 2 镜起带不上参考**不是漏接线而是契约互斥**(`first_frame` / `last_frame` 与 `reference_image` 在 Seedance / MiniMax 里不能混用)——接缝优先是对的,但用户只会在成片里看见她悄悄变了,所以板上多一行说明会丢哪些镜头、丢几个,对应行挂一枚「不带身份参考」角标:一粒角标而不是整行染色,这一镜仍然能跑。反向注入实测:把 `castSlots` 写死成 0 时所有源码 grep 仍绿,只有 SB5 的运行时断言变红(请求体里没有那张图)。
70
71
  - **「镜头衔接」下拉在 380px 卡片里被截断**:那一格只有 65px,而 `接上一镜尾帧` 需要 94px;英文 186px、俄文 203px(那一格缩到 27px,几乎只剩箭头)。根因是三格 `flex: 1` 的 basis 为 0、永远等分。改成按内容起算 + 允许换行:中文仍是一行 26px,英俄各两行 58px,镜头列表本来就是 `flex: 1` 的滚动区,少 32px 挤不掉底部按钮。三种改法在真浏览器上量过 380 / 420 / 560px × 三语;`verify-canvas-layout.mjs` 新增三语量宽断言,反向注入(退回三格等分)实测变红。
71
72
 
73
+ #### 桌面 App 里导演台顶部两颗按钮点不动
74
+
75
+ 只在 macOS 桌面 App(Electron)里出现,浏览器与 web 宿主都复现不出来,所以拖了这么久:宿主的窗口拖动条 `[data-window-drag]` 被 Electron 当成标题栏(`-webkit-app-region: drag`),**它不是一个 CSS 层,点在那里的事件由浏览器进程吃掉、页面根本收不到**。导演台面板是 `position: fixed; inset: 0`、`.shell` 又几乎铺满窗口,于是它最上面那一排——左栏的折叠与关闭——正好落在宿主窗口左上角那块拖动区里。
76
+
77
+ - **修复**:给 `.shell` 补 `-webkit-app-region: no-drag`。动态面板不该被窗口手势穿透。规则挂在 `.shell` 而不是 `.root`,因为 `.root` 是 `pointer-events: none`,它根本不参与命中测试,拖动区照样赢。
78
+ - **为什么以前测不出来**:`app-region` 在普通浏览器里是空操作,预览页、headless、web 宿主全都测不到。这次的证据是真 Electron 窗口(`titleBarStyle: 'hidden'`,与桌面版同款)里的一次真实 OS 点击:同一枚按钮、同一个坐标——不加规则时 DOM 收不到任何事件,加了之后立刻触发;同一窗口里放在拖动区外的对照按钮两种情况都正常,所以不是点击本身没到。
79
+ - **回归守卫**:`verify-ui-contracts.mjs` 新增一条源码断言(`-webkit-app-region: no-drag` 必须在 `.shell` 上),并做过反向注入验证——把这条规则删掉,断言立刻报出这个失败。这条只能从源码守,因为任何浏览器都看不见这个差别。
80
+
81
+ #### 同批两条用户上报(#50 / #49)
82
+
83
+ 两条都来自用户上报(#50 / #49)。数据层没有改动:两处的磁盘与路由本来都是对的,坏在门口那道守卫和面板那一句 `Promise.all`。
84
+
85
+ - **#50 局域网访问时全部接口 403**:`isLoopbackRequest` 只认「连接来自回环地址」,而浏览器直连本机网卡(`192.168.x.y`)时 `remoteAddress` 永远是那个网卡地址——于是宿主把 `webServer.host` 绑到具体网卡后,插件每一条 `/api/dsh-imagegen` 都回 `403 forbidden: loopback-only`。现在认两种权威之一:连接来自回环,**或**请求的 `Host` 精确等于监听绑定地址。绑定地址本身就是用户的显式选择,所以它授予权威;`0.0.0.0` / `[::]` 是通配、不是某个地址,一律不授予。真正防 DNS rebinding 的 `sec-fetch-site` 与 Origin 同源检查对两种权威都照旧生效——Host 校验只是让 Origin 比较有了意义,不是替代它。**没有新增 `allowLan` 开关**:多一个开关就多一个「开了就全放行」的误配面。绑定地址按运行时值宽松读取而不是按类型收窄——本地 devDependency 的 `Config.host` 还只写了两个字面量,照类型写会让新宿主支持的网卡地址在类型层就被抹掉。
86
+ - **#49 多模型对比重启后点开只剩提示词**:`loadHistoryGroup` 用的是 `Promise.all`——对比组每个模型一个成员条目,**任何一个成员任何一张图取不到**(文件被清理、404、一次瞬时失败),整批 rejected,`setImages` 与 `setBoardView` 都不执行,结果板停在「提示词 + N 张」的空白。单条生成只有一个成员,所以照常出图;四条模型的对比把「什么都不显示」的概率放大了四倍,正好是报告里的形状。现在每个成员各自 settle,一个坏成员只损失它自己。失败数**如实返回**而不是吞掉:静默少画两张会被读成「这次对比只出了两张」。
87
+ - **两条都是可复跑的用例,不是「改完看着没问题」**:`smoke-lan-bind-auth.mjs` 把真实路由表起在本机网卡上走真实 HTTP,10 条——含「外域 Host」「外域 Host 且自带自洽 Origin」「cross-site」「Origin 不匹配」四种仍然 403,以及**不传 `bindHost` 时局域网客户端保持旧 403** 这条反向控制(没有它,「一律放行」也能让正例全绿)。`smoke-history-group-images.mjs` 6 条,最后一条是反向对照:同样的输入交给旧的 `Promise.all` 折叠必须整组失败——否则断言太弱,测不出这个 bug。两个都进了 `pnpm test`,另有 `test:lan-auth` / `test:history-group` 单独入口。`smoke-lan-bind-auth.mjs` 自己探测本机非回环 IPv4,探测不到就明确 SKIP(不是「绿」)——测试只在作者那台机器上过,等于没测。
88
+
72
89
  ### 1.32.0 — 姿势人偶升级成导演台:一个场景、多个角色、多台机位;画布底栏改成三档层级
73
90
 
74
91
  本版把 `v1.31.0` 的「原生姿势节点」升成导演台。完整说明见 [docs/releases/v1.32.0.md](./docs/releases/v1.32.0.md)。
@@ -204,6 +204,58 @@
204
204
  - `verify-ui-contracts.mjs`:目录两侧 id 对齐且先关再执行、一次 `mutate`、`moved === 0` 不写、键位只认 `event.code`、输入条阈值扣掉实测 `chromeHeight`、卡片上不得出现第二个提示词编辑入口等。
205
205
  - `verify-negative.mjs` 现有 **252 条**反向用例(新增 `geometry` / `example` / `health` / `search` / `align` / `history` / `prompt-set` / `isolation` 八个零构建组),逐条实测变红。
206
206
 
207
+ ## 同批修掉的三个用户上报
208
+
209
+ ### 局域网部署不再 403(#50)
210
+
211
+ [#50](https://github.com/q253595422/dsh-imagegen-video/issues/50):宿主把 `webServer.host` 绑到本机网卡(`192.168.x.y`)后,插件每一条 `/api/dsh-imagegen` 都回 `403 forbidden: loopback-only`。
212
+
213
+ 根因是守卫只认「连接来自回环地址」这一种权威。浏览器直连本机网卡时 `socket.remoteAddress` 就是那个网卡地址,永远不满足条件——而它本来也不该满足:客户端确实不是从回环连进来的。
214
+
215
+ 现在认两种权威之一:连接来自回环,**或**请求的 `Host` 精确等于监听绑定地址。几点取舍:
216
+
217
+ - **没有加 `allowLan` 开关**。绑定地址本身就是用户的显式选择,它就该授予权威;多一个开关就多一个「开了就全放行」的误配面。
218
+ - **`0.0.0.0` / `[::]` 不授予任何权威**。它们是通配、不是某个地址,浏览器没法把它敲进地址栏,也就无从比较 Host,这种部署保持原来的 loopback-only 行为。
219
+ - **`sec-fetch-site` 与 Origin 同源检查对两种权威都照旧生效**——那才是真正防 DNS rebinding 的部分,Host 校验只是让 Origin 比较有了意义,不是替代它。
220
+ - 绑定地址按**运行时值**宽松读取,没有按类型收窄:本地 devDependency 的 `Config.host` 还只写了两个字面量,照类型写会把新宿主支持的网卡地址在类型层就抹掉。
221
+
222
+ `scripts/smoke-lan-bind-auth.mjs` 把真实路由表起在本机网卡上走真实 HTTP,10 条:
223
+
224
+ ```
225
+ PASS LAN bind: browser on the bind address is allowed
226
+ PASS LAN bind: a foreign Host is still refused
227
+ PASS LAN bind: foreign Host with a self-consistent Origin is still refused
228
+ PASS LAN bind: cross-site marker is still refused
229
+ PASS LAN bind: a mismatched Origin is still refused
230
+ PASS loopback bind: localhost Host is allowed
231
+ PASS loopback bind: 127.0.0.1 Host is allowed
232
+ PASS loopback bind: a foreign Host is still refused
233
+ PASS a bind address other than the one reached grants nothing
234
+ PASS no bindHost: a LAN client keeps the old 403
235
+ ```
236
+
237
+ 最后一条是**反向控制**:不传 `bindHost` 时局域网客户端必须保持旧 403。没有它,把守卫改成「一律放行」也能让前面所有正例全绿。脚本自己探测本机非回环 IPv4,探测不到时明确 SKIP 而不是报绿。
238
+
239
+ ### 多模型对比从历史打开不再空白(#49)
240
+
241
+ [#49](https://github.com/q253595422/dsh-imagegen-video/issues/49):多模型对比生成后重启,历史里点开对比条目只显示提示词与张数,不回显图片。
242
+
243
+ 数据层是好的:`history/list` 里每个成员都在、`comparisonId` 都在,取图路由对每一张都回 200。坏在聚合方式——`loadHistoryGroup` 用的是 `Promise.all`,而它是**全或无**的。对比组每个模型一个成员条目,只要**任何一个成员的任何一张图**取不到(文件被清理、一次 404、一次瞬时失败),整批就 rejected,`setImages` 与 `setBoardView` 都不执行,结果板停在那张空白上。
244
+
245
+ 这解释了为什么现象像「渲染层不渲染」:它不是画错了,是根本没走到画那一步。也解释了为什么单条生成正常、只有对比出问题:单条只有一个成员,失败面是 1;四个模型的对比失败面是 4,而且重启后是从磁盘重读,比刚生成完的内存态更容易撞上。
246
+
247
+ 现在逐成员 settle,一个坏成员只损失它自己。失败数**如实返回**而不是吞掉——静默少画两张,用户会读成「这次对比只出了两张」,那比报一个错更糟。界面会显示「4 个结果里有 1 个的图片读取失败,已显示其余结果」(zh/en/ru 三语)。
248
+
249
+ `scripts/smoke-history-group-images.mjs` 6 条,最后一条是反向对照:同样的输入交给旧的 `Promise.all` 折叠必须整组失败——否则断言太弱,测不出这个 bug,而那正是原来让它溜过去的原因。
250
+
251
+ ### 桌面 App 里导演台顶部两颗按钮点不动
252
+
253
+ 只在 macOS 桌面 App(Electron)里出现,浏览器与 web 宿主都复现不出来。宿主的窗口拖动条 `[data-window-drag]` 被 Electron 当成标题栏(`-webkit-app-region: drag`),**它不是一个 CSS 层,点在那里的事件由浏览器进程吃掉、页面根本收不到**。导演台面板是 `position: fixed; inset: 0`、`.shell` 又几乎铺满窗口,于是它最上面那一排——左栏的折叠与关闭——正好落在宿主窗口左上角那块拖动区里。
254
+
255
+ 修复是给 `.shell` 补 `-webkit-app-region: no-drag`。规则挂在 `.shell` 而不是 `.root`,因为 `.root` 是 `pointer-events: none`,它根本不参与命中测试,拖动区照样赢。
256
+
257
+ 为什么以前测不出来:`app-region` 在普通浏览器里是空操作,预览页、headless、web 宿主全都测不到。这次的证据是真 Electron 窗口(`titleBarStyle: 'hidden'`,与桌面版同款)里的一次真实 OS 点击——同一枚按钮、同一个坐标,不加规则时 DOM 收不到任何事件,加了之后立刻触发;同一窗口里放在拖动区外的对照按钮两种情况都正常。`verify-ui-contracts.mjs` 现在有一条源码断言守住它,并做过反向注入验证。
258
+
207
259
  ## 已知边界
208
260
 
209
261
  - **3D 视口不画辅助线**(关节标记、机位视锥)。这些在 2D 版是画上去的,在 3D 里是要在场景中生成的实体,尚未补。导出(`guides: false`)与预览(`guides: true`)在 3D 下看起来一样。
@@ -0,0 +1,61 @@
1
+ # v1.33.1 — 视频历史里那条删不掉的「3D 导演台导出」
2
+
3
+ > 用户报的是四个字:「删不掉?」——历史侧栏里有三条一模一样的「1:1 · 64x64 · 0.2s · ffmpeg」,蓝方块缩略图,点垃圾桶没反应。
4
+ >
5
+ > 查下去发现是两件事叠在一起:**那三条根本不是生成结果,是测试产物**;而它们之所以删不掉,是因为同一个 id 被写了三遍,前端撞 key、删除侧又只清了一半。这一版把两个根因都修掉,也把那道本该拦住它们的守门补上。
6
+
7
+ ## 那三条是什么
8
+
9
+ `scripts/smoke-stage-encode.mjs` 的 E9 用例真的调 `stageEncodeSession()`——不是打桩,是走完整条编码路径。它在编码成功后会把成片写进视频库,这本身是对的:测的就是「导出的 mp4 能被宿主编出来」。
10
+
11
+ 问题是这个脚本**没有隔离数据目录**。它 `import` 了 `mkdtempSync` / `rmSync`,却一次也没有调用;`DSH_HOME` 于是解析成 `~/.dsh/dsh-imagegen`,也就是用户的真实库。每跑一次 `pnpm test`,就往里追加一条测试片:
12
+
13
+ | 字段 | 值 | 来源 |
14
+ |---|---|---|
15
+ | 缩略图 | 64×64 纯蓝 | `makePng(64, [40, 90, 160])` |
16
+ | 时长 | 0.2s | 6 帧 / 30fps |
17
+ | model | `ffmpeg` | 走宿主编码 |
18
+ | prompt | 「3D 导演台导出」 | 写死在脚本里 |
19
+ | id | `stage-e9-real` | 会话 id 固定为 `e9-real` |
20
+
21
+ 三个字段凑在一起,界面上就是一行看起来完全正常的记录——除了它永远不消失。
22
+
23
+ ## 为什么删不掉
24
+
25
+ 两处叠加,单独任何一处都不至于。
26
+
27
+ **存储层:同 id 只覆盖一半。** `appendVideoHistory` 走的是追加。索引里于是堆着三条 id 完全相同的记录,而列表拿 `video:${id}` 当 React key——三行撞在同一个 key 上,React 把它们当成同一行反复复用,渲染出来的「三条」其实是同一份数据的三次复用。
28
+
29
+ **删除层:抹索引和删文件不是同一个集合。** `removeVideoHistory` 用 `filter(id !== x)` 一次性抹掉全部同 id 条目(这一点是对的,旧索引里的重复必须靠它清干净),但紧接着只 `find` 第一条的文件去 unlink。结果是索引里三条全没了、磁盘上留两个孤儿 mp4;而前端因为 key 撞车+重新读回来的那份还没落盘,用户看到的是「点了删除,行还在」。
30
+
31
+ 同一条链上的 `appendHistory` / `removeHistory`(图片历史)是同一个形状,只是还没被踩到。
32
+
33
+ ## 修了什么
34
+
35
+ 1. **脚本隔离数据目录。** `smoke-stage-encode.mjs` 在最前面把 `DSH_HOME` 指到 `mkdtempSync(...)`,收尾 `rmSync` 删掉。跑一遍 `pnpm test` 不再碰真实库。
36
+ 2. **写入按 id 覆盖,不再追加。** `appendVideoHistory` 与 `appendHistory` 都改成「先删同 id 的旧条目(连同文件),再放到最前」。`id` 本来就是调用方给的稳定标识——导演台按会话 id、拼接按 compose id——重写指的是同一条结果被重新保存。代价写在注释里:被覆盖那条独有的 poster 会一起删掉,这是正确的,否则就是永久孤儿。
37
+ 3. **删除清掉同 id 的全部文件。** `removeVideoHistory` / `removeHistory` 的 `find` 改成 `filter`,每条同 id 条目的文件都 unlink。这条专门对付**已经写在盘上的旧索引**——去重只管新写入,用户机器上那三条还得靠它清干净。
38
+ 4. **前端兜底去重。** `unifiedHistory` 与 `groupHistoryEntries` 按 id 收口(`new Map(...).values()` / `seen` Set)。存储层修好之后,盘上仍可能有旧重复条目,而列表是只读投影,在这里再挡一层没有副作用。
39
+ 5. **守门扩到视频库、图片历史与画廊。** 这才是它一直绿着的原因:`verify-test-isolation.mjs` 的 `WRITE_MARKERS` 只认画布写入(`canvas/create`、`canvasStore.*`),所以 `smoke-stage-encode` 每跑一次都在写用户的库,而检查从头到尾没看它一眼。现在 `appendVideoHistory` / `stageEncodeSession` / `appendHistory` / `appendGallery` 都算写盘动作,提示文案也从「会写画布」改成「会写用户数据」。
40
+
41
+ ## 验证
42
+
43
+ 新增两条断言进 `smoke-history-canvas.mjs`,都是这个 bug 的直接反面:
44
+
45
+ - **「同一个 id 再保存一次是覆盖」**——连写三次同 id,`listVideoHistory` 必须只剩一条,且是最后那次的内容。
46
+ - **「删除一个 id 会连它名下所有旧文件一起清掉」**——直接造出「去重之前」的三条同 id 索引、各自指向不同文件,`removeVideoHistory` 之后三个 mp4 都必须不在磁盘上。
47
+
48
+ 两条都做过反向注入:把 `appendVideoHistory` 去重改回追加 → 第一条立刻红(`3 !== 1`);删掉 `smoke-stage-encode.mjs` 的隔离 → 守门立刻报出这个文件名。恢复后全绿。
49
+
50
+ `pnpm run typecheck`、`pnpm test` 全量、`verify-test-isolation.mjs`(80 个脚本 / 7 个写盘者全部指向临时根)通过。
51
+
52
+ ## 你机器上那三条
53
+
54
+ 已经不在盘上了:`~/.dsh/dsh-imagegen/videos/index.json` 只剩 8 条真实记录,`files/` 下 0 个 `stage-*`,mtime 停在这一轮排查之前。界面上如果还留着行,是宿主进程里的旧渲染状态——重启 App 即可,不需要再点一次删除。
55
+
56
+ 装了这个版本之后,`pnpm test` 也不会再往真实库里写测试片了。
57
+
58
+ ## 已知边界
59
+
60
+ - **旧索引里的孤儿文件只能靠「删那一条」清掉**,没有一次性扫描。刻意不做:扫描要在每次启动时遍历整个 `files/` 并判断哪些没人引用,而「没人引用」的判定一旦写错就是删用户的数据。宁可让孤儿多待一会儿,等用户删到它。
61
+ - **`id` 相同即视为同一条**。如果将来有调用方需要「同一份内容保存两次、两条都在」,得换一种 id 生成方式,而不是把这个覆盖改回追加。
package/lib/client.js CHANGED
@@ -42,7 +42,7 @@ window.__ModuleLoader__.load({
42
42
  let _deepseek_ai_dsh_client_store = require("@deepseek-ai/dsh-client-store");
43
43
  // src/protocol.ts
44
44
  /** Published package version shared by the host updater and the client UI. */
45
- const PLUGIN_VERSION = "1.33.0";
45
+ const PLUGIN_VERSION = "1.33.1";
46
46
  /** Same-origin route family (loopback-only, mirroring the dsh-ssh fence). */
47
47
  const SETTINGS_API = {
48
48
  describe: "/api/dsh-imagegen/settings/describe",
@@ -135213,8 +135213,11 @@ void main() {
135213
135213
  }
135214
135214
  /** Collapse the per-model history rows that belong to one comparison run. */
135215
135215
  function groupHistoryEntries(entries) {
135216
+ const seen = /* @__PURE__ */ new Set();
135216
135217
  const groups = /* @__PURE__ */ new Map();
135217
135218
  for (const entry of entries) {
135219
+ if (seen.has(entry.id)) continue;
135220
+ seen.add(entry.id);
135218
135221
  const key = historyGroupKey(entry);
135219
135222
  const existing = groups.get(key);
135220
135223
  if (existing === void 0) groups.set(key, {
@@ -135744,7 +135747,7 @@ void main() {
135744
135747
  const ownHistory = history.filter((entry) => entry.canvas === void 0);
135745
135748
  const ownVideos = videoHistory.filter((entry) => entry.canvas === void 0);
135746
135749
  const imageRows = groupHistoryEntries(ownHistory).map(imageRowOf);
135747
- const videoRows = ownVideos.map(videoRowOf);
135750
+ const videoRows = [...new Map(ownVideos.map((entry) => [entry.id, entry])).values()].map(videoRowOf);
135748
135751
  const canvasRows = canvasSummaries.map(canvasRowOf);
135749
135752
  const matches = (row, extra) => {
135750
135753
  if (historyKindFilter !== "all" && row.kind !== historyKindFilter) return false;