@q253595422/dsh-imagegen-video 1.16.0 → 1.17.0

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.0 — 电商六件套、A+ 长图、带货图文,参考图按角色真传
9
+
10
+ - **参考图带角色真传。** 过去 `refRole` 只用来拼一句提示词,真正进 `image` 的
11
+ 永远只有第一张,其余静默丢弃。现在按角色筛出的图全部发送(`[primary,
12
+ ...extras]` → `image` + `images`),角色扩为 `product / packaging / detail /
13
+ style / layout`。上限写引擎的真实值 `EDIT_REFERENCE_LIMIT = 5`,grok 与
14
+ nanobanana 只吃单张的事实在界面写明。
15
+ - **五个新工作区**(导航 6 → 9 项):爆款图复刻、服饰穿戴(模特库落盘
16
+ `~/.dsh/dsh-imagegen/models/`)、商品上架文案、带货图文(含商品链接抓取)、
17
+ A+ 详情页(12 模块 + 导出长图)。
18
+ - **A+ 长图零新依赖。** 浏览器 `<canvas>` 绘制并导出,没引入 `sharp` /
19
+ `node-canvas` / `puppeteer`,没用 `foreignObject`。`APLUS_MAX_HEIGHT = 16000`
20
+ 超限拒绝不截断;文案带高超过块高 40% 时先缩到 0.6 倍再拒绝,那一块保留图片。
21
+ - **商品套图补全。** 白底图合规只作用于主图(纯白 #FFFFFF、商品 ≥85%、强制
22
+ `1:1`,界面写明比例被锁);新增 `layout` 版式参考角色。
23
+ - **商品链接抓取是降级实现。** JSON-LD `Product`(含 `@graph`)优先、og 兜底,
24
+ 抓不到回退手填。SSRF 硬拦:只 http/https,私有段 / 回环 / 云元数据域名 /
25
+ `169.254.169.254` / `.internal` / `.local` / 任何 IP 字面量 / 单标签主机名
26
+ 全拒,`redirect:'manual'` 最多 4 跳每跳重校验,8 秒超时,2 MiB 上限。
27
+ - **顺带修的既有缺陷**:820–1000px 下导航压住「展开右侧对话」(1.16.1 就有,
28
+ 点不到);服饰穿戴上传 6 张只发 4 张的静默丢弃;模特库 `..` 路径逃逸;
29
+ `smoke-canvas-video.mjs` 的 E1 flake 判据;A+ 文案带是不透明白盒子。
30
+ - **验证**:`tsc` 0 错、`tsdown` 通过、全量 `pnpm test` EXIT=0(630 行、5 段
31
+ smoke 全绿、`UI CONTRACTS VERIFIED`)、native-UI 契约 PASS、152 源文件
32
+ tracked、`verify-reproducible` 跨目录逐字节一致。新增断言全部做过负向破坏,
33
+ 改坏必红;长图与折行用真 Chromium 画 canvas 数像素,不靠 jsdom。
34
+ - **已知缺口**:A+ 预览里不叠字(只在导出的长图上出现,留 1.18);Windows
35
+ 的折行未验证(PingFang 与微软雅黑度量不同)。
36
+
37
+ ### 1.16.1 — 历史详情补全、两块结果板互斥、发布产物真正可重现
38
+
39
+ - **历史记录不显示生成参数,是前端从没渲染过。** 宿主从生成那一刻就把
40
+ `prompt` / `size` / `quality` / `detail` 写进索引,`historyList` 一直原样
41
+ 返回,只是从 1.16.0 起结果板只画「本次生成 N 张」和时间。现在图片板与
42
+ 素材库的 `canvasMeta` 统一取自这条历史自己的 `viewingImageEntry`——不是
43
+ 表单里「下次要生成」的值;数量取 `images.length` 而不是条目上的 `n`,两者
44
+ 在「一张图生成失败」时会分叉。视频板补 `prompt` 与 `resolution`,i18n 只
45
+ 复用现成 key。
46
+ - **两块结果板的条件互不排斥。** 视频板判 `kind === 'video'`,图片格判
47
+ `images.length > 0`;生成完成时 `setImages(...)` 会把图片格重新长出来贴在
48
+ 视频下面。1.16.0 的第一次修法是「两个板面各加一个条件」,那正是成因。现在
49
+ 由 `resultSurfaceOf(boardView, viewingVideoEntry)`
50
+ (`src/client/ImageGenPanel.tsx:2689`)单一派生四种状态,两个板面只读它,
51
+ `switch` 穷尽 + `assertNever`:以后加第五种状态编译期就报错。
52
+ - **`verify-reproducible.mjs` 只在同一目录构建两次**,所以「绝对路径进了 CSS
53
+ Module 类名哈希」它永远看不见。`tsdown.config.ts` 改用仓库相对路径
54
+ (`cssRepoPath()`,`:60-66`);检查改为在另一个目录再构建一次,逐字节比对
55
+ `lib/` 下全部 5 个产物(此前漏了同样随包发布的 `client.js.map`),
56
+ `BUILD_INPUTS` 补上 `tsconfig.json`——tsdown 自己不读它,rolldown 读,改一条
57
+ `target` 就能让产物变字节。四种破坏(绝对路径 / 只让 `.map` 依赖 cwd /
58
+ 删掉 tsconfig 输入 / 恢复)逐条确认会红。
59
+ - **参数行换行。** `.canvasMeta` 加 `flex-wrap: wrap` 与 `row-gap: 4px`
60
+ (必须写在 `gap` 之后,简写会覆盖它)。1440px 下短提示词与改前逐像素一致;
61
+ 真实数据里那条 2257 字符的提示词改前在 1440px 下会被压成「本次生成 3 张」
62
+ 每行一个字,这一版顺带修好。
63
+ - **验证**:`tsc --noEmit` / `pnpm build` / `verify-native-ui.mjs` /
64
+ `pnpm test` 全 EXIT=0;真 Chrome 断言 42 PASS(改前 14 FAIL)。
65
+ - **已知未做**:`smoke-canvas-video.mjs` 的 E1 是既有 flake(未改动树上同样偶发
66
+ 失败);CI 的 apt 超时未修;契约守卫两处盲区(选择器语法校验、`token-must-exist`
67
+ 对带 fallback 的报错文案)未补;三处 `HEAD` 写死 `5px` 的按钮未统一。
68
+
8
69
  ### 1.16.0 — 视频历史有封面了,侧栏不再猜宿主的类名
9
70
 
10
71
  - **视频历史此前没有封面,这是设计遗漏。** The host never generated a poster
@@ -0,0 +1,40 @@
1
+ # v1.16.1 — 历史详情补全、两块结果板互斥、发布产物真正可重现
2
+
3
+ 一句话概括:修掉 1.16.0 的三个缺陷——历史记录不显示生成参数、点不同历史会同时出现两块结果板、发布产物换个目录构建就变字节;另外把「结果板换成别的样子」收口成编译期就能拦住的形式。
4
+
5
+ ## 为什么
6
+
7
+ **第一类:数据一直在,只是没人渲染。** 宿主从生成那一刻起就把 `prompt`、`size`、`quality`、`detail` 一并写进历史索引,`historyList` 也一直原样返回。前端从 1.16.0 起只渲染「本次生成 N 张」和时间,于是用户点开一条历史,看不到这条是怎么生成的。补渲染时还有个容易踩的坑:参数必须取自**这条历史记录**,不能取表单里「下次要生成」的值——否则界面上永远是「当前设置」,而不是「这条记录的设置」。
8
+
9
+ **第二类:两块结果板的条件互不排斥。** 视频板判 `resultSurface.kind === 'video'`,图片格判 `images.length > 0`。一次生成完成会 `setImages(...)`,但如果此刻结果板正开着一条视频历史,图片格就会重新长出来贴在视频下面。1.16.0 的第一次修法是「两个板面各加一个条件」——那正是缺陷的成因:互斥靠两处条件恰好互补,任何一处被改、任何新的写入路径都会让它复活。
10
+
11
+ **第三类:检查本身抓不到它该抓的东西。** `verify-reproducible.mjs` 原先只在**同一目录**构建两次再比字节,所以「绝对路径进了 CSS Module 类名哈希」这种路径依赖永远不会被它看见。另外 `tsconfig.json` 不在构建输入清单里——它是 tsdown 之外的另一条静默输入通道(rolldown 自己读它),改一条 `target` 就能让产物变字节,而检查当时不会抱怨。
12
+
13
+ ## 做了什么
14
+
15
+ - **历史详情渲染。** 图片板与素材库的 `canvasMeta` 统一取自 `viewingImageEntry`(这条历史自己的 `prompt` / `size` / `quality` / `detail`),数量用 `images.length` 而不是历史条目里的 `n`——两者在「一张图生成失败」这类情况下会分叉。视频板补 `prompt` 与 `resolution`。i18n 全部复用现成 key,没有新造。
16
+ - **结果板单一派生。** 新增 `resultSurfaceOf(boardView, viewingVideoEntry)`(`src/client/ImageGenPanel.tsx:2689`)产出四个状态:图片历史、视频历史、素材库、什么都没选。两个板面都只读这一个值,`switch` 穷尽分支加 `assertNever` 兜底:以后加第五种状态,编译期就报错,不会出现「新状态只被一个板面认识」。
17
+ - **发布产物可重现。** `tsdown.config.ts` 交给 lightningcss 的 CSS Module 标识从绝对路径改为仓库相对路径(`cssRepoPath()`,`tsdown.config.ts:60-66`)。`scripts/verify-reproducible.mjs` 改为在**另一个目录**再构建一次,逐字节比对 `lib/` 下**全部 5 个产物**(此前漏了 `client.js.map`,而它确实随包发布),`BUILD_INPUTS` 补上 `tsconfig.json`,失败文案改成两条并列成因(迭代顺序 / 路径依赖)。
18
+ - **参数行换行。** `panel.module.css` 的 `.canvasMeta` 加 `flex-wrap: wrap` 与 `row-gap: 4px`。`row-gap` 必须写在 `gap` 之后——`gap` 是简写,会把它覆盖掉。1440px 下短提示词与改前逐像素一致;长提示词(真实数据里最长 2257 字符)改前会被压成「本次生成 3 张」每行一个字,这一版顺带修好。
19
+
20
+ ## 验证
21
+
22
+ 四条独立检查,破坏性验证逐条确认它们真的会红:
23
+
24
+ | 检查 | 结果 |
25
+ |---|---|
26
+ | `tsc --noEmit` | EXIT=0 |
27
+ | `pnpm build` | EXIT=0 |
28
+ | `verify-native-ui.mjs` | PASS,无违规 |
29
+ | `pnpm test` | EXIT=0,`UI CONTRACTS VERIFIED` |
30
+
31
+ - **可重现检查的破坏性验证**:改回绝对路径 → FAIL;只让 `.map` 带路径依赖 → FAIL;把 `tsconfig.json` 从输入清单删掉 → FAIL;恢复后 5 个产物在三个不同目录下 digest 全同。
32
+ - **历史详情的渲染断言**:真 Chrome 里 42 条,改前 14 FAIL,改后全 PASS;负向验证里把图片侧 `size` 改读表单 state、视频侧 `resolution` 渲染空串,各自都会红。
33
+ - **结果板互斥**:视频板开着时图片格不出现;把那条 clip 删掉后,之前生成的那张图还在(证明是被排除,不是被丢弃)。
34
+
35
+ ## 已知未做
36
+
37
+ - `pnpm test` 里的 `smoke-canvas-video.mjs` E1 是一条**既有** flake:未改动的树上同样偶发失败,文本逐字相同。绿的需要重跑一次才可靠,本轮未修。
38
+ - CI 的 apt 步骤超时未修(用户明确说「第二点不要动」),因此 main 的 CI 仍可能因此转红。
39
+ - 契约守卫两处盲区未补:选择器语法校验(插入 `/.shell[data-fullscreen]{…}` 会报 PASS,但 `pnpm build` 会 SyntaxError)、`token-must-exist` 对带 fallback 的 `var(--x, y)` 报的「浏览器会静默丢弃」是假话。
40
+ - 三处 `HEAD` 写死 `5px` 的按钮未统一到 `radius-sm`。
@@ -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 略有差异。