@q253595422/dsh-imagegen-video 1.22.1 → 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 +33 -0
- package/docs/releases/v1.22.2.md +99 -0
- package/lib/client.js +94 -16
- 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,39 @@ 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
|
+
|
|
8
41
|
### 1.22.1 — 深色模式:预览按键恢复可见,浅色画布恢复原样
|
|
9
42
|
|
|
10
43
|
- **深色模式下全屏预览的按键「都看不到」,根因不是填充不够,而是基色跟着主题翻转了。**
|
|
@@ -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`)。
|