@q253595422/dsh-imagegen-video 1.16.1 → 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 +29 -0
- package/docs/releases/v1.17.0.md +80 -0
- package/lib/client.js +3961 -378
- package/lib/client.js.map +1 -1
- package/lib/index.js +511 -45
- package/lib/locale-tables-chunk.js +543 -3
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,35 @@ 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
|
+
|
|
8
37
|
### 1.16.1 — 历史详情补全、两块结果板互斥、发布产物真正可重现
|
|
9
38
|
|
|
10
39
|
- **历史记录不显示生成参数,是前端从没渲染过。** 宿主从生成那一刻就把
|
|
@@ -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 略有差异。
|