@q253595422/dsh-imagegen-video 1.21.0 → 1.22.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,83 @@ Attribution for third-party code is in [NOTICE](./NOTICE).
5
5
 
6
6
  ## Releases
7
7
 
8
+ ### 1.22.1 — 深色模式:预览按键恢复可见,浅色画布恢复原样
9
+
10
+ - **深色模式下全屏预览的按键「都看不到」,根因不是填充不够,而是基色跟着主题翻转了。**
11
+ v1.22.0 把 lightbox 的墨色与所有 `color-mix` 基色都取自 `--dsw-alias-label-primary-foreground`。
12
+ 这个 token 名字像「白色」,实际是**「站在哪种表面上的反色」**:DSH 主题包里它在 `body` 上是
13
+ `#fff`,在 `body[data-ds-dark-theme]` 上是 `#0f1115`。深色主题下它把每个控件的底色与文字
14
+ 一起压成近黑,叠在本来就有 88% 黑的照片遮罩上,实测填充 1.03:1、描边 1.08:1、提示文字 1.11:1、
15
+ 说明文字 1.15:1——不是「太暗」,是和底色同色。改用静态色阶 `--dsw-static-neutral-00`(两套主题
16
+ 下都是白)后,两套主题实测都是**文字 5.34:1、控件边界 5.41:1**。浅色主题的取值一个字节都没变,
17
+ 因为它原本解析出来就已经是 `#fff`。
18
+ - **圆形按钮的填充从 40% 降到 34%,因为 40% 会吃掉图标。** 上一轮为了把圆盘抬到 3:1 用了 40% 填充,
19
+ 而白图标在 40% 填充上只有 4.38:1,低于文字要求的 4.5:1——等于用丢图标换来边框可见。34% 是唯一同时
20
+ 满足两边的取值:图标 5.32:1、圆盘对遮罩 3.10:1。边界本来也由 55% 的描边扛着(5.87:1),
21
+ 填充只需要自己过 3:1 那条线。
22
+ - **无限画布:深色卡片与背景同色的问题修好了,但浅色模式回到了原样。** v1.22.0 用
23
+ `label-primary` 混 12% 去「一次性修好两套主题」,可是这个 token 在浅色下近黑,于是把一个
24
+ 本来没问题的浅色画布也调灰了。事实是:DSH 的 `layer-1/2/3` 在浅色下**全是 `#ffffff`**,
25
+ 白卡片配白背景就是用户原本要的样子;缺陷只在深色。现在 `.root` 的默认值退回
26
+ `bg-layer-1` / `border-l1`(浅色逐字节不变),深色由
27
+ `body[data-ds-dark-theme] .root` 单独覆盖:填充 12% 混色(对画布 1.44:1)、描边 36% 混色
28
+ (3.19:1)。悬停也拆成变量,浅色仍是原来的 `border-l2`。
29
+ - **两处契约都改成同时测两套主题,并修掉两个假绿来源。** 预览的 fixture 原先把
30
+ `label-primary-foreground` 硬写成 `#ffffff`、且只渲染浅色,深色永远没被画出来;现在按
31
+ DSH 真实取值各渲染一遍。画布的 fixture 把 `.module.css` 原样塞进 `<style>`,而
32
+ `:global(...)` 是 CSS Modules 语法、浏览器会丢弃整条规则,所以深色覆盖根本没生效——现在按
33
+ 构建后的样子归一化。新增三条反向用例:深色墨色回退、浅色画布被调暗、圆形按钮丢边界,
34
+ 都确认把缺陷植回后检查变红。
35
+
36
+ ### 1.22.0 — 大图预览可关闭、深色画布节点可辨认,接入 Agnes 图像/视频
37
+
38
+ - **大图预览的关闭按钮原来是「看不见」,不是「没有」。** 按钮一直渲染着,但白色图标画在 16% 白的圆盘上、
39
+ 下面再叠 82% 黑遮罩:圆盘对遮罩 1.67:1、描边 2.03:1,图标本身却和圆盘有 8.15:1。原来的检查之所以是绿的,
40
+ 因为它量的是**图标 vs 自身表面**——圆盘彻底消失也照样满分。现在边界放到描边上而不是填充:填充要抬到
41
+ 40% 才够 3:1,而白色文字放在 40% 填充上会掉到 3.9:1,等于用丢掉文字换边界。浮在照片上、不承载文字的
42
+ 圆形按钮(关闭、左右翻页)同时给 40% 填充与 55% 描边,带文字的药丸保持原样。
43
+ 实测:填充 3.52:1、描边 5.26:1、38×38、中心点命中自身。顺带补了 `:focus-visible` 描边。
44
+ - **一次滚轮不再同时滚动和缩放。** 原处理器是 `onWheel={e => { e.preventDefault(); … }}`,而 React 18 把
45
+ `wheel` 挂在 root 上注册为 **passive**,那句 `preventDefault()` 是死代码——于是浏览器照常滚动,同时
46
+ handler 又改了缩放。现在改用原生 `{ passive: false }` 监听,**只有 Ctrl/⌘ 才缩放**(两个键都认:报障用户
47
+ 在 Windows,插件也发行到 macOS),界面上有提示文字,`overscroll-behavior: contain` 让滚轮在预览内收敛。
48
+ - **预览层内操作不再带动底层工作台滚动。** 上一版只给 stage 加了 `overscroll-behavior`,那只约束 stage 自己的
49
+ 滚动链:遮罩是 `position: fixed; inset: 0`,鼠标停在工具条、说明或留白上,滚轮仍会滚到下面的工作台
50
+ (实测滚了 300px)。现在遮罩层自己吸收滚轮,实测 stage / 工具条 / 边距三个点位都不穿透。
51
+ - **深色画布中节点与背景原来完全同色。** `.root` 和 `.node` 画的是同一个 token `--dsw-alias-bg-layer-1`,
52
+ 对比度实测 **1.00:1**——不是「接近」,是相同。换成 `layer-3` 也不够:深色相邻两层只差 1.298:1,
53
+ 而**浅色下三层全是 `#ffffff`**,换层对浅色零改善。改用 `label-primary` 混色(它永远是背景的反色),
54
+ 同一句声明在两套主题下方向自动正确:深色节点更亮 1.87:1,浅色节点更暗 1.29:1。12% 是两套主题都过
55
+ 1.25 的最小步长。边框同样混色,深色下 **3.07:1**(原 `border-l1` 只有 1.16:1),正好越过
56
+ WCAG 1.4.11 的 3:1。
57
+ - **悬停加强只加强「静止态」,不削弱选中态。** `.node:hover` 是 (0,2,0) 特异性,会盖掉 `.nodeSelected`
58
+ 等 (0,1,0) 规则——悬停一个已选中的节点反而把它降回 hover 强度。用 `:not()` 链显式排除选中/关联/
59
+ 连线目标/重叠/标注中五种状态。
60
+ - **新增 `agnes` 图片协议族**(`agnes-image-2.5-flash` / `2.1-flash` / `2.0-flash`)。此前这类 id 落到
61
+ 「未知协议」,图生图按 OpenAI 编辑协议发 `POST /images/edits` multipart,而 Agnes 根本没有这个端点,
62
+ 网关回 `503 no available server`(实测 14s 后失败)。现在编辑走 `POST /images/generations`,参考图
63
+ 以 URL / `data:` URI 数组放进 `extra_body.image`(多图合成天然支持),输出格式也写在
64
+ `extra_body.response_format`——Agnes 明确禁止顶层 `response_format`。
65
+ - **尺寸改成档位 + 比例。** 面板的清晰度档映射为 `size: 1K/2K/3K/4K`,画幅映射为 `ratio`
66
+ (1:1、3:4、4:3、16:9、9:16、2:3、3:2、21:9);`auto` 回落到 `1K` 且不发 `ratio`。
67
+ - **不再发送 OpenAI 的 `quality` / `detail`。** Agnes 对 `quality` 直接 400
68
+ (`quality is not supported by text image queue`),所以文生图只要用户选了清晰度档就会失败;
69
+ 现在这两个字段只按协议族发送。
70
+ - **新增「Agnes AI 官方」渠道预设。** 预填 `https://apihub.agnes-ai.com/v1`、三个图片模型与
71
+ `agnes-video-2.5-flash`,图片与视频可以共用同一个渠道。
72
+ - **Agnes 视频对齐官方文档。** `agnes-video-2.5-flash` 只接受 `size: "720P"`(其他值在**创建任务前**
73
+ 就返回 `400 size must be 720P`),现在按 id 收窄档位,面板不再提供必然失败的选项,非 flash 的
74
+ `agnes-video-2.5` 保留 480P/720P/1080P;参考图在提交前截断到 5 张
75
+ (`400 images length must not exceed 5`);画幅补上实测可用的 `21:9`;轮询放宽到 2s / 40 分钟
76
+ (实测一个 4 秒片子建完后 35 分钟仍在 `queued`,原来的 20 分钟上限会把还在排队的任务误报成超时)。
77
+ - **画布工具的键盘可达性**:`.root` 是 tab 停留点,工具栏可由键盘走到。
78
+ - **验证**:`pnpm test` 全套 265 项通过、退出 0;`typecheck` 与 `build` 通过;新增真浏览器契约检查
79
+ (预览关闭按钮边界、滚轮语义、遮罩不穿透、深色画布节点对比度),并对每条修复补了**反向用例**——
80
+ 把缺陷注回仓库副本后对应检查必须变红。因为「注释里解释缺陷」会命中「找缺陷」的正则,滚轮检查改用
81
+ TypeScript 自己的 `transpileModule` 剥注释(手写的扫描器会在正则字面量 `/https?:\/\//` 上误判)。
82
+ 另外反向用例抓出过一次自己的**假绿**:遮罩穿透检查最初把监听写死在 fixture 里,等于自证,改正为
83
+ 由源码文本驱动后才真正会在缺陷下变红。
84
+
8
85
  ### 1.21.0 — 画布底部工具条自适应,Agent 生成结果可直接内嵌
9
86
 
10
87
  - **画布底部浮层不再互相压盖,窄了就换行。** 任务工具条、缩放条、缩略图原来是三个各自绝对定位的图层,
package/README.md CHANGED
@@ -184,7 +184,7 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
184
184
 
185
185
  | 协议族 | 模型示例 | 说明 |
186
186
  | --- | --- | --- |
187
- | Agnes 视频 | `agnes-video-2.5-flash`、`agnes-video-2.5` | 提交 `POST /v1/videos`,轮询 `GET /v1/videos/{id}`,取 `metadata.url`;支持文生视频、首尾帧、多参考图、`seed`。 |
187
+ | Agnes 视频 | `agnes-video-2.5-flash`、`agnes-video-2.5` | 提交 `POST /v1/videos`,轮询 `GET /v1/videos/{id}`(文档同时给出 `/agnesapi?video_id=…&model_name=…`,实测两条路径都通),结果取顶层 `url` 或 `metadata.url`;支持文生视频、首尾帧、多参考图、`seed`。**Flash 专属限制**(创建任务前就校验):`size` 只接受 `720P`,参考图最多 5 张,不支持音频/视频参考;画幅另支持 `21:9`。插件按 id 把 Flash 的档位收窄成 `720P`(非 flash 保留 480P/720P/1080P),参考图超出 5 张在提交前截断,不会把必然 400 的请求发出去。 |
188
188
  | 火山 Seedance(方舟) | `doubao-seedance-2-0-260128`、`doubao-seedance-2-0-fast-260128`、`doubao-seedance-1-0-pro-250528` | 方舟原生任务协议:提交 `POST /contents/generations/tasks`,轮询 `GET /contents/generations/tasks/{id}`,成片在 `content.video_url`。提示词与参考图放在 `content` 数组里(参考图带 `role`:`first_frame` / `last_frame` / `reference_image`),比例字段是 `ratio`,分辨率小写。时长:2.x 为 4–15 秒、1.0 为 2–12 秒。分辨率:2.0 支持 480p/720p/1080p/4k,`fast` / `mini` 只到 720p;1.0 为 480p/720p/1080p。1.0 不支持 `reference_image` 角色,`1.0 pro fast` 也不支持尾帧,面板会把这两种模式从该型号上收起来。 |
189
189
  | 算力萌 comemoe | `wan2.2-t2v`、`zhimeng-h3-local` | `wan2.2-t2v` 仅文生视频;`zhimeng-h3-local` 支持图生视频。比例只接受 16:9 / 9:16 / 1:1;5 秒片子实测约 9 分钟。 |
190
190
  | xAI Grok | `grok-imagine-video-1.5`、`grok-imagine-video-1.5-lite` | 提交 `POST /videos/generations`(注意不是 `/videos`),轮询 `GET /videos/{id}`,取 `video.url` 与 `video.duration`。 |
@@ -292,7 +292,12 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
292
292
 
293
293
  在「设置 → 生图配置」添加渠道,填写 API 地址与密钥,检测并选择生图模型。可配置多个提供方,并设置默认生图模型和可选的提示词增强聊天模型。
294
294
 
295
- 支持 OpenAI 兼容的 Images API / Chat Completions,以及 xAI Grok、Google Nano Banana、Seedream、Qwen-Image、GLM-Image、MiniMax 等预置渠道;也可手动添加兼容模型。
295
+ 支持 OpenAI 兼容的 Images API / Chat Completions,以及 xAI Grok、Google Nano Banana、Seedream、Agnes、Qwen-Image、GLM-Image、MiniMax 等预置渠道;也可手动添加兼容模型。
296
+
297
+ **Agnes 图像(`agnes-image-*`)** 与别的渠道有两处不同:
298
+
299
+ - **端点是统一的**:文生图和图生图都走 `POST {apiUrl}/images/generations`。Agnes 没有 `/images/edits`,按 OpenAI 编辑协议发过去会被网关回 `503 no available server`;编辑请求把参考图放进 `extra_body.image`(公共 URL 或 `data:` URI,可多张),输出格式也写在 `extra_body.response_format` 里(顶层的 `response_format` 会被判为错误)。
300
+ - **尺寸是档位 + 比例**:`size` 用 `1K` / `2K` / `3K` / `4K`,比例用 `ratio`(`1:1`、`3:4`、`4:3`、`16:9`、`9:16`、`2:3`、`3:2`、`21:9`)。插件把面板的清晰度档映射成 `size`、把画幅映射成 `ratio`,并且**不发** OpenAI 的 `quality`——Agnes 会直接 400(`quality is not supported by text image queue`)。
296
301
 
297
302
  <details>
298
303
  <summary><b>接口与渠道补充说明</b></summary>
@@ -0,0 +1,48 @@
1
+ # v1.22.0 · 预览关得掉、深色画布看得清,外加 Agnes 图像/视频
2
+
3
+ > 各版本改动见 [CHANGELOG.md](../../CHANGELOG.md)。
4
+
5
+ 本版修掉两个「功能其实在,但用不了」的问题,并接入 Agnes 的图片与视频协议族。
6
+ 两个 bug 都有个共同点:**原来的测试是绿的**,因为它们量错了对象。
7
+
8
+ ## 大图预览
9
+
10
+ - **关闭按钮一直在,只是看不见。** 白色图标画在 16% 白的圆盘上,下面再叠 82% 黑遮罩:
11
+ 图标与圆盘之间 8.15:1,圆盘与遮罩之间只有 1.67:1,描边 2.03:1。原来的检查量的是
12
+ 「图标 vs 自身表面」,所以连圆盘彻底消失都照样满分——它验的是字看得清,不是按钮找得到。
13
+ 现在把边界放在描边上:填充要抬到 40% 才够 3:1,而白字放在 40% 填充上会掉到 3.9:1,
14
+ 等于用丢掉文字换来边界。浮在照片上、不承载文字的圆形按钮(关闭、左右翻页)同时给
15
+ 40% 填充与 55% 描边;带文字的药丸保持原样。实测填充 3.52:1、描边 5.26:1。
16
+ - **一次滚轮只做一件事。** 原来的处理器写了 `preventDefault()`,但 React 18 把 `wheel`
17
+ 注册成 passive,那句是死代码——浏览器照常滚动,同时处理器又改了缩放,所以一次滚轮既
18
+ 滚动又缩放。现在改用原生非被动监听,**普通滚轮滚动、Ctrl/⌘ + 滚轮缩放**,界面上写明
19
+ 了这条规则。两个修饰键都认:报障用户在 Windows,插件也发行到 macOS。
20
+ - **预览里的滚轮不会再滚到后面的工作台。** 遮罩是 `position: fixed`,鼠标停在工具条或
21
+ 说明文字上时,滚轮原本会滚到底下的工作台(实测 300px)。现在遮罩自己吸收滚轮,
22
+ 停在预览内的任何位置都不会带动背后。
23
+
24
+ ## 无限画布
25
+
26
+ - **节点与背景原来是完全同色,不是「接近」。** 两者画的是同一个主题 token,对比度实测
27
+ 1.00:1。换一层也不行:深色下相邻层只差 1.298:1,浅色下三层全解析成 `#ffffff`。
28
+ 现在用「背景反色」混出节点表面,同一句声明在两套主题下方向自动正确——深色时节点更亮
29
+ (1.87:1),浅色时节点更暗(1.29:1)。
30
+ - **边框达到 3.07:1**(原来 1.16:1),越过 WCAG 1.4.11 对非文本边界的 3:1。
31
+ - **悬停只加强静止态。** 悬停一个已选中的节点不会再把它降回悬停强度。
32
+
33
+ ## Agnes 图像 / 视频
34
+
35
+ - **图生图不再必然 503。** 此前这类模型按 OpenAI 编辑协议发 `POST /images/edits`,
36
+ 而 Agnes 没有这个端点,网关回 `503 no available server`。现在编辑走
37
+ `POST /images/generations`,参考图放进 `extra_body.image`,输出格式也写在 `extra_body` 里。
38
+ - **文生图不再必然 400。** 只要用户选了清晰度档,原来的请求就带 `quality`,而 Agnes 对它
39
+ 直接返回 400。这两类 OpenAI 专有字段现在只按协议族发送。
40
+ - **视频档位与文档对齐。** Flash 只接受 `720P`,其他值在创建任务前就 400;参考图上限 5 张;
41
+ 画幅补上实测可用的 `21:9`;轮询放宽到 2s / 40 分钟——实测一个 4 秒片子建完后 35 分钟
42
+ 仍在排队,原来的 20 分钟上限会把还在排队的任务误报成超时。
43
+
44
+ ## 关于验证
45
+
46
+ 两个 bug 的修复都补了真浏览器契约检查,并且每条都配了**反向用例**:把缺陷注回仓库副本,
47
+ 对应检查必须变红。反向用例这次还抓出过一次自己写的假绿——遮罩穿透的检查最初把监听写死在
48
+ 测试页面里,等于自证,改正为由源码驱动后才真正会在缺陷下变红。
@@ -0,0 +1,85 @@
1
+ # v1.22.1 · 深色模式下预览按键回来了,浅色画布也回到原样
2
+
3
+ > 各版本改动见 [CHANGELOG.md](../../CHANGELOG.md)。
4
+
5
+ 这一版是对 v1.22.0 的修正。上一版修对了症状的**方向**,但两处都选错了 token,
6
+ 结果一处没修好、一处改坏了不该改的东西。
7
+
8
+ ## 深色模式:全屏预览的按键「都看不到」
9
+
10
+ 不是「太暗」,是**和底色同色**。
11
+
12
+ v1.22.0 把预览控件的墨色和所有 `color-mix` 基色都取自
13
+ `--dsw-alias-label-primary-foreground`。这个名字看起来就是「白色」,但它真正的语义是
14
+ **「站在某种实色表面上的反色」**——它跟着主题翻:
15
+
16
+ | token | 浅色 `body` | 深色 `body[data-ds-dark-theme]` |
17
+ | --- | --- | --- |
18
+ | `--dsw-alias-label-primary-foreground` | `#fff` | **`#0f1115`** |
19
+ | `--dsw-static-neutral-00` | `#fff` | `#fff` |
20
+
21
+ 预览的遮罩本来就是 88% 黑(`--dsw-alias-bg-mask-photo` 叠在最坏情况下是 `#1f1f1f`)。
22
+ 深色主题下,近黑的底再叠到近黑的遮罩上:
23
+
24
+ | 元素 | v1.22.0 实测(深色) | 现在实测(两套主题同值) |
25
+ | --- | --- | --- |
26
+ | 药丸 / 圆形按钮填充 | 1.03:1 | 5.34:1(文字) |
27
+ | 描边 | 1.08:1 | 5.41:1(边界) |
28
+ | 滚轮提示文字 | 1.11:1 | 5.34:1 |
29
+ | 图片说明文字 | 1.15:1 | 5.34:1 |
30
+
31
+ 改成静态色阶 `--dsw-static-neutral-00` 后,**浅色主题一个字节都没变**——它原本解析出来
32
+ 就已经是 `#fff`,这次只是把「碰巧是白」变成「永远是白」。
33
+
34
+ ### 圆形按钮的填充:40% → 34%
35
+
36
+ 上一轮为了把圆盘抬到 3:1 用了 40% 白填充,可是白图标放在 40% 填充上只有 **4.38:1**,
37
+ 低于文字要求的 4.5:1——用丢图标换来了边框可见,只是陷阱换了个位置。
38
+
39
+ 34% 是唯一同时满足两边的取值:
40
+
41
+ ```
42
+ fill 28% -> 图标 6.51:1, 圆盘 2.53:1 (圆盘看不见)
43
+ fill 34% -> 图标 5.32:1, 圆盘 3.10:1 (两边都过)
44
+ fill 40% -> 图标 4.38:1, 圆盘 3.77:1 (图标掉到 4.5 以下)
45
+ ```
46
+
47
+ 边界本来也由 55% 的描边扛着(5.87:1),填充只需自己过 3:1 那条线。
48
+
49
+ ## 无限画布:深色卡片同色修好了,浅色回到原样
50
+
51
+ **浅色模式原本没有问题,v1.22.0 把它改坏了。**
52
+
53
+ 上一版用 `label-primary` 混 12% 去「一次性修好两套主题」。这个 token 在浅色下近黑,
54
+ 于是把一个本来没毛病的浅色画布调灰了。
55
+
56
+ 事实是:DSH 的 `--dsw-alias-bg-layer-1/2/3` 在浅色下**全是 `#ffffff`**——白卡片配白背景
57
+ 就是用户原本要的样子;缺陷只在深色,那里三层是 `#232324 / #2c2c2e / #353638`,相邻只差
58
+ 大约 1.3:1。
59
+
60
+ 所以现在:
61
+
62
+ - `.root` 的默认值**退回** `bg-layer-1` / `border-l1`,浅色逐字节不变;
63
+ - 深色由 `body[data-ds-dark-theme] .root` 单独覆盖:填充 12% 混色(对画布 **1.44:1**)、
64
+ 描边 36% 混色(**3.19:1**);
65
+ - 悬停也拆成变量,浅色仍用原来的 `border-l2`,深色用 46%。
66
+
67
+ ## 测试:两处假绿
68
+
69
+ 两个 bug 原来的检查都是绿的,原因不同:
70
+
71
+ 1. **预览 fixture 把这个 token 硬写成 `#ffffff`,而且只渲染浅色。** 于是「深色主题」这个
72
+ 唯一出问题的场景从来没有被画出来过。
73
+ 2. **画布 fixture 把 `.module.css` 原样塞进 `<style>`。** `:global(...)` 是 CSS Modules
74
+ 语法,浏览器见到会**丢弃整条规则**、且不报错——深色覆盖根本没生效,测出来是浅色值。
75
+
76
+ 现在两处都按 DSH 真实的两套调色板各渲染一遍,并在浅色分支上断言「必须仍是 1.00:1」——
77
+ 只测深色的守卫抓不到「把浅色调暗」这类回归。
78
+
79
+ 新增三条反向用例,把缺陷植回仓库副本后确认检查变红:
80
+
81
+ | 反向用例 | 期望变红的原因 |
82
+ | --- | --- |
83
+ | 预览墨色退回跟随主题的 token | `unreadable in a dark theme` |
84
+ | 浅色画布被调暗 | `the LIGHT theme's canvas was changed` |
85
+ | 圆形按钮丢掉边界 | `not findable in a` |