dsh-islands-ui 1.0.4 → 1.1.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
@@ -1,5 +1,36 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.1.1 — 2026-11-14
4
+
5
+ ### 界面
6
+
7
+ - Windows 端不再使用自绘顶栏:工作区折叠沿用标题栏左上角的原生侧栏开关,右侧栏开关、底部面板入口等工具留在 DSH 原生的会话头位置,岛屿直接接在原生标题栏下方;macOS / Linux 保持 40px 顶栏和顶栏内的右侧工具。
8
+
9
+ ### 兼容性
10
+
11
+ - 样式与 DOM 查询不再依赖 DSH 构建的哈希类名。新增 `src/host/runtime.js`:宿主契约、本地名提取、区域/部件表和遍历器;样式统一读 `data-islands-part` 与 `data-slot`、`data-phase` 等公开契约。宿主重新构建改变哈希时无需更新;宿主改本地名时对应规则安静失效,改部件表一行即可恢复。
12
+ - 删除按 DSH 版本选择的 `src/variants/scroll.css` 与版本方言表;rc.1/rc.2 的侧栏结构差异由同一张样式表按部件是否存在处理。
13
+ - 兼容门禁改为校验核心契约与核心部件;单个装饰部件缺失不再关闭整个皮肤。设置页导航改用部件查询,设置入口优先点击原生 settings 触发器。
14
+ - 新增 `npm run check:css`、`check:parts` 与 `node --test`;构建会拒绝哈希类名、`[class*=...]`、未定义部件和作用域外的宿主选择器。
15
+ - 第三方 dsh-better-sidebar 的底部工作台规则移到 `src/60-peers.css`;dsh-sidenote 的内部类名规则移除。
16
+
17
+ ### 修复
18
+
19
+ - 适配 DSH 0.2.2-rc.3 新增的 `newSessionRow` 包装:新建会话行重新作为侧栏网格的第二行项,修复新建会话按钮消失、图标与左侧栏 home 图标重叠的问题。
20
+ - 注册 `islands.model.open` 时补上 `aliases: []`,修复 rc.2 Web 端快捷键参考组件读取 `row.aliases` 时的 `TypeError`。
21
+
22
+ ## 1.1.0 — 2026-11-13
23
+
24
+ ### 界面
25
+
26
+ - 左侧栏不再把其他插件收进「…」弹层:所有 `sidebar.panellist` 面板图标直接排列在工作区按钮下方,点击即按面板默认行为切换(`layoutService.selectPanel`)。
27
+ - 图标支持按住拖动排序,顺序写入 `localStorage`;拖动超过 4px 才进入排序,普通点击仍只切换面板。图标较多时栏内可滚动,并在拖动到上下边缘时自动滚动。进入排序后源图标变淡,同时出现一个 36px、90% 不透明度、保持抓取偏移并跟随鼠标的浮层,松手即移除。
28
+ - 右键左侧栏或任一图标打开「左侧栏图标」菜单,勾选 / 取消勾选即可增删入口;隐藏的图标仍保留在菜单中,可随时恢复。旧版 `dsh-islands-ui:rail-pins` 的固定顺序会自动迁移到新的 `dsh-islands-ui:rail` 配置。
29
+ - 菜单副标题不再把 DSH 官方客户端 bundle 的内部 fiber 名 `WC` 直接显示出来,内置项改标为「DSH 内置」;匹配时忽略大小写,第三方插件仍显示其包名。
30
+ - 左侧栏首页(工作区)图标改为纯导航触发器:不再进入 `is-active`、不再设置 `aria-pressed`、不参与拖动样式;hover 使用标准浅色反馈,点击在按钮内绘制半透明的圆形涟漪(键盘触发时从中心扩散);全局面板图标仍按 `activePanelId` 高亮。
31
+ - 修复首页按钮在空闲状态被误标为拖动中:`dragId` 初始为 `null`,而房子的 id 也是 `null`,`dragId === id` 让房子从首帧起一直带 `is-dragging`(选中底色 + 45% 透明度)。拖动判断改为 `id !== null && dragId === id`,房子在空闲和拖动其他图标时都不再进入拖动样式。
32
+ - 移除左侧栏底部原有的「…」按钮与插件固定弹层。
33
+
3
34
  ## 1.0.4 — 2026-11-12
4
35
 
5
36
  ### 兼容性
package/README.en.md CHANGED
@@ -47,7 +47,7 @@ dsh plugin --profile desktop remove dsh-islands-ui
47
47
  | | Feature | Details |
48
48
  | :---: | --- | --- |
49
49
  | 🏝 | **Floating islands** | Canvas, conversation, workspace, right sidebar and bottom panel become separate rounded surfaces; flat, no drop shadows, separated by color and a 1px hairline |
50
- | 🧭 | **Persistent rail** | Workspace / automation / plugins / pinned plugins / more; right-click or “…” opens the plugin pin menu |
50
+ | 🧭 | **Persistent rail** | Workspace plus every plugin launcher, shown inline; the home button is a pure conversation / workspace-drawer trigger with no selected state (subtle hover and a translucent click ripple); click a panel to open it, drag to reorder with a floating preview, right-click to show or hide |
51
51
  | ⚙️ | **Settings page** | Settings → Islands UI: on/off, accent presets, custom color and follow-theme |
52
52
  | 📌 | **Pinned shelf** | Pinned sessions stay in their workspace and are also aggregated between “New session” and “Workspace”; the group collapses |
53
53
  | 🌙 | **Dark mode** | Full dark token set: near-black canvas, dark islands, translucent interaction layers |
@@ -65,7 +65,7 @@ The skin is a client-only style layer. Pinning helpers, the pinned shelf and the
65
65
  | Canvas | Solid `#f7f7f7` (dark `#0f1012`), opaque, no blur |
66
66
  | Islands | White / dark-gray surfaces, 16–20px radius, 1px hairline, no shadows |
67
67
  | Spacing | 5px between every island, including the bottom panel |
68
- | Top bar | 40px window strip; macOS clears the traffic lights, Windows/Linux starts at 8px below the native title bar |
68
+ | Top bar | 40px window strip hosting the conversation tools and the right-panel toggle; macOS clears the traffic lights, Linux starts at 8px below the native title bar. Windows renders no island top bar: the caption row keeps the native sidebar toggle and the right-hand tools stay in the conversation header |
69
69
  | Accent | Brand blue by default; purple / green / orange / pink / red presets or any custom color |
70
70
 
71
71
  ---
@@ -75,10 +75,10 @@ The skin is a client-only style layer. Pinning helpers, the pinned shelf and the
75
75
  | Platform | Status |
76
76
  | --- | --- |
77
77
  | macOS | ✅ Tested |
78
- | Windows | 🟡 Custom top bar, rail, settings gear, right-sidebar toggle and model picker adapted; **not tested on a physical Windows machine** |
78
+ | Windows | 🟡 Native title-bar layout (no island top bar), rail, right-hand native header tools, settings gear and model picker adapted; **not tested on a physical Windows machine** |
79
79
  | Linux | 🟡 Uses the same top bar and rail; **not tested** |
80
80
 
81
- On Windows the native title bar stays in place and the custom strip sits below it; `--dsh-windows-titlebar-height` is respected. Linux follows native window decorations, which vary by desktop environment.
81
+ On Windows the island top bar is not rendered and the islands sit directly below the native title bar. The workspace collapse uses DSH's own sidebar button in the caption row's top-left corner, while the right-panel toggle, bottom-panel entry and session tools stay in DSH's native conversation header — position, look and hover are the host's. The rail, settings gear and shortcuts stay enabled. Linux follows native window decorations, which vary by desktop environment.
82
82
 
83
83
  If you hit a title-bar, drag-region, window-button or layout issue, please open an [issue](https://github.com/DawnCHL/dsh-islands-ui/issues) with your OS version, window size and a screenshot.
84
84
 
@@ -113,7 +113,7 @@ Stored in `localStorage`; clear these keys to reset:
113
113
  | `dsh-islands-ui:enabled` | `1` / `0`, master switch |
114
114
  | `dsh-islands-ui:accent` | Custom accent color; absent means follow theme |
115
115
  | `dsh-islands-ui:pinned-collapsed` | Whether the pinned group is collapsed |
116
- | `dsh-islands-ui:rail-pins` | Extra plugin ids pinned to the left rail |
116
+ | `dsh-islands-ui:rail` | Left-rail icon order and hidden entries |
117
117
 
118
118
  ---
119
119
 
@@ -124,17 +124,22 @@ src/
124
124
  00-tokens.css design tokens + --dsw-* aliases (single source of truth)
125
125
  10-shell.css three-column shell → canvas + islands
126
126
  15-topbar.css window top bar
127
- 16-rail.css left icon rail, plugin pin menu, settings gear
127
+ 16-rail.css left icon rail, drag reorder, show/hide menu, settings gear
128
128
  17-update.css desktop update entry, state styles, 3×3 dot-matrix loaders
129
129
  20-sidebar.css workspace island, pinned shelf, session row states
130
130
  30-conversation.css conversation page, composer, top tool group
131
131
  40-settings.css settings dialog and section shell
132
132
  45-model-picker.css model / reasoning popover
133
133
  50-components.css preference rows, switches, accent picker
134
+ 60-peers.css third-party plugin adapters ([class*=...] is allowed only here)
135
+ host/runtime.js host contracts, local-name extraction, part table, walker
134
136
  client.template.js browser entry (React components + slot registrations)
135
- build.mjs inline src/*.css into client.js
137
+ build.mjs inline src/*.css and host/runtime.js into client.js
136
138
  client.js built, self-contained artifact
139
+ scripts/check-css.mjs selector gate
140
+ scripts/check-parts.mjs part-table gate
137
141
  scripts/check-package.mjs pre-publish packaging checks
142
+ test/ local-name and table-integrity tests
138
143
  skin.json theme-manager manifest
139
144
  ```
140
145
 
@@ -180,12 +185,12 @@ Repository settings: `main` requires a PR, the `check (Node 20/22/24)` CI jobs a
180
185
  ## Compatibility
181
186
 
182
187
  - The skin is a pure client style layer and does not replace session, settings or plugin data or behavior.
183
- - Selectors depend on the current Harness build's CSS Module hashes (e.g. `PIRFFq_*`, `kB3qhq_*`, `JoiKIa_*`, `_77Pn0W_*`) and a few `data-*` hooks. A Harness upgrade or rebuild can change those class names and require a matching CSS update.
184
- - On startup the plugin verifies the layout anchors (`.PIRFFq_frame`, `.PIRFFq_centerCol`, `.kB3qhq_root`) and the sidebar structure dialect: it injects the stylesheet for the reported DSH release, then cross-checks it against the mounted DOM (`flat` / `scroll`) and switches the variant when the two disagree. Only a structure it cannot recognize leaves the skin **off**; DSH keeps its default look, a toast explains why (5s auto-dismiss, manual close, click to open the plugin settings) and Settings → Islands UI carries a persistent amber notice plus a session-scoped "Enable anyway".
185
- - Settings → Islands UI shows the detected DSH release and sidebar structure for support triage.
188
+ - Styles depend on two stable layers only: host contracts (`data-slot`, `data-phase`, `data-conversation-scroll`, `data-composer-card`, `data-row-key`, `role` / `aria-*`) and the skin's own part marks in `data-islands-part`. Host class names appear only as local names in the tables in `src/host/runtime.js`; a hash segment never enters a selector. A Harness rebuild that changes hashes needs no update, and a host rename makes the affected rule go quiet until one table line changes.
189
+ - On startup the plugin verifies the core contracts (`[data-slot="root"]`, `[data-slot="sidebar"]`) and the core parts (frame, center column, sidebar root). Only a missing core contract leaves the skin **off**; DSH keeps its default look, a toast explains why (5s auto-dismiss, manual close, click to open the plugin settings) and Settings → Islands UI carries a persistent amber notice plus a session-scoped "Enable anyway". A missing decorative part only silences its own rules.
190
+ - Settings → Islands UI shows the detected DSH release and sidebar structure (`flat` / `scroll`, inferred from the parts present) for support triage.
186
191
  - Dark mode follows `data-ds-dark-theme`; the accent remaps `--dsw-alias-state-business-primary`, so it affects both the skin and native buttons.
187
- - Windows uses `data-windows-titlebar` and `--dsh-windows-titlebar-height`; Linux currently follows native window decorations.
188
- - `dsh.engines.dsh` / `engines.dsh` pin the tested line to `>=0.2.2-rc.1 <0.3.0-0`; outside that range the plugin manager refuses to install or upgrade, while structure drift inside the line is handled by the version-selected style variants and, for an unrecognized structure, by the startup gate above. `skin.json` gives theme managers the id, accent and mount row.
192
+ - Windows uses `data-windows-titlebar` and `--dsh-windows-titlebar-height` and renders no island top bar; Linux currently follows native window decorations.
193
+ - `dsh.engines.dsh` / `engines.dsh` pin the tested line to `>=0.2.2-rc.1 <0.3.0-0`; outside that range the plugin manager refuses to install or upgrade. Structure drift inside the line is handled by one stylesheet keyed on the parts present, no longer by a version-selected variant. `skin.json` gives theme managers the id, accent and mount row.
189
194
 
190
195
  ---
191
196
 
@@ -209,11 +214,11 @@ Not recommended. Two skins write the same `--dsw-*` tokens and layout rules, so
209
214
 
210
215
  **Why do some surfaces keep the old look?**
211
216
 
212
- Selectors depend on Harness CSS Module hashes. A DSH upgrade can rename them and disable individual rules. Update Islands UI, or open an issue with a screenshot and DSH version.
217
+ A DSH upgrade can change a host local name or a contract. The affected rule goes quiet instead of matching a neighbour; update Islands UI, or open an issue with a screenshot and DSH version.
213
218
 
214
219
  **Windows / Linux?**
215
220
 
216
- The top bar, rail, right-panel toggle and title-bar height are adapted, but neither has been tested on a physical machine. Please report title-bar, drag-region or window-button issues using the issue template.
221
+ The native title bar (no island top bar on Windows), rail, right-hand native header tools, right-panel toggle and title-bar height are adapted, but neither platform has been tested on a physical machine. Please report title-bar, drag-region or window-button issues using the issue template.
217
222
 
218
223
  **Will it be in plugin stores?**
219
224
 
package/README.md CHANGED
@@ -70,14 +70,14 @@ dsh plugin --profile desktop remove dsh-islands-ui
70
70
  | | 功能 | 说明 |
71
71
  | :---: | --- | --- |
72
72
  | 🏝 | **浮岛布局** | 画布、主会话、工作区、右侧栏、底部面板各自独立;扁平无投影,以色块 + 1px 发丝线分隔 |
73
- | 🧭 | **常驻左侧栏** | 工作区 / 自动化任务 / 插件 / 已固定插件 / 更多;右键或「…」打开插件固定菜单 |
73
+ | 🧭 | **常驻左侧栏** | 工作区与全部插件图标直接排列;首页按钮只作会话 / 工作区抽屉触发器、不占选中态(hover 浅色反馈、点击半透明涟漪);面板图标点击切换,按住拖动排序(浮动预览跟随鼠标),右键显示 / 隐藏图标 |
74
74
  | ⚙️ | **独立设置页** | 设置 → Islands UI:一键开关皮肤、强调色(预设 + 自定义 + 跟随主题) |
75
75
  | 📌 | **置顶聚合** | 置顶会话同时保留在原工作区,并聚合到「新会话」与「工作区」标题之间;分类可折叠 |
76
76
  | 🌙 | **深色模式** | 完整深色 token:近黑画布、深灰岛屿、白色透明交互层与深色阴影 |
77
77
  | 🔄 | **桌面更新入口** | 设置齿轮上方常驻;发现新版本、下载、校验、安装与失败各有独立状态,加载态使用强调色 3×3 点阵动效 |
78
78
  | ⌨️ | **快捷键** | `⌘B` 折叠工作区、`⌥⌘B` 右侧栏、`⌘,` 设置、`⌘⇧M` 模型弹层;按钮悬停显示当前键位 |
79
79
 
80
- 皮肤是纯客户端样式层;左侧栏插件固定、置顶聚合、定位与设置页也都在浏览器端完成,不新增 host 工具、服务或会话数据。
80
+ 皮肤是纯客户端样式层;左侧栏图标排序与显隐、置顶聚合、定位与设置页也都在浏览器端完成,不新增 host 工具、服务或会话数据。
81
81
 
82
82
  ### 设计语言
83
83
 
@@ -86,7 +86,7 @@ dsh plugin --profile desktop remove dsh-islands-ui
86
86
  | 画布 | 纯色 `#f7f7f7`(深色 `#0f1012`),不透明、无毛玻璃 |
87
87
  | 岛屿 | 白色 / 深灰表面,16–20px 圆角,1px 发丝描边,无投影 |
88
88
  | 间距 | 所有岛屿统一 5px 间隙,左右、顶部、底部、底部面板四周一致 |
89
- | 顶部栏 | 40px 窗口栏,承载工作区折叠、对话工具组和右侧栏开关;macOS 避开红绿灯,Windows/Linux 从 8px 开始 |
89
+ | 顶部栏 | 40px 窗口栏,承载对话工具组和右侧栏开关;macOS 避开红绿灯,Linux 从 8px 开始。Windows 不渲染该顶栏:标题栏保留原生侧栏开关,右侧工具回到会话头原生位置 |
90
90
  | 强调色 | 默认品牌蓝,可改为紫 / 绿 / 橙 / 粉 / 红或任意取色 |
91
91
 
92
92
  ### 常用快捷键
@@ -110,10 +110,10 @@ dsh plugin --profile desktop remove dsh-islands-ui
110
110
  | 平台 | 状态 |
111
111
  | --- | --- |
112
112
  | macOS | ✅ 已实测(开发与日常使用环境) |
113
- | Windows | 🟡 已适配自定义顶栏、左侧栏、设置齿轮、右侧开关、置顶聚合与模型弹层,并在原生标题栏下方预留高度;**尚未在真实 Windows 电脑上实测** |
113
+ | Windows | 🟡 已适配原生标题栏布局(不渲染插件顶栏)、左侧栏、设置齿轮、右侧工具原生位置、置顶聚合与模型弹层;**尚未在真实 Windows 电脑上实测** |
114
114
  | Linux | 🟡 使用同一套顶栏与左侧栏;**尚未实测** |
115
115
 
116
- Windows 下保留 Harness 原生标题栏,自定义顶栏显示在它下方;左侧栏、设置齿轮、右侧栏开关和快捷键均已启用。Linux 按原生窗口装饰处理,不同桌面环境可能有差异。
116
+ Windows 下不渲染插件顶栏,岛屿直接接在原生标题栏下方;工作区折叠使用标题栏左上角的 DSH 原生侧栏按钮,右侧栏开关、底部面板入口与会话工具留在 DSH 原生的会话头位置(位置、外观与悬停都交给宿主)。左侧栏、设置齿轮和快捷键均已启用。Linux 按原生窗口装饰处理,不同桌面环境可能有差异。
117
117
 
118
118
  > **反馈**:如果你在 Windows 或 Linux 上遇到标题栏高度、拖拽区域、窗口按钮重叠、布局错位或快捷键问题,欢迎提交 [Issue](https://github.com/DawnCHL/dsh-islands-ui/issues) 或 PR,附系统版本、窗口尺寸和截图即可。
119
119
 
@@ -126,7 +126,7 @@ Windows 下保留 Harness 原生标题栏,自定义顶栏显示在它下方;
126
126
  | `dsh-islands-ui:enabled` | `1` / `0`,总开关 |
127
127
  | `dsh-islands-ui:accent` | 自定义强调色(不存在表示跟随主题) |
128
128
  | `dsh-islands-ui:pinned-collapsed` | 置顶分类是否折叠 |
129
- | `dsh-islands-ui:rail-pins` | 左侧栏额外固定的插件 id 列表 |
129
+ | `dsh-islands-ui:rail` | 左侧栏图标的顺序与隐藏列表 |
130
130
 
131
131
  清除这些 key 即可恢复默认。
132
132
 
@@ -139,23 +139,28 @@ src/
139
139
  00-tokens.css 设计变量 + 重定向 Harness 的 --dsw-* 别名(唯一真源)
140
140
  10-shell.css 三栏框架 → 画布 + 岛屿
141
141
  15-topbar.css 窗口顶部栏
142
- 16-rail.css 左侧图标栏、插件固定菜单、设置齿轮
142
+ 16-rail.css 左侧图标栏、拖动排序、显隐菜单、设置齿轮
143
143
  20-sidebar.css 工作区岛屿、置顶聚合、会话行状态
144
144
  30-conversation.css 会话页、输入框、顶部工具组
145
145
  40-settings.css 设置弹窗、设置页外壳
146
146
  45-model-picker.css 模型/推理两级弹层
147
147
  50-components.css 偏好行、开关、强调色选择器等共享组件
148
+ 60-peers.css 第三方插件适配(仅此文件允许 [class*=...])
149
+ host/runtime.js 宿主契约、本地名提取、区域/部件表、遍历器
148
150
  client.template.js 浏览器端入口模板(React 组件 + 插槽注册)
149
- build.mjs 把 src/*.css 内联进 client.js
151
+ build.mjs 把 src/*.css 与 host/runtime.js 内联进 client.js
150
152
  client.js 构建产物(自包含,运行时无法读文件)
153
+ scripts/check-css.mjs 选择器门禁
154
+ scripts/check-parts.mjs 部件表门禁
151
155
  scripts/check-package.mjs 发布前包内容校验
156
+ test/ 本地名与表完整性测试
152
157
  skin.json 主题管理器清单
153
- docs/ 发布与商店收录说明
158
+ docs/ 发布、商店收录与宿主契约说明
154
159
  ```
155
160
 
156
161
  ```bash
157
162
  npm run build # 修改 src/*.css 或模板后重新生成 client.js
158
- npm run check # 校验 client.js 是否为最新,并检查 npm 包是否可发布
163
+ npm run check # 校验 client.js、CSS/部件门禁、单元测试和 npm 包
159
164
  npm run pack:check # npm pack --dry-run
160
165
  npm pack # 生成 dsh-islands-ui-<version>.tgz
161
166
  ```
@@ -194,13 +199,13 @@ npm pack # 生成 dsh-islands-ui-<version>.tgz
194
199
 
195
200
  ## 兼容性与边界
196
201
 
197
- - 皮肤是**纯客户端样式层**,不替换会话、设置或插件的数据与交互;左侧栏插件固定、置顶聚合、定位等额外能力也只在客户端完成。
198
- - 选择器依赖 Harness 当前构建的 CSS Module 哈希类名(如 `PIRFFq_*`、`kB3qhq_*`、`JoiKIa_*`、`_77Pn0W_*`)与少量 `data-*` 挂点;**Harness 升级或重新构建后类名可能变化,需要同步更新对应 CSS**。
199
- - 启动时检测界面骨架锚点(`.PIRFFq_frame`、`.PIRFFq_centerCol`、`.kB3qhq_root`)并校验侧栏结构方言:先按 DSH 版本注入对应样式,再用挂载后的 DOM 交叉验证(`flat` / `scroll`),两者不一致时以 DOM 为准切换样式;结构无法识别时才**不启用皮肤**,DSH 保持默认外观,右下角弹出说明(5 秒自动关闭、可手动关闭、点击进入插件设置),设置 → Islands UI 里也常驻一条黄色说明,并提供会话级的「仍然启用」。
200
- - 设置 → Islands UI 显示检测到的 DSH 版本与侧栏结构,便于排查升级后的样式问题。
202
+ - 皮肤是**纯客户端样式层**,不替换会话、设置或插件的数据与交互;左侧栏图标排序与显隐、置顶聚合、定位等额外能力也只在客户端完成。
203
+ - 样式只依赖两层稳定信息:Harness 公开的契约(`data-slot`、`data-phase`、`data-conversation-scroll`、`data-composer-card`、`data-row-key`、`role` / `aria-*`),以及皮肤写回的部件标记 `data-islands-part`。宿主类名只在 `src/host/runtime.js` 的部件表里以本地名出现,哈希段不进入任何选择器;Harness 重新构建改变哈希时无需更新,宿主改本地名时对应规则安静失效,改表一行即可恢复。
204
+ - 启动时只校验核心契约(`[data-slot="root"]`、`[data-slot="sidebar"]`)和核心部件(frame、center column、sidebar root);核心契约缺失时才**不启用皮肤**,DSH 保持默认外观,右下角弹出说明(5 秒自动关闭、可手动关闭、点击进入插件设置),设置 → Islands UI 里也常驻一条黄色说明,并提供会话级的「仍然启用」。单个装饰部件缺失只让对应规则失效,不会关掉整个皮肤。
205
+ - 设置 → Islands UI 显示检测到的 DSH 版本与侧栏结构(`flat` / `scroll`,由部件是否存在推断),便于排查升级后的样式问题。
201
206
  - 深色模式跟随 Harness 的 `data-ds-dark-theme`;强调色通过重映射 `--dsw-alias-state-business-primary` 生效,会同时影响皮肤和原生按钮。
202
- - Windows 使用 `data-windows-titlebar` 与 `--dsh-windows-titlebar-height` 适配原生标题栏;Linux 暂无专用标题栏变量,按原生窗口装饰处理。
203
- - `dsh.engines.dsh` / `engines.dsh` 把兼容线钉在 `>=0.2.2-rc.1 <0.3.0-0`,越界时插件管理器会拒绝安装或升级;同一兼容线内部的结构差异由客户端按版本选择的样式变体处理,变体未覆盖的新结构会触发上述自检降级。`skin.json` 为主题管理器提供 id、强调色和挂载行。
207
+ - Windows 使用 `data-windows-titlebar` 与 `--dsh-windows-titlebar-height` 适配原生标题栏,并且不渲染插件顶栏;Linux 暂无专用标题栏变量,按原生窗口装饰处理。
208
+ - `dsh.engines.dsh` / `engines.dsh` 把兼容线钉在 `>=0.2.2-rc.1 <0.3.0-0`,越界时插件管理器会拒绝安装或升级;同一兼容线内部的结构差异由同一张样式表按部件是否存在处理,不再按版本注入方言。`skin.json` 为主题管理器提供 id、强调色和挂载行。
204
209
 
205
210
  ---
206
211
 
@@ -224,11 +229,11 @@ npm pack # 生成 dsh-islands-ui-<version>.tgz
224
229
 
225
230
  **为什么某些界面还是旧样式?**
226
231
 
227
- 说明皮肤**检测到界面结构不匹配,已自动关闭**。DSH 升级可能改掉皮肤依赖的 CSS Module 哈希类名,半启用会变成双栏重叠,所以插件宁可保持默认外观:右下角会有提示,设置 → Islands UI 顶部有黄色说明条并列出缺失的锚点。把 Islands UI 更新到适配当前 DSH 的版本即可恢复;确认界面正常也可以点「仍然启用」临时开启(下次启动重新检测)。
232
+ 说明皮肤**检测到核心宿主契约缺失,已自动关闭**。DSH 升级可能改掉 `data-slot`、`data-phase` 等公开契约;半启用会变成双栏重叠,所以插件宁可保持默认外观:右下角会有提示,设置 → Islands UI 顶部有黄色说明条并列出缺失的契约。把 Islands UI 更新到适配当前 DSH 的版本即可恢复;确认界面正常也可以点「仍然启用」临时开启(下次启动重新检测)。
228
233
 
229
234
  **Windows / Linux 能用吗?**
230
235
 
231
- 已按自定义顶栏、左侧栏、右侧栏开关和标题栏高度适配,但还没有在真实 Windows / Linux 机器上实测。遇到标题栏、拖拽区或窗口按钮问题,欢迎按 Issue 模板反馈。
236
+ 已按原生标题栏(Windows 不渲染插件顶栏)、左侧栏、右侧工具原生位置和标题栏高度适配,但还没有在真实 Windows / Linux 机器上实测。遇到标题栏、拖拽区或窗口按钮问题,欢迎按 Issue 模板反馈。
232
237
 
233
238
  **会发到插件商店吗?**
234
239