dsh-islands-ui 1.1.0 → 1.1.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 CHANGED
@@ -1,5 +1,39 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.1.2 — 2026-11-15
4
+
5
+ ### 修复
6
+
7
+ - 设置入口不再先展开账号菜单:打开菜单后在绘制前同步点击“设置”,齿轮直达设置页。设置触发器在 rc.3 的侧栏脚注中已不存在,回退路径不再依赖固定延时。
8
+ - 设置页部件改为按作用域标记:`settings-panel` 只落在设置对话框本身,`nav`/`navTitle`/`header`/`options` 只读对话框直接子级,`close` 只在 header 内标记,导航行只在导航子树内标记。修复「内置插件」页的 tab 面板被误标成设置面板、套上 860px 宽度后被内容列裁切的问题;插件页自己的 `.panel`/`.section`/`.card` 不再获得设置页部件。
9
+ - Windows 标题栏按钮区颜色跟随皮肤 token:桌面端从 `--dsw-specific-sidebar-fill` 测量 caption 颜色,但它的 observer 只监听 body 的 `style`/`data-ds-dark-theme`。皮肤启用/停用时写入一个无副作用的行内自定义属性,触发重新测量,消除三大键区域与标题栏的色差。
10
+ - Windows 左上角原生侧栏开关改为皮肤的保宽折叠:原生 `toggleSidebar` 关闭即丢弃拖拽宽度、重新打开回到默认 280px;现在截获该按钮的点击并走 `data-islands-workspace-collapsed` 路径,宽度不再丢失。macOS / Linux 的自绘顶栏开关不变。
11
+ - 模型选择器与输入区底行对齐:`.isl-model` 改为 flex 容器,消除 inline-flex 触发器在块级 wrapper 中产生的行盒/基线空隙。
12
+
13
+ ### 兼容性
14
+
15
+ - 设置页不再按通用 local class(`card`/`section`/`panel`)广播部件;这些名字在 DSH 自己的插件设置页里也会出现。第三方设置页现在保持原生几何,只继承颜色 token。
16
+ - `npm run check` 新增设置页部件作用域断言;`check:parts` 的部件表按新的对话框/导航/头部作用域标记。
17
+
18
+ ## 1.1.1 — 2026-11-14
19
+
20
+ ### 界面
21
+
22
+ - Windows 端不再使用自绘顶栏:工作区折叠沿用标题栏左上角的原生侧栏开关,右侧栏开关、底部面板入口等工具留在 DSH 原生的会话头位置,岛屿直接接在原生标题栏下方;macOS / Linux 保持 40px 顶栏和顶栏内的右侧工具。
23
+
24
+ ### 兼容性
25
+
26
+ - 样式与 DOM 查询不再依赖 DSH 构建的哈希类名。新增 `src/host/runtime.js`:宿主契约、本地名提取、区域/部件表和遍历器;样式统一读 `data-islands-part` 与 `data-slot`、`data-phase` 等公开契约。宿主重新构建改变哈希时无需更新;宿主改本地名时对应规则安静失效,改部件表一行即可恢复。
27
+ - 删除按 DSH 版本选择的 `src/variants/scroll.css` 与版本方言表;rc.1/rc.2 的侧栏结构差异由同一张样式表按部件是否存在处理。
28
+ - 兼容门禁改为校验核心契约与核心部件;单个装饰部件缺失不再关闭整个皮肤。设置页导航改用部件查询,设置入口优先点击原生 settings 触发器。
29
+ - 新增 `npm run check:css`、`check:parts` 与 `node --test`;构建会拒绝哈希类名、`[class*=...]`、未定义部件和作用域外的宿主选择器。
30
+ - 第三方 dsh-better-sidebar 的底部工作台规则移到 `src/60-peers.css`;dsh-sidenote 的内部类名规则移除。
31
+
32
+ ### 修复
33
+
34
+ - 适配 DSH 0.2.2-rc.3 新增的 `newSessionRow` 包装:新建会话行重新作为侧栏网格的第二行项,修复新建会话按钮消失、图标与左侧栏 home 图标重叠的问题。
35
+ - 注册 `islands.model.open` 时补上 `aliases: []`,修复 rc.2 Web 端快捷键参考组件读取 `row.aliases` 时的 `TypeError`。
36
+
3
37
  ## 1.1.0 — 2026-11-13
4
38
 
5
39
  ### 界面
package/README.en.md CHANGED
@@ -5,10 +5,11 @@
5
5
  <p>Rounded islands · persistent rail · pinned-session shelf · adjustable accent</p>
6
6
  <p>
7
7
  <a href="https://www.npmjs.com/package/dsh-islands-ui"><img alt="npm" src="https://img.shields.io/npm/v/dsh-islands-ui?style=flat-square" /></a>
8
+ <a href="https://www.npmjs.com/package/dsh-islands-ui"><img alt="downloads" src="https://img.shields.io/npm/dm/dsh-islands-ui?style=flat-square" /></a>
8
9
  <a href="https://github.com/DawnCHL/dsh-islands-ui"><img alt="GitHub" src="https://img.shields.io/badge/GitHub-DawnCHL%2Fdsh--islands--ui-3b3b3b?style=flat-square" /></a>
9
- <a href="https://github.com/DawnCHL/dsh-islands-ui/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/DawnCHL/dsh-islands-ui/actions/workflows/ci.yml/badge.svg" /></a>
10
10
  <a href="LICENSE"><img alt="License" src="https://img.shields.io/npm/l/dsh-islands-ui?style=flat-square" /></a>
11
- <img alt="platform" src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-4f7cff?style=flat-square" />
11
+ <img alt="DSH 0.2.2-rc.1–rc.3" src="https://img.shields.io/badge/DeepSeek%20Harness-0.2.2--rc.1%E2%80%93rc.3-4f7cff?style=flat-square" />
12
+ <img alt="Platform: macOS, Windows, Linux" src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-4f7cff?style=flat-square" />
12
13
  </p>
13
14
  </div>
14
15
 
@@ -32,7 +33,17 @@ dsh plugin --profile web add dsh-islands-ui
32
33
 
33
34
  Then refresh (`⌘R` / `Ctrl+R`). The skin is enabled by default. Turn it off at **Settings → Islands UI** to restore the stock appearance immediately; your preference and accent are kept.
34
35
 
35
- > Requires DeepSeek Harness `0.2.2-rc.1` or `0.2.2-rc.2`. The client reads the running release (`window.__DSH_BOOT__.release.version`) and injects the sidebar structure stylesheet for that build; older `0.2.x` builds fall back to the base stylesheet. The package declares `dsh.bundle` + `dsh.client`, so `dsh plugin add` installs and mounts it without editing the profile by hand.
36
+ > Supports DeepSeek Harness `0.2.2-rc.1`, `0.2.2-rc.2` and `0.2.2-rc.3`; older versions do not load. If a DSH upgrade changes the interface structure, the skin may disable itself with a notice — update the plugin and refresh.
37
+
38
+ Offline or manual install from a local package:
39
+
40
+ ```bash
41
+ dsh plugin --profile desktop add ./dsh-islands-ui-<version>.tgz
42
+ ```
43
+
44
+ ### Update
45
+
46
+ Run the install command again, or update from the plugin store, then refresh. If the CLI reports that the plugin is already installed, remove it first and add it again.
36
47
 
37
48
  ### Uninstall
38
49
 
@@ -40,6 +51,8 @@ Then refresh (`⌘R` / `Ctrl+R`). The skin is enabled by default. Turn it off at
40
51
  dsh plugin --profile desktop remove dsh-islands-ui
41
52
  ```
42
53
 
54
+ Refresh after uninstalling. Your skin preferences stay on this machine and are reused if you reinstall.
55
+
43
56
  ---
44
57
 
45
58
  ## What it changes
@@ -50,11 +63,11 @@ dsh plugin --profile desktop remove dsh-islands-ui
50
63
  | 🧭 | **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
64
  | ⚙️ | **Settings page** | Settings → Islands UI: on/off, accent presets, custom color and follow-theme |
52
65
  | 📌 | **Pinned shelf** | Pinned sessions stay in their workspace and are also aggregated between “New session” and “Workspace”; the group collapses |
53
- | 🌙 | **Dark mode** | Full dark token set: near-black canvas, dark islands, translucent interaction layers |
66
+ | 🌙 | **Dark mode** | Full dark palette: near-black canvas, dark islands, translucent interaction layers |
54
67
  | 🔄 | **Desktop update entry** | Pinned above the settings gear; distinct states for available, downloading, verifying, installing and failure, with accent-colored 3×3 dot-matrix loaders |
55
68
  | ⌨️ | **Shortcuts** | `⌘B`, `⌥⌘B`, `⌘,`, `⌘⇧M`; buttons show the current binding on hover |
56
69
 
57
- The skin is a client-only style layer. Pinning helpers, the pinned shelf and the settings page are also implemented in the browser bundle; no host tool, service or session data is added.
70
+ Everything happens in the interface layer. Rail ordering, the pinned shelf and the settings page do not modify your Harness sessions, settings or plugin data.
58
71
 
59
72
  ---
60
73
 
@@ -65,7 +78,7 @@ The skin is a client-only style layer. Pinning helpers, the pinned shelf and the
65
78
  | Canvas | Solid `#f7f7f7` (dark `#0f1012`), opaque, no blur |
66
79
  | Islands | White / dark-gray surfaces, 16–20px radius, 1px hairline, no shadows |
67
80
  | 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 |
81
+ | 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
82
  | Accent | Brand blue by default; purple / green / orange / pink / red presets or any custom color |
70
83
 
71
84
  ---
@@ -75,12 +88,12 @@ The skin is a client-only style layer. Pinning helpers, the pinned shelf and the
75
88
  | Platform | Status |
76
89
  | --- | --- |
77
90
  | macOS | ✅ Tested |
78
- | Windows | 🟡 Custom top bar, rail, settings gear, right-sidebar toggle and model picker adapted; **not tested on a physical Windows machine** |
79
- | Linux | 🟡 Uses the same top bar and rail; **not tested** |
91
+ | Windows | ✅ Tested (native title bar layout) |
92
+ | Linux | 🟡 Native window decorations, not tested |
80
93
 
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.
94
+ Windows uses DSH's native title bar instead of the plugin's 40px top bar; the workspace collapses from the native sidebar button in the top-left corner, while the right-panel toggle and conversation tools stay in DSH's native conversation header. macOS and Linux use the 40px top bar; Linux window decorations vary by desktop environment.
82
95
 
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.
96
+ When reporting an issue, please include your OS, DSH version, window size and a screenshot.
84
97
 
85
98
  ---
86
99
 
@@ -104,88 +117,21 @@ If you hit a title-bar, drag-region, window-button or layout issue, please open
104
117
 
105
118
  ---
106
119
 
107
- ## State
108
-
109
- Stored in `localStorage`; clear these keys to reset:
110
-
111
- | Key | Purpose |
112
- | --- | --- |
113
- | `dsh-islands-ui:enabled` | `1` / `0`, master switch |
114
- | `dsh-islands-ui:accent` | Custom accent color; absent means follow theme |
115
- | `dsh-islands-ui:pinned-collapsed` | Whether the pinned group is collapsed |
116
- | `dsh-islands-ui:rail` | Left-rail icon order and hidden entries |
117
-
118
- ---
119
-
120
- ## Development
121
-
122
- ```text
123
- src/
124
- 00-tokens.css design tokens + --dsw-* aliases (single source of truth)
125
- 10-shell.css three-column shell → canvas + islands
126
- 15-topbar.css window top bar
127
- 16-rail.css left icon rail, drag reorder, show/hide menu, settings gear
128
- 17-update.css desktop update entry, state styles, 3×3 dot-matrix loaders
129
- 20-sidebar.css workspace island, pinned shelf, session row states
130
- 30-conversation.css conversation page, composer, top tool group
131
- 40-settings.css settings dialog and section shell
132
- 45-model-picker.css model / reasoning popover
133
- 50-components.css preference rows, switches, accent picker
134
- client.template.js browser entry (React components + slot registrations)
135
- build.mjs inline src/*.css into client.js
136
- client.js built, self-contained artifact
137
- scripts/check-package.mjs pre-publish packaging checks
138
- skin.json theme-manager manifest
139
- ```
140
-
141
- ```bash
142
- npm run build # regenerate client.js after editing CSS or the template
143
- npm run check # verify the build is current and the package is publishable
144
- npm run pack:check # npm pack --dry-run
145
- npm pack # produce dsh-islands-ui-<version>.tgz
146
- ```
147
-
148
- The module loader cannot read package files at runtime, so `client.js` must contain the full stylesheet. Always commit the rebuilt artifact.
120
+ ## Data and privacy
149
121
 
150
- ### Package layout
122
+ The skin only redraws the interface. It does not modify or upload your sessions, settings or plugin data.
151
123
 
152
- | Path | Purpose |
153
- | --- | --- |
154
- | `index.js` | Host half; the skin has no host behavior, so this only keeps the bundle a valid profile row |
155
- | `client.js` | Browser half: stylesheet injection, rail, pinned shelf, settings page and model picker |
156
- | `cordis.patch.yml` | One `insert` row named `dsh-islands-ui` |
157
- | `skin.json` | id, display name, accent, body attribute and wiring row for theme managers |
158
- | `screenshots.json` | 1–8 repository-relative screenshots read by storefronts |
159
- | `assets/` | Store icon and README screenshots |
160
-
161
- ### Repository configuration
162
-
163
- | File | Purpose |
164
- | --- | --- |
165
- | `.github/workflows/ci.yml` | Runs `npm run check` and `npm pack --dry-run` on PRs / main across Node 20, 22 and 24 |
166
- | `.github/workflows/publish.yml` | Publishes on a `v*` tag or manual dispatch; the tag must match `package.json`, and `NPM_TOKEN` is required |
167
- | `.github/ISSUE_TEMPLATE/` | Bug and feature forms that require the DSH version, platform and reproduction steps |
168
- | `.github/PULL_REQUEST_TEMPLATE.md` | Build, wide/narrow layout, dark mode and local-path checks |
169
- | `.github/dependabot.yml` | Weekly GitHub Actions version updates |
170
- | `.editorconfig` / `.gitattributes` | UTF-8, LF, 2-space indentation; images and tarballs are binary |
171
- | `.nvmrc` | Node 24 for local development |
172
- | `CONTRIBUTING.md` | Development, build, commit conventions and PR checklist |
173
- | `SECURITY.md` | Supported versions and the private vulnerability-reporting flow |
174
- | `scripts/check-package.mjs` | Pre-publish validation of the manifest, row name, client build, screenshots and `files[]` |
175
-
176
- Repository settings: `main` requires a PR, the `check (Node 20/22/24)` CI jobs and resolved conversations, with force pushes disabled; `v*` tags cannot be deleted or moved; fork PRs from external contributors need maintainer approval.
124
+ The master switch, accent, pinned-group state and rail order are stored in your browser's local storage. Turning the skin off keeps these preferences; to reset them, restore the defaults in Settings or clear the site's local storage.
177
125
 
178
126
  ---
179
127
 
180
128
  ## Compatibility
181
129
 
182
- - 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.
186
- - 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.
130
+ - Supports DSH `0.2.2-rc.1`, `0.2.2-rc.2` and `0.2.2-rc.3`; older versions do not load.
131
+ - If a DSH upgrade changes key interface structure, the skin disables itself with a notice. Update Islands UI and refresh to recover; you can temporarily re-enable it from **Settings → Islands UI** while the interface looks correct.
132
+ - Dark mode follows DSH; the accent applies to both the skin and native buttons.
133
+ - Do not enable multiple themes or skins at once: they change the same palette and layout rules, so the last one loaded wins.
134
+ - Windows uses the native title bar; Linux uses native window decorations, which vary by desktop environment.
189
135
 
190
136
  ---
191
137
 
@@ -193,40 +139,39 @@ Repository settings: `main` requires a PR, the `check (Node 20/22/24)` CI jobs a
193
139
 
194
140
  **Nothing changed after install.**
195
141
 
196
- Check that the plugin is enabled in the current profile and refresh (`⌘R` / `Ctrl+R`). For a local checkout, make sure `client.js` was rebuilt; for npm, compare `npm view dsh-islands-ui version` with the installed version. DSH versions below `0.2.2-rc.1` are not supported.
142
+ Check that the plugin is enabled in the current DSH profile and refresh (`⌘R` / `Ctrl+R`). If your DSH is older than `0.2.2-rc.1`, upgrade DSH first; you can also check the skin status in **Settings → Islands UI**.
197
143
 
198
144
  **Does it touch my sessions or settings?**
199
145
 
200
- No. The skin injects CSS and registers browser-side slots only. Rail pins, the pinned shelf, locate state and accent live in `localStorage`; no session or profile data is written.
146
+ No. The skin only redraws the interface; the master switch, accent, pinned-group state and rail order live in your browser's local storage.
201
147
 
202
148
  **How do I fully reset the skin?**
203
149
 
204
- Turn off **Settings → Islands UI**. To clear the saved preferences too, delete the `dsh-islands-ui:*` localStorage keys (see [State](#state)).
150
+ Turn it off in **Settings → Islands UI** to restore the stock appearance immediately. To reset the saved preferences too, clear the site's local storage.
205
151
 
206
152
  **Can I run it with another theme?**
207
153
 
208
- Not recommended. Two skins write the same `--dsw-*` tokens and layout rules, so the last one loaded wins. dsh-market's Themes tab enforces one active theme; if you installed several manually, keep one.
154
+ Not recommended. Multiple skins change the same palette and layout rules, so the last one loaded wins.
209
155
 
210
156
  **Why do some surfaces keep the old look?**
211
157
 
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.
158
+ A DSH upgrade may change the interface structure. If the skin detects a key mismatch, it disables itself to avoid overlapping layouts. Update Islands UI to a version that supports your DSH and refresh; if the interface looks correct, you can also click "Enable anyway" in Settings for the current session (it re-checks on the next launch).
213
159
 
214
160
  **Windows / Linux?**
215
161
 
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.
162
+ Windows is tested with the native title bar layout. Linux follows native window decorations and has not been tested yet. Please report title-bar, drag-region or window-button issues with your system details.
217
163
 
218
- **Will it be in plugin stores?**
164
+ ---
219
165
 
220
- DSHHub discovers npm packages automatically. dsh-market's Themes tab reads the awesome-dsh-plugin catalog; submit the `theme` entry once the repository meets the listing requirements. See [docs/publishing.md](docs/publishing.md).
166
+ ## Feedback
221
167
 
222
- ---
168
+ - Bugs or compatibility issues: [open an issue](https://github.com/DawnCHL/dsh-islands-ui/issues)
169
+ - Include your OS, DSH version, window size and a screenshot.
170
+ - Feature requests are welcome in Issues too.
171
+ - Security issues: do not open a public issue; report privately following [SECURITY.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/SECURITY.md).
223
172
 
224
- ## Contributing and security
173
+ ## License
225
174
 
226
- - Development, build, commit conventions and PR checklist: [CONTRIBUTING.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/CONTRIBUTING.md)
227
- - Bugs / compatibility: [Issues](https://github.com/DawnCHL/dsh-islands-ui/issues)
228
- - Improvements: PRs welcome
229
- - Windows / Linux test reports especially welcome (screenshot + OS version + window size)
230
- - Security issues: do not open a public issue; follow [SECURITY.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/SECURITY.md)
175
+ [MIT](LICENSE) © DawnCHL
231
176
 
232
177
  <p align="center"><sub>Made for DeepSeek Harness · Islands UI</sub></p>
package/README.md CHANGED
@@ -7,11 +7,9 @@
7
7
  <a href="https://www.npmjs.com/package/dsh-islands-ui"><img alt="npm" src="https://img.shields.io/npm/v/dsh-islands-ui?style=flat-square" /></a>
8
8
  <a href="https://www.npmjs.com/package/dsh-islands-ui"><img alt="downloads" src="https://img.shields.io/npm/dm/dsh-islands-ui?style=flat-square" /></a>
9
9
  <a href="https://github.com/DawnCHL/dsh-islands-ui"><img alt="GitHub" src="https://img.shields.io/badge/GitHub-DawnCHL%2Fdsh--islands--ui-3b3b3b?style=flat-square" /></a>
10
- <a href="https://github.com/DawnCHL/dsh-islands-ui/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/DawnCHL/dsh-islands-ui/actions/workflows/ci.yml/badge.svg" /></a>
11
10
  <a href="LICENSE"><img alt="License" src="https://img.shields.io/npm/l/dsh-islands-ui?style=flat-square" /></a>
12
- <img alt="DSH" src="https://img.shields.io/badge/DeepSeek%20Harness-0.2.2--rc.2-4f7cff?style=flat-square" />
13
- <img alt="Platform" src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-3b3b3b?style=flat-square" />
14
- <img alt="Windows/Linux" src="https://img.shields.io/badge/Windows%2FLinux-untested-orange?style=flat-square" />
11
+ <img alt="DSH 0.2.2-rc.1–rc.3" src="https://img.shields.io/badge/DeepSeek%20Harness-0.2.2--rc.1%E2%80%93rc.3-4f7cff?style=flat-square" />
12
+ <img alt="Platform: macOS, Windows, Linux" src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-3b3b3b?style=flat-square" />
15
13
  </p>
16
14
  </div>
17
15
 
@@ -35,7 +33,17 @@ dsh plugin --profile web add dsh-islands-ui
35
33
 
36
34
  安装后刷新页面(`⌘R` / `Ctrl+R`)。皮肤默认开启;可在 **设置 → Islands UI** 关闭,关闭后立即恢复 Harness 默认外观,偏好和强调色会保留。
37
35
 
38
- > 适用于 DSH `0.2.2-rc.1` 与 `0.2.2-rc.2`。客户端会读取运行中的 DSH 版本(`window.__DSH_BOOT__.release.version`),自动选用对应的侧栏结构样式;更早的 `0.2.x` 构建回退到基础样式。包内声明了完整的 `dsh.bundle` + `dsh.client` manifest,`dsh plugin add` 会自动写入 profile 的 bundle 栈,不需要手工改 `cordis.patch.yml`。
36
+ > 支持 DSH `0.2.2-rc.1`、`0.2.2-rc.2` 与 `0.2.2-rc.3`;更低版本不会加载。DSH 升级后如果界面结构发生变化,皮肤可能自动停用并提示,更新插件后刷新即可恢复。
37
+
38
+ 离线或手动安装本地包:
39
+
40
+ ```bash
41
+ dsh plugin --profile desktop add ./dsh-islands-ui-<version>.tgz
42
+ ```
43
+
44
+ ### 更新
45
+
46
+ 重新执行安装命令,或从插件商店更新,然后刷新页面。如果提示已安装,可先卸载再安装。
39
47
 
40
48
  ### 卸载
41
49
 
@@ -43,6 +51,8 @@ dsh plugin --profile web add dsh-islands-ui
43
51
  dsh plugin --profile desktop remove dsh-islands-ui
44
52
  ```
45
53
 
54
+ 卸载后刷新页面;皮肤偏好仍保存在本机,重新安装会沿用。
55
+
46
56
  ---
47
57
 
48
58
  ## 宣传图
@@ -73,11 +83,11 @@ dsh plugin --profile desktop remove dsh-islands-ui
73
83
  | 🧭 | **常驻左侧栏** | 工作区与全部插件图标直接排列;首页按钮只作会话 / 工作区抽屉触发器、不占选中态(hover 浅色反馈、点击半透明涟漪);面板图标点击切换,按住拖动排序(浮动预览跟随鼠标),右键显示 / 隐藏图标 |
74
84
  | ⚙️ | **独立设置页** | 设置 → Islands UI:一键开关皮肤、强调色(预设 + 自定义 + 跟随主题) |
75
85
  | 📌 | **置顶聚合** | 置顶会话同时保留在原工作区,并聚合到「新会话」与「工作区」标题之间;分类可折叠 |
76
- | 🌙 | **深色模式** | 完整深色 token:近黑画布、深灰岛屿、白色透明交互层与深色阴影 |
86
+ | 🌙 | **深色模式** | 完整深色配色:近黑画布、深灰岛屿、白色透明交互层与深色阴影 |
77
87
  | 🔄 | **桌面更新入口** | 设置齿轮上方常驻;发现新版本、下载、校验、安装与失败各有独立状态,加载态使用强调色 3×3 点阵动效 |
78
88
  | ⌨️ | **快捷键** | `⌘B` 折叠工作区、`⌥⌘B` 右侧栏、`⌘,` 设置、`⌘⇧M` 模型弹层;按钮悬停显示当前键位 |
79
89
 
80
- 皮肤是纯客户端样式层;左侧栏图标排序与显隐、置顶聚合、定位与设置页也都在浏览器端完成,不新增 host 工具、服务或会话数据。
90
+ 所有改动都在界面层完成;左侧栏图标排序与显隐、置顶聚合、定位和设置页不会修改 Harness 的会话、设置或插件数据。
81
91
 
82
92
  ### 设计语言
83
93
 
@@ -86,7 +96,7 @@ dsh plugin --profile desktop remove dsh-islands-ui
86
96
  | 画布 | 纯色 `#f7f7f7`(深色 `#0f1012`),不透明、无毛玻璃 |
87
97
  | 岛屿 | 白色 / 深灰表面,16–20px 圆角,1px 发丝描边,无投影 |
88
98
  | 间距 | 所有岛屿统一 5px 间隙,左右、顶部、底部、底部面板四周一致 |
89
- | 顶部栏 | 40px 窗口栏,承载工作区折叠、对话工具组和右侧栏开关;macOS 避开红绿灯,Windows/Linux 从 8px 开始 |
99
+ | 顶部栏 | 40px 窗口栏,承载对话工具组和右侧栏开关;macOS 避开红绿灯,Linux 从 8px 开始。Windows 不渲染该顶栏:标题栏保留原生侧栏开关,右侧工具回到会话头原生位置 |
90
100
  | 强调色 | 默认品牌蓝,可改为紫 / 绿 / 橙 / 粉 / 红或任意取色 |
91
101
 
92
102
  ### 常用快捷键
@@ -109,98 +119,31 @@ dsh plugin --profile desktop remove dsh-islands-ui
109
119
 
110
120
  | 平台 | 状态 |
111
121
  | --- | --- |
112
- | macOS | ✅ 已实测(开发与日常使用环境) |
113
- | Windows | 🟡 已适配自定义顶栏、左侧栏、设置齿轮、右侧开关、置顶聚合与模型弹层,并在原生标题栏下方预留高度;**尚未在真实 Windows 电脑上实测** |
114
- | Linux | 🟡 使用同一套顶栏与左侧栏;**尚未实测** |
115
-
116
- Windows 下保留 Harness 原生标题栏,自定义顶栏显示在它下方;左侧栏、设置齿轮、右侧栏开关和快捷键均已启用。Linux 按原生窗口装饰处理,不同桌面环境可能有差异。
117
-
118
- > **反馈**:如果你在 Windows 或 Linux 上遇到标题栏高度、拖拽区域、窗口按钮重叠、布局错位或快捷键问题,欢迎提交 [Issue](https://github.com/DawnCHL/dsh-islands-ui/issues) 或 PR,附系统版本、窗口尺寸和截图即可。
119
-
120
- ---
121
-
122
- ## 状态存储
122
+ | macOS | ✅ 已实测 |
123
+ | Windows | ✅ 已实测(原生标题栏布局) |
124
+ | Linux | 🟡 按原生窗口装饰适配,尚未实测 |
123
125
 
124
- | `localStorage` key | 作用 |
125
- | --- | --- |
126
- | `dsh-islands-ui:enabled` | `1` / `0`,总开关 |
127
- | `dsh-islands-ui:accent` | 自定义强调色(不存在表示跟随主题) |
128
- | `dsh-islands-ui:pinned-collapsed` | 置顶分类是否折叠 |
129
- | `dsh-islands-ui:rail` | 左侧栏图标的顺序与隐藏列表 |
126
+ Windows 使用 DSH 原生标题栏,不渲染插件的 40px 顶栏;工作区折叠由标题栏左上角的原生侧栏按钮控制,右侧栏开关与会话工具留在 DSH 原生会话头位置。macOS / Linux 使用同一套 40px 顶栏;Linux 的窗口装饰因桌面环境而异。
130
127
 
131
- 清除这些 key 即可恢复默认。
128
+ > 反馈时请附上系统版本、DSH 版本、窗口尺寸和截图,方便定位问题。
132
129
 
133
130
  ---
134
131
 
135
- ## 开发
136
-
137
- ```text
138
- src/
139
- 00-tokens.css 设计变量 + 重定向 Harness 的 --dsw-* 别名(唯一真源)
140
- 10-shell.css 三栏框架 → 画布 + 岛屿
141
- 15-topbar.css 窗口顶部栏
142
- 16-rail.css 左侧图标栏、拖动排序、显隐菜单、设置齿轮
143
- 20-sidebar.css 工作区岛屿、置顶聚合、会话行状态
144
- 30-conversation.css 会话页、输入框、顶部工具组
145
- 40-settings.css 设置弹窗、设置页外壳
146
- 45-model-picker.css 模型/推理两级弹层
147
- 50-components.css 偏好行、开关、强调色选择器等共享组件
148
- client.template.js 浏览器端入口模板(React 组件 + 插槽注册)
149
- build.mjs 把 src/*.css 内联进 client.js
150
- client.js 构建产物(自包含,运行时无法读文件)
151
- scripts/check-package.mjs 发布前包内容校验
152
- skin.json 主题管理器清单
153
- docs/ 发布与商店收录说明
154
- ```
155
-
156
- ```bash
157
- npm run build # 修改 src/*.css 或模板后重新生成 client.js
158
- npm run check # 校验 client.js 是否为最新,并检查 npm 包是否可发布
159
- npm run pack:check # npm pack --dry-run
160
- npm pack # 生成 dsh-islands-ui-<version>.tgz
161
- ```
162
-
163
- 开发时直接在 Harness 中刷新(`⌘R`)即可;`client.js` 是自包含的浏览器模块,样式在加载时注入。模块加载器运行时无法读取包内文件,因此修改 CSS 后必须重新构建并提交 `client.js`。
132
+ ## 数据与隐私
164
133
 
165
- ### 包内容
134
+ 皮肤只重绘界面,不会修改或上传你的会话、设置或插件数据。
166
135
 
167
- | 路径 | 作用 |
168
- | --- | --- |
169
- | `index.js` | host 半边;皮肤没有 host 行为,仅用于保持合法的 profile row |
170
- | `client.js` | 浏览器半边:样式注入、左侧栏、置顶聚合、设置页与模型弹层 |
171
- | `cordis.patch.yml` | 一条 `insert`,row name 为 `dsh-islands-ui` |
172
- | `skin.json` | 给主题管理器的 id、名称、强调色、body 属性与挂载行 |
173
- | `screenshots.json` | 商店读取的 1–8 张仓库相对路径截图 |
174
- | `assets/` | 商店图标与 README 截图 |
175
-
176
- ### 仓库配置
177
-
178
- | 文件 | 作用 |
179
- | --- | --- |
180
- | `.github/workflows/ci.yml` | PR / main 上跑 `npm run check` 和 `npm pack --dry-run`,Node 20 / 22 / 24 矩阵 |
181
- | `.github/workflows/publish.yml` | 推送 `v*` tag 或手动触发发布;tag 必须与 `package.json` 版本一致,使用 `NPM_TOKEN` secret |
182
- | `.github/ISSUE_TEMPLATE/` | Bug / Feature 表单,强制填写 DSH 版本、平台和复现步骤 |
183
- | `.github/PULL_REQUEST_TEMPLATE.md` | PR 自检:构建、宽窄屏、深色模式、无本地路径 |
184
- | `.github/dependabot.yml` | 每周检查 GitHub Actions 版本更新 |
185
- | `.editorconfig` / `.gitattributes` | 统一 UTF-8、LF、2 空格;图片和 tarball 按二进制处理 |
186
- | `.nvmrc` | 本地开发使用 Node 24 |
187
- | `CONTRIBUTING.md` | 开发、构建、提交约定和 PR 清单 |
188
- | `SECURITY.md` | 支持版本与私密漏洞报告流程 |
189
- | `scripts/check-package.mjs` | 包里 manifest、row name、client 构建、截图和 `files[]` 的发布前校验 |
190
-
191
- 仓库设置:`main` 需要 PR、CI 的 `check (Node 20/22/24)` 通过和对话解决后才能合并,且禁止 force push;`v*` tag 禁止删除/移动;外部 fork PR 需要维护者批准。
136
+ 总开关、强调色、置顶折叠和左侧栏顺序保存在本机浏览器存储中;关闭皮肤不会删除这些偏好。需要重置时,可在设置中改回默认,或清除该站点的本地存储。
192
137
 
193
138
  ---
194
139
 
195
- ## 兼容性与边界
140
+ ## 兼容性
196
141
 
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 版本与侧栏结构,便于排查升级后的样式问题。
201
- - 深色模式跟随 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、强调色和挂载行。
142
+ - 支持 DSH `0.2.2-rc.1`、`0.2.2-rc.2` 与 `0.2.2-rc.3`;更低版本不会加载。
143
+ - 如果 DSH 升级改变了关键界面结构,皮肤会自动停用并提示;更新 Islands UI 后刷新页面即可恢复。确认界面正常时,可在 **设置 → Islands UI** 临时重新启用。
144
+ - 深色模式跟随 DSH;强调色会同时作用于皮肤和原生按钮。
145
+ - 不建议同时启用多个主题/皮肤:它们会修改同一批界面配色和布局规则,后加载的会覆盖先加载的。
146
+ - Windows 使用原生标题栏;Linux 使用原生窗口装饰,不同桌面环境的表现可能有差异。
204
147
 
205
148
  ---
206
149
 
@@ -208,41 +151,36 @@ npm pack # 生成 dsh-islands-ui-<version>.tgz
208
151
 
209
152
  **安装后没有变化?**
210
153
 
211
- 先确认当前 profile 里插件是启用状态,并刷新页面(`⌘R` / `Ctrl+R`)。本地开发版还需要确认 `client.js` 已经重新构建;从 npm 安装则检查 `npm view dsh-islands-ui version` 与已安装版本是否一致。DSH 版本低于 `0.2.2-rc.1` 时不会加载。
154
+ 先确认当前 DSH 配置(profile)中插件已启用,并刷新页面(`⌘R` / `Ctrl+R`)。如果 DSH 版本低于 `0.2.2-rc.1`,请先升级 DSH;也可以到 **设置 → Islands UI** 查看皮肤状态。
212
155
 
213
156
  **会修改我的会话、设置或插件数据吗?**
214
157
 
215
- 不会。皮肤只注入样式并注册浏览器端插槽;左侧栏固定、置顶聚合、定位和强调色都存在 `localStorage` 里,不写会话或 profile 数据。
158
+ 不会。皮肤只重绘界面;总开关、强调色、置顶折叠和左侧栏顺序保存在本机浏览器存储中。
216
159
 
217
160
  **怎么彻底恢复默认外观?**
218
161
 
219
- 设置 → Islands UI 关闭总开关即可立即恢复。需要连偏好一起清空时,删除 `dsh-islands-ui:*` 这几个 `localStorage` key(见[状态存储](#状态存储))。
162
+ 在 **设置 → Islands UI** 关闭总开关即可立即恢复。需要连偏好一起重置时,清除该站点的本地存储。
220
163
 
221
164
  **可以和别的主题/皮肤同时开吗?**
222
165
 
223
- 不建议。两个皮肤会同时改同一批 `--dsw-*` token 和布局,后加载的会覆盖前一个。dsh-market 的「主题」Tab 本身按单主题激活管理;如果你手动装了多个,保留一个即可。
166
+ 不建议。多个皮肤会同时修改同一批界面配色和布局规则,后加载的会覆盖前一个。
224
167
 
225
168
  **为什么某些界面还是旧样式?**
226
169
 
227
- 说明皮肤**检测到界面结构不匹配,已自动关闭**。DSH 升级可能改掉皮肤依赖的 CSS Module 哈希类名,半启用会变成双栏重叠,所以插件宁可保持默认外观:右下角会有提示,设置 → Islands UI 顶部有黄色说明条并列出缺失的锚点。把 Islands UI 更新到适配当前 DSH 的版本即可恢复;确认界面正常也可以点「仍然启用」临时开启(下次启动重新检测)。
170
+ DSH 升级可能改变界面结构;皮肤检测到关键界面不匹配时会自动停用,避免出现双栏重叠。更新 Islands UI 到适配当前 DSH 的版本后刷新即可恢复;确认界面正常时,也可以在设置页点「仍然启用」临时开启(下次启动会重新检测)。
228
171
 
229
172
  **Windows / Linux 能用吗?**
230
173
 
231
- 已按自定义顶栏、左侧栏、右侧栏开关和标题栏高度适配,但还没有在真实 Windows / Linux 机器上实测。遇到标题栏、拖拽区或窗口按钮问题,欢迎按 Issue 模板反馈。
232
-
233
- **会发到插件商店吗?**
234
-
235
- npm 发布后 DSHHub 会自动发现;dsh-market 的「主题」Tab 读取 awesome-dsh-plugin 目录,需要仓库满足收录条件后提交一条 `theme` 条目。具体步骤见 [docs/publishing.md](docs/publishing.md)。
174
+ Windows 已实测,使用原生标题栏布局;Linux 按原生窗口装饰适配,尚未实测。遇到标题栏、拖拽区或窗口按钮问题,欢迎反馈。
236
175
 
237
176
  ---
238
177
 
239
- ## 贡献与安全
178
+ ## 反馈
240
179
 
241
- - 开发、构建、提交约定和 PR 清单:[CONTRIBUTING.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/CONTRIBUTING.md)
242
- - Bug / 兼容性问题:[Issues](https://github.com/DawnCHL/dsh-islands-ui/issues)
243
- - 改进或新功能:欢迎直接开 PR
244
- - 特别欢迎 Windows / Linux 的实测反馈(截图 + 系统版本 + 窗口尺寸)
245
- - 安全漏洞:不要开公开 Issue,按 [SECURITY.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/SECURITY.md) 走私密报告
180
+ - 遇到 Bug 或兼容性问题:[提交 Issue](https://github.com/DawnCHL/dsh-islands-ui/issues)
181
+ - 反馈时请附上系统版本、DSH 版本、窗口尺寸和截图。
182
+ - 功能建议也欢迎在 Issues 中提出。
183
+ - 安全漏洞:请不要开公开 Issue,按 [SECURITY.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/SECURITY.md) 私密报告。
246
184
 
247
185
  ## License
248
186