@q253595422/dsh-imagegen-video 1.16.1 → 1.17.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,6 +5,67 @@ Attribution for third-party code is in [NOTICE](./NOTICE).
5
5
 
6
6
  ## Releases
7
7
 
8
+ ### 1.17.1 — 导航不重影、侧栏换座不丢、上限不再自相矛盾
9
+
10
+ - **修「点 A+ 详情页后导航栏出现两个标题」。** 根因在 `GooeyNav` 的
11
+ `updateEffectPosition`:它用 `getBoundingClientRect()` 取 tab 的视口坐标,却
12
+ 拿去给一个 `overflow-x: auto` 容器里的子元素设 `left`。行不溢出时两套坐标
13
+ 相等,一旦容器横向滚动,装饰层和滑块就整体偏一个 `scrollLeft`,看上去每项
14
+ 都多印了一份。改成算 `left`/`top` 时加上 `container.scrollLeft`/`scrollTop`。
15
+ 只在窄于 ~1280px(导航真的溢出)时复现,宽窗口上看不见。
16
+ - **修一次点击扣两次费。** 「服饰穿戴」与「带货图文」的提交按钮同时带着
17
+ `type="submit"` 和指向同一处理函数的 `onClick`,表单提交与点击各触发一次,
18
+ 一次点击发出两个 `/generate` 请求。去掉多余的 `onClick`,只留表单提交。
19
+ - **修侧栏切换器在别的插件抢走侧栏后消失。** `seatOf()` 用 `querySelector`
20
+ 取第一个锚点,而桌面外壳会先渲染一份 `display: none` 的移动端副本,取到的
21
+ 常常是没有盒子、没人看得见的那个。改为按文档顺序取第一个**真的在画**的锚点
22
+ (`isVisible()` 一路向上查到 `body`);「新建会话」行被隐藏时切换器退到栏首,
23
+ 靠 `data-dsh-imagegen-tabs-seat='top'` 补间距。
24
+ - **修空表单写着「参考图上限 0 张」。** `referenceCapacity()` 只返回 `usable`,
25
+ 而它同时取决于上限和已选数量,空表单时就是 0,拿来当「上限」显示等于自相
26
+ 矛盾。新增 `limit` 字段(单纯上限),空表单显示它;提交栏在没选图时改用自己的
27
+ 文案。
28
+ - **三个工作区重排。** 服饰穿戴、带货图文改为分区表单(字段分组带标题与说明);
29
+ 平台选择从 `<select>` 换成四个 pill(当前值在打开前看不见,值与标签不变);
30
+ 生成的文案落进可编辑输入框,复制按钮复制屏幕上的内容而非模型返回原文;空态
31
+ 改用自己的文案键,不再借用「生成结果 1」这类看起来像已有结果的字符串。
32
+ - **验证**:`tsc` 0 错、`tsdown` 通过、全量 `pnpm test` EXIT=0(245 行 `PASS`、
33
+ 0 `FAIL`、`UI CONTRACTS VERIFIED`)、native-UI 契约 PASS、`verify-reproducible`
34
+ 跨目录逐字节一致。导航漂移与双击提交都在真浏览器/真请求计数下验证,并各做了
35
+ 负向破坏(改回去必红);另加静态规则「`<button type="submit">` 不许带
36
+ `onClick`」。
37
+ - **已知缺口**:`scrollTop` 的同款换算保留了,但容器纵向不滚、恒为 0,没有负向
38
+ 对照能证明它必要——如实记在这里,不假装覆盖。
39
+
40
+ ### 1.17.0 — 电商六件套、A+ 长图、带货图文,参考图按角色真传
41
+
42
+ - **参考图带角色真传。** 过去 `refRole` 只用来拼一句提示词,真正进 `image` 的
43
+ 永远只有第一张,其余静默丢弃。现在按角色筛出的图全部发送(`[primary,
44
+ ...extras]` → `image` + `images`),角色扩为 `product / packaging / detail /
45
+ style / layout`。上限写引擎的真实值 `EDIT_REFERENCE_LIMIT = 5`,grok 与
46
+ nanobanana 只吃单张的事实在界面写明。
47
+ - **五个新工作区**(导航 6 → 9 项):爆款图复刻、服饰穿戴(模特库落盘
48
+ `~/.dsh/dsh-imagegen/models/`)、商品上架文案、带货图文(含商品链接抓取)、
49
+ A+ 详情页(12 模块 + 导出长图)。
50
+ - **A+ 长图零新依赖。** 浏览器 `<canvas>` 绘制并导出,没引入 `sharp` /
51
+ `node-canvas` / `puppeteer`,没用 `foreignObject`。`APLUS_MAX_HEIGHT = 16000`
52
+ 超限拒绝不截断;文案带高超过块高 40% 时先缩到 0.6 倍再拒绝,那一块保留图片。
53
+ - **商品套图补全。** 白底图合规只作用于主图(纯白 #FFFFFF、商品 ≥85%、强制
54
+ `1:1`,界面写明比例被锁);新增 `layout` 版式参考角色。
55
+ - **商品链接抓取是降级实现。** JSON-LD `Product`(含 `@graph`)优先、og 兜底,
56
+ 抓不到回退手填。SSRF 硬拦:只 http/https,私有段 / 回环 / 云元数据域名 /
57
+ `169.254.169.254` / `.internal` / `.local` / 任何 IP 字面量 / 单标签主机名
58
+ 全拒,`redirect:'manual'` 最多 4 跳每跳重校验,8 秒超时,2 MiB 上限。
59
+ - **顺带修的既有缺陷**:820–1000px 下导航压住「展开右侧对话」(1.16.1 就有,
60
+ 点不到);服饰穿戴上传 6 张只发 4 张的静默丢弃;模特库 `..` 路径逃逸;
61
+ `smoke-canvas-video.mjs` 的 E1 flake 判据;A+ 文案带是不透明白盒子。
62
+ - **验证**:`tsc` 0 错、`tsdown` 通过、全量 `pnpm test` EXIT=0(630 行、5 段
63
+ smoke 全绿、`UI CONTRACTS VERIFIED`)、native-UI 契约 PASS、152 源文件
64
+ tracked、`verify-reproducible` 跨目录逐字节一致。新增断言全部做过负向破坏,
65
+ 改坏必红;长图与折行用真 Chromium 画 canvas 数像素,不靠 jsdom。
66
+ - **已知缺口**:A+ 预览里不叠字(只在导出的长图上出现,留 1.18);Windows
67
+ 的折行未验证(PingFang 与微软雅黑度量不同)。
68
+
8
69
  ### 1.16.1 — 历史详情补全、两块结果板互斥、发布产物真正可重现
9
70
 
10
71
  - **历史记录不显示生成参数,是前端从没渲染过。** 宿主从生成那一刻就把
@@ -0,0 +1,80 @@
1
+ # v1.17.0 — 电商六件套:多参考图、爆款复刻、服饰穿戴、上架文案、A+ 详情页、带货图文
2
+
3
+ 一句话概括:把 designkit 那套「AI 商品套图」的能力补齐到本插件里。这一版新增五个工作区,底座先做对——参考图带着角色真传给模型,而不是过去那样只在提示词里拼一句「参考第 2 张」。
4
+
5
+ ## 为什么
6
+
7
+ 过去的电商模式只有一条链:一个 slot 出一组图,参考图按 `slot.refRole` 过滤之后,**只把第一张**放进 `image`,其余全部丢掉,提示词里补一句「共 N 张:第 1 张为商品主体」。宿主引擎其实早就支持多张(`src/protocol.ts` 的 `images?: string[]`,`src/engine.ts:955-958` 会 append),缺的一直是前端真的把图传出去。
8
+
9
+ 所以这一版先修底座,再往上长功能:底座做错,上面五个模式都要返工。
10
+
11
+ ## 做了什么
12
+
13
+ ### 底座:参考图按角色真传
14
+
15
+ - `EcommerceRefRole` 扩展为 `none | product | packaging | detail | style | layout`(`src/protocol.ts`),新增 `layout`(版式参考)。
16
+ - 提交时按角色筛出的图**全部**发送:`[primary, ...extras]` 分别进 `image` 与 `images`(`src/client/ImageGenPanel.tsx` 的 `handleEcommerceGenerate` / `buildRequest`)。
17
+ - 上限是引擎的真实上限,不是界面上的好看数字:`EDIT_REFERENCE_LIMIT = 5`;grok 与 nanobanana 只吃单张,多传的会被上游丢弃,界面写明。
18
+
19
+ ### 五个新模式
20
+
21
+ | 工作区 | 说明 |
22
+ |---|---|
23
+ | 爆款图复刻 | 传一张爆款图,按复刻程度与复刻要求重排。`ReplicaWorkspace.tsx` + `replica-prompt.ts`(390 行)+ `replica-capacity.ts` |
24
+ | 服饰穿戴 | 服装图 + 模特图 + 场景预设,模特形象落盘 `~/.dsh/dsh-imagegen/models/`,可用 AI 生成模特 |
25
+ | 商品上架文案 | 标题 / 五点描述 / 关键词,多语言,走既有提示词增强通道 `PROMPT_ENHANCE_API.enhance` |
26
+ | A+ 详情页 | 12 个模块(品牌海报、核心卖点、场景共鸣、细节特写、参数对比、使用步骤、模特上身、信任背书、套装清单、规格表、常见问题、结尾海报),可排图上文案,导出整张长图 |
27
+ | 带货图文 | 3:4 竖版图 + 可直接粘贴的文案(标题 / 正文 / 话题标签),支持粘贴商品链接自动抓取 |
28
+
29
+ 导航从 6 项变 9 项:普通生图 / 素材库 / 无限画布 / 电商模式预览 / 图片转 PPT / 爆款复刻 / 服饰穿戴 / 带货图文 / A+ 详情页。
30
+
31
+ ### 商品套图补全
32
+
33
+ - **白底图平台合规**:勾选后只作用于主图——提示词写入「背景必须是纯白 #FFFFFF,严禁文字、水印、Logo 叠加、边框、投影、道具、场景,商品占画面至少 85%」,尺寸强制 `1:1`,界面同步写明比例被锁。
34
+ - **版式参考(layout)**:卖点图可以传一张版式图学排版,图真传,不只是拼文字。
35
+
36
+ ### A+ 长图:零新依赖
37
+
38
+ `aplus-layout.ts` 算块位(宽 750 / 970 / 1200,间距 0 / 16 / 32),`aplus-draw.ts` 用浏览器 `<canvas>` 绘制并 `toBlob` 导出 PNG,`aplus-text.ts` 负责折行与文案带。没有引入 `sharp`、`node-canvas`、`puppeteer`,也没有用 `foreignObject`(跨域会污染画布)。
39
+
40
+ 护栏:总高超过 `APLUS_MAX_HEIGHT = 16000` 直接拒绝并提示;文案带高超过块高 40% 时先缩到 0.6 倍再拒绝——**拒绝,不截断**,那一块保留图片,界面报出是哪一块。
41
+
42
+ ### 商品链接抓取(降级实现)
43
+
44
+ 宿主侧抓页面,JSON-LD 的 `Product`(含 `@graph` 里嵌套的)优先,og 标签兜底,抽标题 / 主图 / 卖点 / 价格。抓不到就回退手填,不假装成功。
45
+
46
+ SSRF 硬拦:只允许 `http` / `https`;私有段、回环、`169.254.169.254`、`metadata.google.internal` 这类云元数据域名、`.internal` / `.local` / `.home.arpa`、**任何 IP 字面量**、**单标签主机名**全部拒绝;`redirect: 'manual'` 最多 4 跳且每跳重新校验;8 秒超时;2 MiB 上限;`content-type` 必须是 HTML。
47
+
48
+ ## 顺带修的既有缺陷
49
+
50
+ - **导航压住「展开右侧对话」**:820–1000px 宽度下导航栏把对话按钮盖住,点不到。这不是新功能引入的,1.16.1 就已经存在(5 个 tab 时就会发生)。修法是把 `overflow-x: auto` 与 `nav { width: max-content }` 从 `@media (max-width: 760px)` 提为无条件——宽度不够时导航自己横向滚动,不再压别人。
51
+ - **服饰穿戴上传 6 张只发 4 张**:多出来的 2 张被静默丢弃。现在上传上限就是 4 张,文案写明「连同模特图共 5 张,正好是引擎的参考图上限」。
52
+ - **模特库路径逃逸**:`index.json` 里的 `file` 字段带 `..` 时能读到 models 目录外。现在 `safeFileName()` 是唯一入口,`routes.ts` 的资源路由再做一次段级防穿越,模板路由两段路径单独校验。
53
+ - **`smoke-canvas-video.mjs` 的 E1 是 flake**:判据依赖轮询时序,曾把 1.16.1 的发版卡红一次。改为等待确定状态,不加任何重试。
54
+ - **A+ 文案带是不透明白盒子**:第一版先铺不透明纸白再叠半透明白,图上一点透不出来。现在只留一层 `rgba(255,255,255,0.92)`,蓝图上的带子是 `235,235,255`。
55
+
56
+ ## 验证
57
+
58
+ | 检查 | 结果 |
59
+ |---|---|
60
+ | `npx tsc --noEmit` | EXIT=0 |
61
+ | `npx tsdown` | 通过 |
62
+ | `pnpm test`(含 5 段 smoke) | `TEST_EXIT=0`,`SMOKE TEST OK` / `VIDEO SMOKE TEST OK` / `VIDEO DIRECTOR SMOKE TEST OK` / `CANVAS VIDEO SMOKE OK` / `VIDEO PICKER SMOKE OK` / `UI CONTRACTS VERIFIED` |
63
+ | `verify-native-ui.mjs` | `no violations` |
64
+ | `verify-tracked.mjs` | 152 源文件全部已提交 |
65
+ | `verify-reproducible.mjs` | EXIT=0,另一目录构建逐字节一致 |
66
+
67
+ 新增的断言都做过负向验证——把实现改坏必须变红:
68
+
69
+ - 白底合规句泄漏到非主图 slot → 红。
70
+ - 文案带改回不透明 → 红。
71
+ - 删掉一个 `data-aplus-copy` 标记 → 红。
72
+ - 服饰提示改回「最多 6 张」 → 红。
73
+ - 删除 `data-aplus-workspace` 标记 → 红。
74
+
75
+ 长图与折行不是靠 jsdom 判的,用真 Chromium 画真 canvas 数像素:总高 2275.125、块位 `[0, 561.625, 1305.125]`、缝纯纸白、文案带高 180 / 546、超长文案拒画且图片完整、不传文案时与改前逐字节一致。
76
+
77
+ ## 已知缺口
78
+
79
+ - **A+ 预览里不叠字**:文案只出现在导出的长图上,工作区缩略图里看不到。留到 1.18。
80
+ - **Windows 上折行未验证**:字体栈用系统字,PingFang 与微软雅黑的度量不同,Windows 导出的折行位置可能与 macOS 略有差异。
@@ -0,0 +1,48 @@
1
+ # v1.17.1 — 导航不重影、侧栏换座不丢、上限不再自相矛盾
2
+
3
+ 一句话概括:1.17.0 之后报上来的四处界面缺陷,包括一处会重复扣费的提交缺陷,在这一版修掉;全部改动都在界面层,没有动生成链路。
4
+
5
+ ## 为什么
6
+
7
+ 1.17.0 把导航从 6 项扩到 9 项,同时把三个工作区重排了一遍。这两件事各自都对,撞在一起暴露了三个问题:导航行的内容宽度越过了容器宽度,而定位代码把视口坐标当容器坐标用;侧栏切换器假定「新建会话」按钮一定在,别的插件抢走侧栏之后它就不在了;重排把两个表单的提交按钮从 `type="button"` 改成了 `type="submit"`,但 `onClick` 忘了删。
8
+
9
+ 第三个最贵:一次点击会走两条路径,`generate()` 被调用两次,用户被扣两次费。
10
+
11
+ ## 做了什么
12
+
13
+ ### 导航:A+ 详情页不再出现两个标题
14
+
15
+ - **根因**:`GooeyNav` 的 `updateEffectPosition` 用 `getBoundingClientRect()` 取 tab 位置(视口坐标),却用来给一个 `overflow-x: auto` 容器里的子元素设 `left`(容器坐标)。行不溢出时两者相等,一旦容器横向滚动,装饰层和滑块就整体偏移一个 `scrollLeft`,看上去像是每项都多印了一份。
16
+ - **修法**:算 `left`/`top` 时把 `container.scrollLeft`/`scrollTop` 加回去,把视口坐标换算成容器坐标。
17
+ - 只在窄于 ~1280px(导航行真的溢出)时才复现,所以在宽窗口上一直没人看见。
18
+
19
+ ### 侧栏:别的插件抢走侧栏时,切换器换座而不是消失
20
+
21
+ - `seatOf()` 过去用 `querySelector` 取第一个锚点。桌面外壳会先渲染一份 `display: none` 的移动端副本,于是取到的常常是没有盒子、也没人看得见的那个。
22
+ - 现在按文档顺序遍历,取第一个**真的在画**的锚点;`isVisible()` 会一路向上检查到 `body`,自己或任一祖先 `display: none` 就跳过。`sidebarRoot()` 与「新建会话」按钮的查找都用同一条规则。
23
+ - 「新建会话」行被隐藏时,切换器退到栏首,并靠 `data-dsh-imagegen-tabs-seat='top'` 补上一点间距。
24
+
25
+ ### 上限:空表单不再写着「参考图上限 0 张」
26
+
27
+ - `referenceCapacity()` 原先只返回 `usable`,而 `usable` 同时取决于上限和已选数量——表单空着时它就是 0。界面拿它当「上限」显示,于是出现一句自相矛盾的话。
28
+ - 现在多返回一个 `limit`(单纯的上限),空表单显示 `limit`,已选时仍显示 `usable`;提交栏在没选图时也有自己的文案,而不是「本次会带上 0 张」。
29
+
30
+ ### 提交:一次点击只生成一次
31
+
32
+ - 「服饰穿戴」与「带货图文」的提交按钮同时带着 `type="submit"` 和指向同一处理函数的 `onClick`。表单提交和点击各触发一次,一次点击发出两个 `/generate` 请求、扣两次费。去掉多余的 `onClick`,只留表单提交这一条路径。
33
+
34
+ ### 重排后的表单形态
35
+
36
+ - 服饰穿戴、带货图文改用分区表单:字段分组带标题与说明,「服饰穿戴」按服装 / 模特 / 场景分区,「带货图文」按链接 / 商品 / 平台分区。
37
+ - 带货图文的平台选择从 `<select>` 换成四个 pill——`<select>` 的当前值在打开前看不见。四个值与标签不变,`promoImagePrompt` 收到的输入不变。
38
+ - 生成的文案落进可编辑的输入框:标题、正文在生成之后仍能改,复制按钮复制屏幕上的内容,不是模型返回的原文。
39
+ - 三个工作区在 0 宽、极窄、超宽下都不再被压成一条。空态文案改用自己的键,不再借用「生成结果 1」这类看起来像已有结果的字符串。
40
+
41
+ ## 验证
42
+
43
+ - `tsc` 0 错,`tsdown` 构建通过,`verify-reproducible` 跨目录逐字节一致。
44
+ - 全量 `pnpm test` **EXIT=0**:245 行 `PASS`、`FAIL` 计数 0;含 `SMOKE TEST OK`、`VIDEO SMOKE TEST OK`、`GALLERY CHECKS OK`、`LINEAGE CHECKS OK`、`16/16 code-render checks pass`、`timeline: 24 checks ok`、`T6 PART B: 34 PASS / 0 FAIL`、`FRAME GRAB VERIFIED`、`UI CONTRACTS VERIFIED`。
45
+ - 导航三态用**真浏览器**量:选中最后一个 tab 并向右滚动后 `scrollLeft=271/271`,活动 li、装饰层、滑块三者 `x=431`,漂移 0px;滚回 0 与 140 时同样漂移 0px。且负向对照成立——去掉 `scrollLeft` 后这条断言会红。
46
+ - 双击提交用**请求计数**验证:填好商品名点一次提交,`/generate` 只增加 1 次。负向对照把 `onClick` 放回去,这条断言 `RED as expected`。
47
+ - 另加一条静态规则:两个表单文件里任何 `<button type="submit">` 都不许再带 `onClick`。
48
+ - 全部新增断言都做过负向破坏(`verify-negative.mjs`),改坏必红。