@q253595422/dsh-imagegen-video 1.22.0 → 1.22.2
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 +61 -0
- package/docs/releases/v1.22.1.md +85 -0
- package/docs/releases/v1.22.2.md +99 -0
- package/lib/client.js +95 -17
- package/lib/client.js.map +1 -1
- package/lib/index.js +1 -1
- package/package.json +1 -1
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.22.2 — 侧栏:生图态也有收起和展开键,标签栏对齐宿主
|
|
9
|
+
|
|
10
|
+
- **生图态「收起侧边栏」消失,根因是那条 chrome 条没有 slot 锚点。** macOS 宿主把折叠
|
|
11
|
+
控件放在 logoRow 之上的 `topStrip` 里(为了避开红绿灯),而插件「隐藏外来条目」的
|
|
12
|
+
`display: none !important` 把整条吞掉——连带 logoRow 上移、品牌 logo 被压进红绿灯底下,
|
|
13
|
+
用户只剩 ⌘B。改为按**可访问名**(中英文四个词)认出宿主自己的折叠控件,把它所在的
|
|
14
|
+
root 直接子块并入 chrome 白名单。按名字不按类名,是因为宿主类名是构建哈希
|
|
15
|
+
(`kB3qhq_`,上一版还是 `_3WPZCG_`),升级就变。
|
|
16
|
+
- **可见性只用来择优、不做过滤。** 被自己规则隐藏的块必须还能被再次认出来,否则标记
|
|
17
|
+
一次失败就把按钮永久弄丢——这种自锁比原来的 bug 更难查。
|
|
18
|
+
- **生图态「打开侧边栏」也能用了,但原因完全不同:不是没渲染,是被盖住。** 收起后宿主在
|
|
19
|
+
左上角挂 `[data-shell-leading]` 座位(`z-index: 15`),里面是「打开侧边栏」和「新建会话」;
|
|
20
|
+
插件接管中心列是 `--z-takeover: 60`,于是生图态把它压在下层。会话态之所以正常,纯粹因为
|
|
21
|
+
它的插件视图是 `display: none`。实测按钮位置一直正确(`88,11`,28×28),只是中心点命中的
|
|
22
|
+
是插件自己的标题行。
|
|
23
|
+
- **抬座位,不降接管层。** 60 是钉死的:任务板、SSH 等兄弟面板都照着这个数写过,挪它会
|
|
24
|
+
连锁影响插件之外的代码。新增 `--z-shell-seat`(63,层级表独占一个号),只抬这个只在
|
|
25
|
+
收起态存在的宿主座位;同时用宿主发布的 `--dsh-frame-top-clearance` 给面板加顶部内边距,
|
|
26
|
+
免得生图第一行贴在座位底下。
|
|
27
|
+
- **标签栏不再和「新建会话」差 2px,而上一版的几何检查是假绿的。** 真机量出来标签栏
|
|
28
|
+
`16..264`、按钮 `14..266`;检查没发现,是因为 fixture 自己声明了
|
|
29
|
+
`--dsh-sidebar-paint-inset: 3px`,和 CSS 的 fallback 正好一致——检查在和自己的假设对答案。
|
|
30
|
+
真宿主整条祖先链上都没有这个变量,按钮用的是写死的 `margin: 2px`。现在 CSS 不再假装
|
|
31
|
+
知道内缩是多少,`alignToSeat` 直接读兄弟按钮的**已用 margin**——样式表看不见兄弟的
|
|
32
|
+
used value,这是唯一诚实的来源。真机复测两侧 0 漂移、间距 8px。
|
|
33
|
+
- **`role="tab"` 现在兑现了键盘契约。** 上个 PR 加了角色,但两个 tab 都在 Tab 序里、方向键
|
|
34
|
+
什么也不做。改为复用 `tablist.ts` 的 `tabIndexFor` / `onTablistKeyDown`,把 `tabIndex` 写进
|
|
35
|
+
同步选中态的**同一处**,让 `aria-selected` 与 Tab 序永远描述同一个状态;侧栏入口是命令式
|
|
36
|
+
构建,点击和方向键共用同一个 `activate`,避免两条路径漂移。契约扫描因此覆盖 `.ts` 的
|
|
37
|
+
tablist,并新增真浏览器几何检查。
|
|
38
|
+
- **四条修复都补了会变红的反向用例**:删掉 chrome 白名单、删掉抬座位的规则、
|
|
39
|
+
`alignToSeat` 退回读不存在的变量、去掉 roving tabIndex。
|
|
40
|
+
|
|
41
|
+
### 1.22.1 — 深色模式:预览按键恢复可见,浅色画布恢复原样
|
|
42
|
+
|
|
43
|
+
- **深色模式下全屏预览的按键「都看不到」,根因不是填充不够,而是基色跟着主题翻转了。**
|
|
44
|
+
v1.22.0 把 lightbox 的墨色与所有 `color-mix` 基色都取自 `--dsw-alias-label-primary-foreground`。
|
|
45
|
+
这个 token 名字像「白色」,实际是**「站在哪种表面上的反色」**:DSH 主题包里它在 `body` 上是
|
|
46
|
+
`#fff`,在 `body[data-ds-dark-theme]` 上是 `#0f1115`。深色主题下它把每个控件的底色与文字
|
|
47
|
+
一起压成近黑,叠在本来就有 88% 黑的照片遮罩上,实测填充 1.03:1、描边 1.08:1、提示文字 1.11:1、
|
|
48
|
+
说明文字 1.15:1——不是「太暗」,是和底色同色。改用静态色阶 `--dsw-static-neutral-00`(两套主题
|
|
49
|
+
下都是白)后,两套主题实测都是**文字 5.34:1、控件边界 5.41:1**。浅色主题的取值一个字节都没变,
|
|
50
|
+
因为它原本解析出来就已经是 `#fff`。
|
|
51
|
+
- **圆形按钮的填充从 40% 降到 34%,因为 40% 会吃掉图标。** 上一轮为了把圆盘抬到 3:1 用了 40% 填充,
|
|
52
|
+
而白图标在 40% 填充上只有 4.38:1,低于文字要求的 4.5:1——等于用丢图标换来边框可见。34% 是唯一同时
|
|
53
|
+
满足两边的取值:图标 5.32:1、圆盘对遮罩 3.10:1。边界本来也由 55% 的描边扛着(5.87:1),
|
|
54
|
+
填充只需要自己过 3:1 那条线。
|
|
55
|
+
- **无限画布:深色卡片与背景同色的问题修好了,但浅色模式回到了原样。** v1.22.0 用
|
|
56
|
+
`label-primary` 混 12% 去「一次性修好两套主题」,可是这个 token 在浅色下近黑,于是把一个
|
|
57
|
+
本来没问题的浅色画布也调灰了。事实是:DSH 的 `layer-1/2/3` 在浅色下**全是 `#ffffff`**,
|
|
58
|
+
白卡片配白背景就是用户原本要的样子;缺陷只在深色。现在 `.root` 的默认值退回
|
|
59
|
+
`bg-layer-1` / `border-l1`(浅色逐字节不变),深色由
|
|
60
|
+
`body[data-ds-dark-theme] .root` 单独覆盖:填充 12% 混色(对画布 1.44:1)、描边 36% 混色
|
|
61
|
+
(3.19:1)。悬停也拆成变量,浅色仍是原来的 `border-l2`。
|
|
62
|
+
- **两处契约都改成同时测两套主题,并修掉两个假绿来源。** 预览的 fixture 原先把
|
|
63
|
+
`label-primary-foreground` 硬写成 `#ffffff`、且只渲染浅色,深色永远没被画出来;现在按
|
|
64
|
+
DSH 真实取值各渲染一遍。画布的 fixture 把 `.module.css` 原样塞进 `<style>`,而
|
|
65
|
+
`:global(...)` 是 CSS Modules 语法、浏览器会丢弃整条规则,所以深色覆盖根本没生效——现在按
|
|
66
|
+
构建后的样子归一化。新增三条反向用例:深色墨色回退、浅色画布被调暗、圆形按钮丢边界,
|
|
67
|
+
都确认把缺陷植回后检查变红。
|
|
68
|
+
|
|
8
69
|
### 1.22.0 — 大图预览可关闭、深色画布节点可辨认,接入 Agnes 图像/视频
|
|
9
70
|
|
|
10
71
|
- **大图预览的关闭按钮原来是「看不见」,不是「没有」。** 按钮一直渲染着,但白色图标画在 16% 白的圆盘上、
|
|
@@ -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` |
|
|
@@ -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`)。
|