@q253595422/dsh-imagegen-video 1.22.1 → 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 +68 -0
- package/README.md +36 -3
- package/docs/releases/v1.22.2.md +99 -0
- package/docs/releases/v1.23.1.md +70 -0
- package/lib/client.js +2719 -757
- package/lib/client.js.map +1 -1
- package/lib/index.js +1016 -22
- package/lib/locale-tables-chunk.js +36 -6
- package/package.json +5 -3
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,74 @@ 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
|
+
|
|
43
|
+
### 1.22.2 — 侧栏:生图态也有收起和展开键,标签栏对齐宿主
|
|
44
|
+
|
|
45
|
+
- **生图态「收起侧边栏」消失,根因是那条 chrome 条没有 slot 锚点。** macOS 宿主把折叠
|
|
46
|
+
控件放在 logoRow 之上的 `topStrip` 里(为了避开红绿灯),而插件「隐藏外来条目」的
|
|
47
|
+
`display: none !important` 把整条吞掉——连带 logoRow 上移、品牌 logo 被压进红绿灯底下,
|
|
48
|
+
用户只剩 ⌘B。改为按**可访问名**(中英文四个词)认出宿主自己的折叠控件,把它所在的
|
|
49
|
+
root 直接子块并入 chrome 白名单。按名字不按类名,是因为宿主类名是构建哈希
|
|
50
|
+
(`kB3qhq_`,上一版还是 `_3WPZCG_`),升级就变。
|
|
51
|
+
- **可见性只用来择优、不做过滤。** 被自己规则隐藏的块必须还能被再次认出来,否则标记
|
|
52
|
+
一次失败就把按钮永久弄丢——这种自锁比原来的 bug 更难查。
|
|
53
|
+
- **生图态「打开侧边栏」也能用了,但原因完全不同:不是没渲染,是被盖住。** 收起后宿主在
|
|
54
|
+
左上角挂 `[data-shell-leading]` 座位(`z-index: 15`),里面是「打开侧边栏」和「新建会话」;
|
|
55
|
+
插件接管中心列是 `--z-takeover: 60`,于是生图态把它压在下层。会话态之所以正常,纯粹因为
|
|
56
|
+
它的插件视图是 `display: none`。实测按钮位置一直正确(`88,11`,28×28),只是中心点命中的
|
|
57
|
+
是插件自己的标题行。
|
|
58
|
+
- **抬座位,不降接管层。** 60 是钉死的:任务板、SSH 等兄弟面板都照着这个数写过,挪它会
|
|
59
|
+
连锁影响插件之外的代码。新增 `--z-shell-seat`(63,层级表独占一个号),只抬这个只在
|
|
60
|
+
收起态存在的宿主座位;同时用宿主发布的 `--dsh-frame-top-clearance` 给面板加顶部内边距,
|
|
61
|
+
免得生图第一行贴在座位底下。
|
|
62
|
+
- **标签栏不再和「新建会话」差 2px,而上一版的几何检查是假绿的。** 真机量出来标签栏
|
|
63
|
+
`16..264`、按钮 `14..266`;检查没发现,是因为 fixture 自己声明了
|
|
64
|
+
`--dsh-sidebar-paint-inset: 3px`,和 CSS 的 fallback 正好一致——检查在和自己的假设对答案。
|
|
65
|
+
真宿主整条祖先链上都没有这个变量,按钮用的是写死的 `margin: 2px`。现在 CSS 不再假装
|
|
66
|
+
知道内缩是多少,`alignToSeat` 直接读兄弟按钮的**已用 margin**——样式表看不见兄弟的
|
|
67
|
+
used value,这是唯一诚实的来源。真机复测两侧 0 漂移、间距 8px。
|
|
68
|
+
- **`role="tab"` 现在兑现了键盘契约。** 上个 PR 加了角色,但两个 tab 都在 Tab 序里、方向键
|
|
69
|
+
什么也不做。改为复用 `tablist.ts` 的 `tabIndexFor` / `onTablistKeyDown`,把 `tabIndex` 写进
|
|
70
|
+
同步选中态的**同一处**,让 `aria-selected` 与 Tab 序永远描述同一个状态;侧栏入口是命令式
|
|
71
|
+
构建,点击和方向键共用同一个 `activate`,避免两条路径漂移。契约扫描因此覆盖 `.ts` 的
|
|
72
|
+
tablist,并新增真浏览器几何检查。
|
|
73
|
+
- **四条修复都补了会变红的反向用例**:删掉 chrome 白名单、删掉抬座位的规则、
|
|
74
|
+
`alignToSeat` 退回读不存在的变量、去掉 roving tabIndex。
|
|
75
|
+
|
|
8
76
|
### 1.22.1 — 深色模式:预览按键恢复可见,浅色画布恢复原样
|
|
9
77
|
|
|
10
78
|
- **深色模式下全屏预览的按键「都看不到」,根因不是填充不够,而是基色跟着主题翻转了。**
|
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 月
|
|
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,99 @@
|
|
|
1
|
+
# v1.22.2 · 侧栏:生图态也有收起和展开键,标签栏对齐宿主
|
|
2
|
+
|
|
3
|
+
> 各版本改动见 [CHANGELOG.md](../../CHANGELOG.md)。
|
|
4
|
+
|
|
5
|
+
这一版只动侧栏。四件事:生图态的两个控件先后被插件自己的规则吞掉、被自己的层级盖住,
|
|
6
|
+
「会话 / 生图」标签栏和宿主的「新建会话」按钮对不齐,标签栏虽然有了 `role="tab"`
|
|
7
|
+
却没兑现这个角色承诺的键盘契约。
|
|
8
|
+
|
|
9
|
+
## 生图态:收起键回来了
|
|
10
|
+
|
|
11
|
+
macOS 宿主把「收起侧边栏」放在 **logoRow 之上的一条窗口 chrome 条**里(`topStrip`,
|
|
12
|
+
那是为了避开左上角红绿灯)。那条 chrome 条不拥有任何 slot 锚点,于是被插件「生图态
|
|
13
|
+
隐藏外来条目」的规则一起 `display: none` 了。
|
|
14
|
+
|
|
15
|
+
后果不只是按钮消失:chrome 条被隐藏后 logoRow 上移,品牌 logo 被压在红绿灯底下。
|
|
16
|
+
收起之后只剩 ⌘B 能回去。
|
|
17
|
+
|
|
18
|
+
现在按**可访问名**(中英文四个词)认出宿主自己的折叠控件,把它所在的 root 直接子块
|
|
19
|
+
并入 chrome 白名单,跟随宿主一起保留。
|
|
20
|
+
|
|
21
|
+
> **为什么按名字认、不按类名认:** 宿主的类名是构建哈希(当前是 `kB3qhq_`,上个版本
|
|
22
|
+
> 还是 `_3WPZCG_`),升级就变。`aria-label` 是宿主对外承诺的可访问名,稳定得多——这也是
|
|
23
|
+
> 本仓库「CSS 不猜哈希类名」那条约定在 JS 侧的对应做法。
|
|
24
|
+
|
|
25
|
+
> **可见性只用来择优,不用来过滤。** 候选块如果被插件自己的规则隐藏了,它必须还能被
|
|
26
|
+
> 再次认出来。按可见性过滤会让标记一次性失败之后永远认不回来,按钮就永久弄丢——
|
|
27
|
+
> 那种自锁比原来的 bug 更难查。
|
|
28
|
+
|
|
29
|
+
## 生图态:展开键也回来了
|
|
30
|
+
|
|
31
|
+
收起之后,宿主会在窗口左上角挂一个 **`[data-shell-leading]` 座位**,里面是「打开侧边栏」
|
|
32
|
+
和「新建会话」。这个座位是 `z-index: 15`。
|
|
33
|
+
|
|
34
|
+
问题在于插件接管中心列用的是 `z-index: 60`(`--z-takeover`)。于是:
|
|
35
|
+
|
|
36
|
+
| 状态 | 插件视图 | 展开键 |
|
|
37
|
+
| --- | --- | --- |
|
|
38
|
+
| 会话 | `display: none` | 看得见 |
|
|
39
|
+
| 生图 | 接管中,`z-index: 60` | **被压在下面** |
|
|
40
|
+
|
|
41
|
+
按钮一直在 DOM 里,位置也正确(实测 `88,11`,28×28),只是中心点命中的是插件自己的
|
|
42
|
+
标题行。会话态之所以正常,纯粹因为它的插件视图是隐藏的。
|
|
43
|
+
|
|
44
|
+
**改法是抬座位,不是降接管层。** `--z-takeover: 60` 在仓库里是钉死的:兄弟面板(任务板、
|
|
45
|
+
SSH)都照着这个数写过,挪它会连锁影响插件之外的代码。所以新增一层 `--z-shell-seat`
|
|
46
|
+
(63,层级表里独占一个号),只抬这个只在收起态存在的宿主座位。
|
|
47
|
+
|
|
48
|
+
同时用宿主自己发布的 `--dsh-frame-top-clearance` 给面板加顶部内边距——宿主文档里就是
|
|
49
|
+
这么约定的:内容抵达左上角的主面板按它做内边距,免得落在红绿灯或控件底下。
|
|
50
|
+
|
|
51
|
+
## 标签栏:不再和「新建会话」差 2px
|
|
52
|
+
|
|
53
|
+
真机(DSH 0.2.1-rc.5)量出来:标签栏 `16..264`,「新建会话」`14..266`,左右各差 2px。
|
|
54
|
+
|
|
55
|
+
上一版的几何检查是**绿的**,因为 fixture 自己声明了 `--dsh-sidebar-paint-inset: 3px`,
|
|
56
|
+
和 CSS 里的 fallback 正好一致——检查在和自己的假设对答案。真宿主整条祖先链上都没有
|
|
57
|
+
这个变量,按钮用的是写死的 `margin: 2px`。
|
|
58
|
+
|
|
59
|
+
所以「跟随宿主同一内缩」这个前提本来就落空,插件一直在用一个凭空 fallback 的 3px。
|
|
60
|
+
|
|
61
|
+
现在 CSS 不再假装知道内缩是多少,只保留 border-box 和 8px 下间距;`alignToSeat`
|
|
62
|
+
直接读兄弟按钮的**已用 margin** 写到标签栏。样式表看不见兄弟的 used value,这是唯一
|
|
63
|
+
诚实的来源——宿主改数字也不用同步改插件。放在 `placeTabs` 每次修复时重测,React 重建
|
|
64
|
+
按钮后不会留旧值。
|
|
65
|
+
|
|
66
|
+
真机复测:标签栏与按钮都落在 `14..266`,左右 0 漂移,间距 8px。
|
|
67
|
+
|
|
68
|
+
## 标签栏:方向键真的能用
|
|
69
|
+
|
|
70
|
+
`role="tab"` 不只是个属性,它承诺了键盘契约:Tab 键进组一次,组内用方向键切换。
|
|
71
|
+
|
|
72
|
+
上一个 PR 给两个按钮加了 `role="tab"`,但两个 tab 都在 Tab 序里,方向键什么也不做。
|
|
73
|
+
现在复用 `src/client/tablist.ts` 的 `tabIndexFor` / `onTablistKeyDown`,把 `tabIndex`
|
|
74
|
+
写进同步选中态的**同一处**,让 `aria-selected` 和 Tab 序永远描述同一个状态。
|
|
75
|
+
|
|
76
|
+
侧栏入口是命令式构建(不是 React),所以手工绑定键盘而不是靠 `onKeyDown`;点击和方向键
|
|
77
|
+
共用同一个 `activate`,避免两条路径悄悄漂移。
|
|
78
|
+
|
|
79
|
+
## 检查
|
|
80
|
+
|
|
81
|
+
这一版的四个修复都补了对应的守卫,且都验证过把缺陷植回后检查会变红:
|
|
82
|
+
|
|
83
|
+
| 修复 | 守卫 | 反向用例注入的缺陷 |
|
|
84
|
+
| --- | --- | --- |
|
|
85
|
+
| 收起键 | smoke 的 `topStrip` 夹具与可见性断言 | 删掉 chrome 白名单那一行 |
|
|
86
|
+
| 展开键 | 契约检查断言规则存在,且其层级高于接管层 | 删掉抬座位的规则 |
|
|
87
|
+
| 标签栏对齐 | fixture 从源码抽出并 eval 真实的 `alignToSeat` | `alignToSeat` 退回读不存在的变量 |
|
|
88
|
+
| 键盘契约 | 契约扫描覆盖 `.ts` 的 tablist | 去掉 roving tabIndex |
|
|
89
|
+
|
|
90
|
+
另外真机验收(桌面 app,通过 CDP 量几何)确认了会话态与生图态的 `topStrip` /
|
|
91
|
+
`logoRow` / 标签栏几何完全一致,折叠控件在生图态可达。
|
|
92
|
+
|
|
93
|
+
## 已知边界
|
|
94
|
+
|
|
95
|
+
- 抬座位这条规则只对 macOS 桌面生效(`[data-platform='darwin']`),Windows 标题栏
|
|
96
|
+
走的是另一条路径,不受影响。
|
|
97
|
+
- 宿主的窗口 chrome 座位结构是宿主内部实现。插件只依赖 `data-shell-leading` 这个
|
|
98
|
+
数据属性,以及「收起侧边栏 / 打开侧边栏」这两个可访问名——宿主改文案时需要一起更新
|
|
99
|
+
词表(`SIDEBAR_TOGGLE_LABELS`)。
|
|
@@ -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
|
+
面板现在能如实说明并允许继续工作。
|