@q253595422/dsh-imagegen-video 1.22.2 → 1.23.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,41 @@ Attribution for third-party code is in [NOTICE](./NOTICE).
5
5
 
6
6
  ## Releases
7
7
 
8
+ ### 1.23.1 — 服饰穿戴:草稿读失败不再把整张表单锁死
9
+
10
+ - **「角色搭配」点不动的根因是草稿读失败变成了永久禁用。** 面板在草稿读回来之前会把整张
11
+ `<fieldset>` 禁用,避免迟到的草稿覆盖用户刚做的编辑;但读**失败**时 `draftLoaded` 永远是
12
+ `false`,于是模式切换、图库入口、上传按钮全部点不动,提示只说「无法读取搭配草稿」。现在
13
+ 只有「正在读」这一小段窗口会锁表单,读失败后表单解锁,提示同时说明「现在仍可继续编辑,但
14
+ 草稿要等重新加载成功才会保存」。
15
+ - **重试成功不覆盖用户眼前的编辑。** 读失败期间改过配方(模式、素材、场景、模型)就记为已编辑,
16
+ 重试或重新挂载拿到的旧草稿不再覆盖它,只解除保存闸。
17
+ - **离线套件的 E1 不再在禁用控件上点空气。** 它的 jsdom 沙箱没有应答 `/outfit/draft`,请求
18
+ 落到 catch-all 抛错,表单因此整块禁用——`dispatchEvent` 仍会触发处理器,所以模式切换看
19
+ 起来被覆盖,而真浏览器会把点击直接丢掉。补上该路由的应答,并新增两条断言钉住「表单与模式
20
+ 按钮在点击前是启用的」。点击后的断言改为等一次重渲染再读(React 在同一个 tick 内批量更新,
21
+ 紧跟着读只能读到渲染前的树)。
22
+ - 反向用例新增一条:把 `formLocked` 改回恒禁用,上述断言必须变红。
23
+
24
+ ### 1.23.0 — 服饰穿戴:商品试穿与角色搭配;生图支持 GIF 动图
25
+
26
+ - **「服饰穿戴」支持两种模式。** 「商品试穿」拿真实商品图当服装参考,保留版型、颜色、图案与材质,人物与至少一张服装图为必选;「角色搭配」把参考服装设计穿到人物身上,人物、服装、姿势三类素材任选其一以上,也能和自己的图混着用。
27
+ - **人物、服装、姿势有了内置图库。** 选图器支持按名称或标签搜索,按分类和来源筛选,姿势还能按视角筛选;服装条目带多视角可切换,姿势可选深度图。18+ 素材默认不显示,需要时手动打开。
28
+ - **提交前先看预览,所见即所发。** 点「准备参考图预览」只下载与排版参考图、不调用模型,右侧给出实际会发送的图片和完整提示词;确认后才调模型。任何编辑、换渠道或换模型都会让预览失效,需要重新准备,避免发出去的和看到的不是同一份。
29
+ - **参考素材超过渠道容量时压成一张编号拼图,不再静默少发。** 一部分模型只收一张参考图,以前多出来的会被丢;现在把全部素材排进一张带「图N 用途」标注的拼图,提示词同步改成按格子编号指代,预览里也会说明这次发的是一张拼图。拼图按原比例留白,不裁切服装或姿势。
30
+ - **搭配草稿自动保存。** 模式、素材、场景、比例、清晰度与所选模型都留在本机,编辑停顿约 0.35 秒即写入,下次打开接着改。
31
+ - **可以完全离线用。** 把 `anhao/ai-pose-gallery-zh` 克隆到本地后填目录路径即可导入整份图库;其余情况图库索引与图片按需缓存到 `~/.dsh/dsh-imagegen/outfit/`,选中后读的是本地副本,第三方站点失效也不会中途失败。
32
+ - **图库数据锁定到固定提交。** 索引与图片都按 Git blob 校验,站点不可达时换镜像重试,并用图片魔数确认拿到的确实是图片;更新失败时继续使用已有离线索引并在面板上说明原因。
33
+ - **参考图片的权利归各来源原作者所有,不适用本插件的代码许可证**,使用时请遵守原站条款,部分素材不允许商用;面板底部会显示当前素材的来源说明与原始链接。
34
+
35
+ #### GIF 动图
36
+
37
+ - **支持 `gpt-image-2.6` 生成 GIF 动图。** 面板新增「静图 / GIF 动图」切换,选了 GIF 才出现帧数与每帧时长的输入;请求按 `output_format: 'gif'` 整形,帧数夹在 2–16、每帧不短于 20ms,超出的按上限收窄而不是发出去被上游拒绝。
38
+ - **不支持的模型与渠道在发请求前就拒绝。** GIF 请求先过能力闸再分派协议:模型不支持、或渠道协议是 `chat-completions`(该请求体根本没有 `output_format` 字段,模型再新也只会出静图)时立即报错,不会静默降级成一张静图却照常计费。订阅渠道同样明确拒绝。
39
+ - **帧数与时长只有一个真值。** 面板上的时长提示、提交的参数、引擎的夹紧用的是同一个函数:清空输入框按「未设置」回落默认值,而不是一处按默认、一处按下限,造成提示 1.8 秒实际 0.4 秒。
40
+ - **GIF 期间不能切到不支持的形态。** 开着 GIF 时「图生图」与「对比」置灰并说明原因,而不是点下去界面闪一下又弹回来看起来像按钮坏了;生成数量固定为 1 并注明原因,因为 GIF 受上游像素预算限制只能出单张。
41
+ - **动图在结果板、历史、画廊与画布里都按动图处理。** mime 按字节魔数判定(GIF87a/GIF89a),下载扩展名、历史记录标记与画廊落盘都认 gif,预览用浏览器原生播放,不会只显示第一帧。
42
+
8
43
  ### 1.22.2 — 侧栏:生图态也有收起和展开键,标签栏对齐宿主
9
44
 
10
45
  - **生图态「收起侧边栏」消失,根因是那条 chrome 条没有 slot 锚点。** macOS 宿主把折叠
package/README.md CHANGED
@@ -15,7 +15,7 @@
15
15
 
16
16
  <p><strong>在 DeepSeek Harness 里,生成、编辑、管理,一站完成;图片与视频同一套工作流。</strong></p>
17
17
  <p><strong>快速导航</strong></p>
18
- <p><a href="#quick-start">🚀 快速开始</a> · <a href="#canvas">无限画布</a> · <a href="#compose">片段拼接</a> · <a href="#ecommerce">电商套图</a> · <a href="#txt2img">文生图 / 图生图</a> · <a href="#txt2video">生视频</a> · <a href="#gallery">模板 / 画廊</a> · <a href="#configuration">模型配置</a> · <a href="#community">交流群</a> · <a href="#license">授权与致谢</a></p>
18
+ <p><a href="#quick-start">🚀 快速开始</a> · <a href="#canvas">无限画布</a> · <a href="#compose">片段拼接</a> · <a href="#ecommerce">电商套图</a> · <a href="#outfit">服饰穿戴</a> · <a href="#txt2img">文生图 / 图生图</a> · <a href="#txt2video">生视频</a> · <a href="#gallery">模板 / 画廊</a> · <a href="#configuration">模型配置</a> · <a href="#community">交流群</a> · <a href="#license">授权与致谢</a></p>
19
19
  </div>
20
20
 
21
21
  <a id="sponsor"></a>
@@ -85,6 +85,7 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
85
85
  | **分镜节点** | 一列镜头各出一段视频,可接上一镜尾帧;成品就是普通视频节点,同样能拼接。 |
86
86
  | **时间线与身份锚定** | 成片可以在时间线里排序、裁剪、加转场再拼;钉住的角色/物品会跟着后续每一次生成。 |
87
87
  | **电商套图** | 从商品参考图生成主图、卖点图、场景图等成套素材。 |
88
+ | **服饰穿戴** | 商品试穿与角色搭配;人物、服装、姿势来自内置图库,自己的模特库就在人物图库里,也可上传或 AI 生成。 |
88
89
  | **文生图 / 图生图** | 使用兼容的生图渠道生成、编辑并比较图片。 |
89
90
  | **生视频** | 文生视频、图生视频、首尾帧与多参考图;按协议族适配异步渲染与轮询。 |
90
91
  | **代码生成** | 让 DSH 里已有的对话模型写绘图程序,本机渲染成视频或图片;不调生图/生视频模型,每个任务单独选。 |
@@ -143,6 +144,38 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
143
144
  <img src="docs/images/ecommerce-mode.png" alt="电商模式:配置商品参考图并生成成套商品视觉" width="100%" />
144
145
  </div>
145
146
 
147
+ <a id="outfit"></a>
148
+
149
+ 把人物、服装和姿势三类参考素材拼成一次编辑请求,先看预览再提交;素材可以来自内置图库、自己的模特库,也可以现场上传或让 AI 生成。
150
+
151
+ - **两种模式**。「商品试穿」保留真实商品图的版型、颜色、图案与材质,人物与至少一张服装图为必选;「角色搭配」把参考服装设计穿到人物身上,三类素材任选其一以上,也可以混合自己的图片。
152
+ - **素材来自内置图库**。人物、服装、姿势各有独立图库,选图器支持按名称或标签搜索、按分类与来源筛选,姿势还能按视角筛选;服装条目带多视角,姿势可选深度图(仅作视觉参考,不是 ControlNet 控制)。默认不显示 18+ 素材,需要时手动打开。
153
+ - **模特库就是人物图库的一部分**。自己上传的人物和 AI 生成的人像都存进同一个模特库,并作为「我的模特」出现在人物图库列表最前面,用来源筛选器就能只看它们;选中即用,不需要再对着另一个独立面板挑。添加照片与「AI 生成模特」都在人物图库顶部完成,生成用当前选中的渠道和模型。
154
+ - **内置素材选中即可用,但先落到本机**。图库项要先下载原图并缓存,预览成功后才允许选入配方,之后每次生成读的都是这份本地副本,不会因为第三方站点失效而中途失败。
155
+ - **图库索引锁定到固定提交**。索引与图片都按 Git blob 校验,来源站不可达时会换镜像重试,并用图片魔数确认拿到的确实是图片;更新失败时继续使用已有离线索引,并在面板上说明原因。
156
+ - **提交前预览**。点「准备参考图预览」只下载与排版参考图、不调用模型,右侧给出**实际会发送**的图片与完整提示词;点「确认生成」才提交。任何一次编辑、换渠道或换模型都会让预览失效,需要重新准备。
157
+
158
+ <details>
159
+ <summary><b>参考图上限、拼图与离线使用</b></summary>
160
+
161
+ - **上限与引擎一致**:人物 1 张 + 服装最多 4 张 + 姿势 1 张,一共 6 张素材;引擎的镜像参考图上限是 5 张,所以满配时会超出一张。
162
+ - **超出时压成一张编号拼图,不静默少发**:参考图张数超过当前模型渠道的容量(部分模型只收 1 张)时,插件把全部素材排进一张带「图N 用途」标注的拼图发给模型,提示词同步改成按格子编号指代,并在预览里说明本次发送的是一张拼图。拼图按原比例留白,不裁切服装或姿势。
163
+ - **体积限制**:单张 10 MiB、合计 16 MiB;任一张超限或格式不支持会直接报错并指出是哪一张,不会降级成少图提交。
164
+ - **搭配草稿自动保存**:模式、素材、场景、比例、清晰度与所选模型都会存到本机,编辑停顿约 0.35 秒即写入;重新打开界面会恢复上次的配方。草稿里的图库条目会重新按索引核对,不会被伪造的地址带进来。
165
+ - **完全离线可用**:把 [`anhao/ai-pose-gallery-zh`](https://github.com/anhao/ai-pose-gallery-zh) 克隆到本地后,在选图器底部填目录路径即可导入——索引仍按同一套 Git blob 校验,读取只发生在该目录内。所有缓存都在 `~/.dsh/dsh-imagegen/outfit/` 下(索引、原图、上传素材与草稿),由你控制。
166
+ - **来源与授权**:
167
+
168
+ | 来源 | 站点 | 说明 |
169
+ | --- | --- | --- |
170
+ | ギア · 写实 | <https://ai-costume-gallery.pages.dev/> | 人物、服装、姿势 |
171
+ | ギア · 动漫 | <https://ai-costume-anime-gallery.pages.dev/> | 服装 |
172
+ | たき AI · CharaDB | <https://charadb-2fi.pages.dev/> | 服装 |
173
+ | Shisei · 中国历代 | <https://github.com/wquguru/shisei> | 服装;非历史服饰考据复原 |
174
+
175
+ 参考图片的权利归各来源原作者所有,**不适用本插件的代码许可证**,使用时须遵守原站条款;部分素材不允许商用。面板底部会显示当前选中素材的来源说明与原始链接。
176
+
177
+ </details>
178
+
146
179
  <a id="txt2img"></a>
147
180
 
148
181
  输入提示词即可生成,也可上传参考图进行编辑。图生图支持**多张参考图**(最多 5 张,单张 10 MiB、合计 16 MiB):可多选、拖拽或粘贴,逐张移除,缩略图里用方向键翻看。请求形状按协议族各自整形——第一张始终在 `image`,其余在 `images`,所以只接受单张的渠道看到的仍是一张图;面板会在提交前就按模型能力拦下超额张数,而不是让服务端默默截断。此外支持多张结果、比例与清晰度设置、任务队列、历史恢复和全屏预览。
@@ -334,7 +367,7 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
334
367
  <img src="docs/images/wechat-group-qr.png" alt="微信群「龙虾吹水🦞群」的加群二维码" width="360" />
335
368
  </div>
336
369
 
337
- > 二维码 7 天内有效(2026 年 11 月 8 日前)。过期或人数已满时,请改到
370
+ > 二维码 7 天内有效(2026 年 11 月 13 日前)。过期或人数已满时,请改到
338
371
  > [Issues](https://github.com/q253595422/dsh-imagegen-video/issues) 提问题,
339
372
  > 并提醒维护者换一张新码。安全敏感的问题不要发在群里,也不要贴 API 密钥。
340
373
 
@@ -347,7 +380,7 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
347
380
 
348
381
  **核心能力**:生图(文生图 / 图生图 / 多参考图编辑)、生视频(文生视频 / 图生视频 /
349
382
  首尾帧 / 多参考图)、图片转可编辑 PPT(最多 12 张,每张一页)、无限画布(图片与视频节点、
350
- 分镜节点、片段拼接、技能)、电商套图、模板库与画廊。
383
+ 分镜节点、片段拼接、技能)、电商套图、服饰穿戴(商品试穿 / 角色搭配)、模板库与画廊。
351
384
 
352
385
  **支持与问题反馈请提到本仓库的 Issues**([Bug 报告](https://github.com/q253595422/dsh-imagegen-video/issues/new?template=bug_report.yml) · [功能建议](https://github.com/q253595422/dsh-imagegen-video/issues/new?template=feature_request.yml) · [全部 Issues](https://github.com/q253595422/dsh-imagegen-video/issues))。
353
386
 
@@ -0,0 +1,70 @@
1
+ # v1.23.1 · 服饰穿戴:草稿读失败不再把整张表单锁死
2
+
3
+ > 各版本改动见 [CHANGELOG.md](../../CHANGELOG.md)。
4
+
5
+ 这一版只修「服饰穿戴」里的一个交互缺陷:**草稿读不到的时候,整张表单变成死的**。
6
+ 用户看到的症状是「角色搭配点了没反应」。
7
+
8
+ ## 症状与根因
9
+
10
+ 面板在草稿读回来之前会把整张 `<fieldset>` 禁用——这本身是对的:迟到的旧草稿会覆盖
11
+ 用户刚做的编辑,所以读的过程中先不让改。
12
+
13
+ 问题出在**读失败**的情况。失败后 `draftLoaded` 永远是 `false`,于是:
14
+
15
+ - 模式切换(商品试穿 / 角色搭配)、图库入口、上传按钮**全部永久点不动**;
16
+ - 提示只有一句「无法读取搭配草稿」,没有任何说明这些控件为什么点不了;
17
+ - 重试加载成功后,用户之前的编辑会被磁盘上的旧草稿整体覆盖。
18
+
19
+ ## 改了什么
20
+
21
+ **只有「正在读」这一小段窗口锁表单。** 读失败后表单解锁,可以继续选素材、切模式、
22
+ 调场景与模型。提示同时补一句后果:
23
+
24
+ > 无法读取搭配草稿:…。请重试加载。**现在仍可继续编辑,但草稿要等重新加载成功才会保存。**
25
+
26
+ 保存本身仍然有 `draftLoaded` 闸,所以放开编辑不会盲覆盖磁盘上的旧草稿。
27
+
28
+ **重试成功不覆盖眼前的编辑。** 读失败期间改过配方(模式、素材、场景、模型)就记为已编辑,
29
+ 此时重试或重新挂载拿到的旧草稿不再 `setRecipe` 覆盖它,只解除保存闸。
30
+
31
+ **预览也不再等草稿。** 「准备参考图预览」只在本机下载并排版参考图,既不写草稿也不调模型,
32
+ 原来却要求 `draftLoaded`——于是草稿读失败时提交按钮看着能点、点下去什么都不发生。
33
+ 这和锁死表单是同一类缺陷,一起修掉。
34
+
35
+ ## 为什么离线套件没抓到
36
+
37
+ E1 的 jsdom 沙箱没有应答 `/api/dsh-imagegen/outfit/draft`,请求落到 catch-all 抛错,
38
+ `draftLoaded` 因此是 `false`,整个表单被禁用。
39
+
40
+ jsdom 的 `dispatchEvent` **仍会触发处理器**,所以「点角色搭配 → aria-checked 翻转」这条
41
+ 断言在沙箱里看起来是有效的;而真浏览器会把落在 disabled 控件上的点击直接丢掉。也就是说
42
+ 这条检查一直在禁用控件上点空气。
43
+
44
+ 此外点击后的断言紧跟着 `dispatchEvent` 读 DOM,而 React 在同一个 tick 内批量更新——那只在
45
+ 更新恰好同步冲刷时才会通过,所以这条检查在不同沙箱搭法下会红绿摇摆。
46
+
47
+ 三处一起改:
48
+
49
+ | 改动 | 目的 |
50
+ | --- | --- |
51
+ | stub 补 `/outfit/draft` 应答 | 让沙箱里的表单真的可用 |
52
+ | 新增「表单与模式按钮在点击前是启用的」两条断言 | 「控件是死的」不能再伪装成「处理器有问题」 |
53
+ | 点击后等一次重渲染再读 | 断言渲染后的树,而不是渲染前的 |
54
+
55
+ 反向用例新增一条:把 `formLocked` 改回恒禁用,上述断言必须变红(实测 1/1 变红)。
56
+
57
+ ## 检查
58
+
59
+ - `pnpm run typecheck`:exit 0。
60
+ - `pnpm test`(独占运行):274 项通过,0 失败。
61
+ - 真浏览器(headless Chromium,把草稿路由注入 500):表单未禁用,点「角色搭配」后
62
+ `aria-checked` 由 `false` 变 `true`,说明文案同步切换,错误提示带上了「仍可继续编辑」。
63
+ - `verify-negative.mjs smoke "permanently disabled fieldset"`:RED as expected。
64
+
65
+ ## 已知边界
66
+
67
+ - 草稿读失败期间做的编辑只在**内存里**。如果一直没能重新加载成功就关掉面板,这些编辑
68
+ 不会落盘——这是刻意的:读不到旧草稿时写盘会盲覆盖。
69
+ - 这一版不改变「草稿读失败」本身的发生概率。它会失败通常是宿主路由或磁盘问题,
70
+ 面板现在能如实说明并允许继续工作。