dsh-islands-ui 1.1.1 → 1.2.0

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,42 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.2.0 — 2026-11-16
4
+
5
+ ### 界面
6
+
7
+ - 新增平滑输入光标:覆盖光标与文字同高(取选区字形框高度),在同一行内以 150ms 的 `transform` 过渡平滑滑动;换行时直接跳到新行,避免斜向拖动。输入法组词期间回退到原生光标,指令 chip 选中、非折叠选区或失焦时隐藏覆盖光标。设置 → Islands UI 新增「平滑输入光标」开关,默认开启,偏好写入 `localStorage`(`dsh-islands-ui:smooth-caret`)。
8
+ - 对话输入框的光标统一由强调色 token 驱动:默认读取主题的 `--dsw-alias-state-business-primary`,自定义强调色时同步变化;平滑光标开启时由一层 2px 覆盖光标绘制,绘制期间原生光标置为透明,二者使用同一颜色。
9
+ - 发送按钮跟随强调色:原生按钮读取的是 `--dsw-alias-button-info-fill`,不会随自定义强调色变化;现改为 `--dsw-alias-state-business-primary`,并在自定义强调色时按亮/暗主题派生 hover 色。按钮通过 `composer-primary` 部件读取,不写哈希类名。
10
+
11
+ ### 修复
12
+
13
+ - 窄屏(≤767px)右侧栏被工作区抽屉遮挡:右栏在窄屏由宿主切换为 `fullscreen` 覆盖层,但仍挂载在框架内的零宽右列中,抽屉遮罩(z-index 70)因此盖在它上面——抽屉一打开右侧栏就整块消失,而切换按钮仍显示“已打开”,看起来再也叫不出来。现在全屏右栏在窄屏下升到遮罩、抽屉和窗口外壳层之上(z-index 78)。
14
+ - 窄屏全屏右栏的定位偏出画布:宿主用 `right: 0` 把它挂在零宽右列上,皮肤的 5px 内边距使它左移一格、右侧留出 5px 画布。现在按画布间隙把它对齐到窗口外沿。
15
+ - 圆形控件被宿主的 `corner-shape` 规则压成圆角方形:DSH 用一条全局 `*, :before, :after { corner-shape: superellipse(1.5) }` 给所有圆角换成了 iOS 式超椭圆,`border-radius: 50%` 只决定圆角大小、不决定曲线形状,所以更新入口、开关、强调色色块、点阵圆点、滑块圆钮等看着都是"方圆"。皮肤自己的圆形控件显式声明 `corner-shape: round`(Chromium 之外该声明被忽略,退回普通圆角)。
16
+ - 更新入口的底色被对话区规则覆盖:按钮原本沿用了宿主的 `data-phase` 契约,而 `src/30-conversation.css` 里有 `body[data-islands-ui] [data-phase] { background: transparent }`(同特异性、且该文件在样式表末尾),于是未 hover 时按钮底色全透明、只剩阴影,hover 才因为规则更具体变蓝。属性改为皮肤自己的 `data-update-phase`,宿主契约规则不再命中。
17
+ - 更新入口改为跟随强调色:底色与阴影读 `--dsw-alias-state-business-primary`(皮肤把它重映射为自定义强调色),hover 色由同一 token 派生;之前是两个写死的品牌蓝,自定义强调色时不会跟随。窄屏全屏右栏改为 `position: fixed` 贴视口:宿主把它挂在右轨里用 `right: 0` 定位,右轨一旦有宽度面板就被推出屏幕,画面只剩空画布而按钮仍显示“已打开”。
18
+ - 更新入口的 `is-pending` 不再使用整体 `opacity`:那会把圆面的颜色淡化到画布色、却让彩色阴影留在原处,读起来像一枚发白的圆片浮在阴影上。改为保持饱和底色、取消上浮并收紧阴影,同时覆盖仍生效的 hover 规则(原先 hover 的特异性高于 pending)。
19
+
20
+ ### 兼容性
21
+
22
+ - 平滑光标使用独立的兼容探测,与全局皮肤门禁分离:只检查 composer 的公开钩子(`[data-composer-input]`、`[data-input-scroll]`、定位包裹层)与 `data-*caret*` 外部光标标记,不再按 DSH 版本号判断。不匹配时只回退原生光标,在设置页对应开关下显示行内提示并禁用该开关,不影响皮肤其他部分;兼容后按用户原偏好自动恢复。
23
+ - 平滑光标的控制器拆成 `src/host/caret.js`,与 `src/host/runtime.js` 一样由 `build.mjs` 内联,不依赖模板内部符号;样式独立为 `src/31-caret.css`。`data-composer-input`、`data-composer-composing`、`data-composer-chip-selected`、`data-input-scroll` 登记进宿主契约表,`data-islands-smooth-caret`、`data-islands-caret-active` 登记进门禁的自身属性白名单。
24
+
25
+ ## 1.1.2 — 2026-11-15
26
+
27
+ ### 修复
28
+
29
+ - 设置入口不再先展开账号菜单:打开菜单后在绘制前同步点击“设置”,齿轮直达设置页。设置触发器在 rc.3 的侧栏脚注中已不存在,回退路径不再依赖固定延时。
30
+ - 设置页部件改为按作用域标记:`settings-panel` 只落在设置对话框本身,`nav`/`navTitle`/`header`/`options` 只读对话框直接子级,`close` 只在 header 内标记,导航行只在导航子树内标记。修复「内置插件」页的 tab 面板被误标成设置面板、套上 860px 宽度后被内容列裁切的问题;插件页自己的 `.panel`/`.section`/`.card` 不再获得设置页部件。
31
+ - Windows 标题栏按钮区颜色跟随皮肤 token:桌面端从 `--dsw-specific-sidebar-fill` 测量 caption 颜色,但它的 observer 只监听 body 的 `style`/`data-ds-dark-theme`。皮肤启用/停用时写入一个无副作用的行内自定义属性,触发重新测量,消除三大键区域与标题栏的色差。
32
+ - Windows 左上角原生侧栏开关改为皮肤的保宽折叠:原生 `toggleSidebar` 关闭即丢弃拖拽宽度、重新打开回到默认 280px;现在截获该按钮的点击并走 `data-islands-workspace-collapsed` 路径,宽度不再丢失。macOS / Linux 的自绘顶栏开关不变。
33
+ - 模型选择器与输入区底行对齐:`.isl-model` 改为 flex 容器,消除 inline-flex 触发器在块级 wrapper 中产生的行盒/基线空隙。
34
+
35
+ ### 兼容性
36
+
37
+ - 设置页不再按通用 local class(`card`/`section`/`panel`)广播部件;这些名字在 DSH 自己的插件设置页里也会出现。第三方设置页现在保持原生几何,只继承颜色 token。
38
+ - `npm run check` 新增设置页部件作用域断言;`check:parts` 的部件表按新的对话框/导航/头部作用域标记。
39
+
3
40
  ## 1.1.1 — 2026-11-14
4
41
 
5
42
  ### 界面
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
@@ -48,13 +61,13 @@ dsh plugin --profile desktop remove dsh-islands-ui
48
61
  | :---: | --- | --- |
49
62
  | 🏝 | **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
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
- | ⚙️ | **Settings page** | Settings → Islands UI: on/off, accent presets, custom color and follow-theme |
64
+ | ⚙️ | **Settings page** | Settings → Islands UI: on/off, accent presets, custom color, follow-theme and the smooth input caret |
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
 
@@ -67,6 +80,7 @@ The skin is a client-only style layer. Pinning helpers, the pinned shelf and the
67
80
  | Spacing | 5px between every island, including the bottom panel |
68
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 |
83
+ | Caret | The conversation composer uses a smooth caret: it glides along a line, jumps to the next one, and follows the accent color; it can be turned off in settings |
70
84
 
71
85
  ---
72
86
 
@@ -75,12 +89,12 @@ The skin is a client-only style layer. Pinning helpers, the pinned shelf and the
75
89
  | Platform | Status |
76
90
  | --- | --- |
77
91
  | macOS | ✅ Tested |
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
- | Linux | 🟡 Uses the same top bar and rail; **not tested** |
92
+ | Windows | ✅ Tested (native title bar layout) |
93
+ | Linux | 🟡 Native window decorations, not tested |
80
94
 
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.
95
+ 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
96
 
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.
97
+ When reporting an issue, please include your OS, DSH version, window size and a screenshot.
84
98
 
85
99
  ---
86
100
 
@@ -104,93 +118,21 @@ If you hit a title-bar, drag-region, window-button or layout issue, please open
104
118
 
105
119
  ---
106
120
 
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
- 60-peers.css third-party plugin adapters ([class*=...] is allowed only here)
135
- host/runtime.js host contracts, local-name extraction, part table, walker
136
- client.template.js browser entry (React components + slot registrations)
137
- build.mjs inline src/*.css and host/runtime.js into client.js
138
- client.js built, self-contained artifact
139
- scripts/check-css.mjs selector gate
140
- scripts/check-parts.mjs part-table gate
141
- scripts/check-package.mjs pre-publish packaging checks
142
- test/ local-name and table-integrity tests
143
- skin.json theme-manager manifest
144
- ```
145
-
146
- ```bash
147
- npm run build # regenerate client.js after editing CSS or the template
148
- npm run check # verify the build is current and the package is publishable
149
- npm run pack:check # npm pack --dry-run
150
- npm pack # produce dsh-islands-ui-<version>.tgz
151
- ```
152
-
153
- The module loader cannot read package files at runtime, so `client.js` must contain the full stylesheet. Always commit the rebuilt artifact.
121
+ ## Data and privacy
154
122
 
155
- ### Package layout
123
+ The skin only redraws the interface. It does not modify or upload your sessions, settings or plugin data.
156
124
 
157
- | Path | Purpose |
158
- | --- | --- |
159
- | `index.js` | Host half; the skin has no host behavior, so this only keeps the bundle a valid profile row |
160
- | `client.js` | Browser half: stylesheet injection, rail, pinned shelf, settings page and model picker |
161
- | `cordis.patch.yml` | One `insert` row named `dsh-islands-ui` |
162
- | `skin.json` | id, display name, accent, body attribute and wiring row for theme managers |
163
- | `screenshots.json` | 1–8 repository-relative screenshots read by storefronts |
164
- | `assets/` | Store icon and README screenshots |
165
-
166
- ### Repository configuration
167
-
168
- | File | Purpose |
169
- | --- | --- |
170
- | `.github/workflows/ci.yml` | Runs `npm run check` and `npm pack --dry-run` on PRs / main across Node 20, 22 and 24 |
171
- | `.github/workflows/publish.yml` | Publishes on a `v*` tag or manual dispatch; the tag must match `package.json`, and `NPM_TOKEN` is required |
172
- | `.github/ISSUE_TEMPLATE/` | Bug and feature forms that require the DSH version, platform and reproduction steps |
173
- | `.github/PULL_REQUEST_TEMPLATE.md` | Build, wide/narrow layout, dark mode and local-path checks |
174
- | `.github/dependabot.yml` | Weekly GitHub Actions version updates |
175
- | `.editorconfig` / `.gitattributes` | UTF-8, LF, 2-space indentation; images and tarballs are binary |
176
- | `.nvmrc` | Node 24 for local development |
177
- | `CONTRIBUTING.md` | Development, build, commit conventions and PR checklist |
178
- | `SECURITY.md` | Supported versions and the private vulnerability-reporting flow |
179
- | `scripts/check-package.mjs` | Pre-publish validation of the manifest, row name, client build, screenshots and `files[]` |
180
-
181
- 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.
125
+ The master switch, accent, smooth-caret switch, 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.
182
126
 
183
127
  ---
184
128
 
185
129
  ## Compatibility
186
130
 
187
- - The skin is a pure client style layer and does not replace session, settings or plugin data or behavior.
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.
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.
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.
131
+ - Supports DSH `0.2.2-rc.1`, `0.2.2-rc.2` and `0.2.2-rc.3`; older versions do not load.
132
+ - 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.
133
+ - Dark mode follows DSH; the accent applies to both the skin and native buttons.
134
+ - Do not enable multiple themes or skins at once: they change the same palette and layout rules, so the last one loaded wins.
135
+ - Windows uses the native title bar; Linux uses native window decorations, which vary by desktop environment.
194
136
 
195
137
  ---
196
138
 
@@ -198,40 +140,39 @@ Repository settings: `main` requires a PR, the `check (Node 20/22/24)` CI jobs a
198
140
 
199
141
  **Nothing changed after install.**
200
142
 
201
- 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.
143
+ 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**.
202
144
 
203
145
  **Does it touch my sessions or settings?**
204
146
 
205
- 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.
147
+ No. The skin only redraws the interface; the master switch, accent, smooth-caret switch, pinned-group state and rail order live in your browser's local storage.
206
148
 
207
149
  **How do I fully reset the skin?**
208
150
 
209
- Turn off **Settings → Islands UI**. To clear the saved preferences too, delete the `dsh-islands-ui:*` localStorage keys (see [State](#state)).
151
+ 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.
210
152
 
211
153
  **Can I run it with another theme?**
212
154
 
213
- 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.
155
+ Not recommended. Multiple skins change the same palette and layout rules, so the last one loaded wins.
214
156
 
215
157
  **Why do some surfaces keep the old look?**
216
158
 
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.
159
+ 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).
218
160
 
219
161
  **Windows / Linux?**
220
162
 
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.
163
+ 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.
222
164
 
223
- **Will it be in plugin stores?**
165
+ ---
224
166
 
225
- 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).
167
+ ## Feedback
226
168
 
227
- ---
169
+ - Bugs or compatibility issues: [open an issue](https://github.com/DawnCHL/dsh-islands-ui/issues)
170
+ - Include your OS, DSH version, window size and a screenshot.
171
+ - Feature requests are welcome in Issues too.
172
+ - Security issues: do not open a public issue; report privately following [SECURITY.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/SECURITY.md).
228
173
 
229
- ## Contributing and security
174
+ ## License
230
175
 
231
- - Development, build, commit conventions and PR checklist: [CONTRIBUTING.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/CONTRIBUTING.md)
232
- - Bugs / compatibility: [Issues](https://github.com/DawnCHL/dsh-islands-ui/issues)
233
- - Improvements: PRs welcome
234
- - Windows / Linux test reports especially welcome (screenshot + OS version + window size)
235
- - Security issues: do not open a public issue; follow [SECURITY.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/SECURITY.md)
176
+ [MIT](LICENSE) © DawnCHL
236
177
 
237
178
  <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
  ## 宣传图
@@ -71,13 +81,13 @@ dsh plugin --profile desktop remove dsh-islands-ui
71
81
  | :---: | --- | --- |
72
82
  | 🏝 | **浮岛布局** | 画布、主会话、工作区、右侧栏、底部面板各自独立;扁平无投影,以色块 + 1px 发丝线分隔 |
73
83
  | 🧭 | **常驻左侧栏** | 工作区与全部插件图标直接排列;首页按钮只作会话 / 工作区抽屉触发器、不占选中态(hover 浅色反馈、点击半透明涟漪);面板图标点击切换,按住拖动排序(浮动预览跟随鼠标),右键显示 / 隐藏图标 |
74
- | ⚙️ | **独立设置页** | 设置 → Islands UI:一键开关皮肤、强调色(预设 + 自定义 + 跟随主题) |
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
 
@@ -88,6 +98,7 @@ dsh plugin --profile desktop remove dsh-islands-ui
88
98
  | 间距 | 所有岛屿统一 5px 间隙,左右、顶部、底部、底部面板四周一致 |
89
99
  | 顶部栏 | 40px 窗口栏,承载对话工具组和右侧栏开关;macOS 避开红绿灯,Linux 从 8px 开始。Windows 不渲染该顶栏:标题栏保留原生侧栏开关,右侧工具回到会话头原生位置 |
90
100
  | 强调色 | 默认品牌蓝,可改为紫 / 绿 / 橙 / 粉 / 红或任意取色 |
101
+ | 输入光标 | 对话输入框使用平滑光标:同一行内随选区滑动、换行直达,颜色跟随强调色;可在设置中关闭 |
91
102
 
92
103
  ### 常用快捷键
93
104
 
@@ -109,103 +120,31 @@ dsh plugin --profile desktop remove dsh-islands-ui
109
120
 
110
121
  | 平台 | 状态 |
111
122
  | --- | --- |
112
- | macOS | ✅ 已实测(开发与日常使用环境) |
113
- | Windows | 🟡 已适配原生标题栏布局(不渲染插件顶栏)、左侧栏、设置齿轮、右侧工具原生位置、置顶聚合与模型弹层;**尚未在真实 Windows 电脑上实测** |
114
- | Linux | 🟡 使用同一套顶栏与左侧栏;**尚未实测** |
115
-
116
- Windows 下不渲染插件顶栏,岛屿直接接在原生标题栏下方;工作区折叠使用标题栏左上角的 DSH 原生侧栏按钮,右侧栏开关、底部面板入口与会话工具留在 DSH 原生的会话头位置(位置、外观与悬停都交给宿主)。左侧栏、设置齿轮和快捷键均已启用。Linux 按原生窗口装饰处理,不同桌面环境可能有差异。
117
-
118
- > **反馈**:如果你在 Windows 或 Linux 上遇到标题栏高度、拖拽区域、窗口按钮重叠、布局错位或快捷键问题,欢迎提交 [Issue](https://github.com/DawnCHL/dsh-islands-ui/issues) 或 PR,附系统版本、窗口尺寸和截图即可。
119
-
120
- ---
121
-
122
- ## 状态存储
123
+ | macOS | ✅ 已实测 |
124
+ | Windows | ✅ 已实测(原生标题栏布局) |
125
+ | Linux | 🟡 按原生窗口装饰适配,尚未实测 |
123
126
 
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` | 左侧栏图标的顺序与隐藏列表 |
127
+ Windows 使用 DSH 原生标题栏,不渲染插件的 40px 顶栏;工作区折叠由标题栏左上角的原生侧栏按钮控制,右侧栏开关与会话工具留在 DSH 原生会话头位置。macOS / Linux 使用同一套 40px 顶栏;Linux 的窗口装饰因桌面环境而异。
130
128
 
131
- 清除这些 key 即可恢复默认。
129
+ > 反馈时请附上系统版本、DSH 版本、窗口尺寸和截图,方便定位问题。
132
130
 
133
131
  ---
134
132
 
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
- 60-peers.css 第三方插件适配(仅此文件允许 [class*=...])
149
- host/runtime.js 宿主契约、本地名提取、区域/部件表、遍历器
150
- client.template.js 浏览器端入口模板(React 组件 + 插槽注册)
151
- build.mjs 把 src/*.css 与 host/runtime.js 内联进 client.js
152
- client.js 构建产物(自包含,运行时无法读文件)
153
- scripts/check-css.mjs 选择器门禁
154
- scripts/check-parts.mjs 部件表门禁
155
- scripts/check-package.mjs 发布前包内容校验
156
- test/ 本地名与表完整性测试
157
- skin.json 主题管理器清单
158
- docs/ 发布、商店收录与宿主契约说明
159
- ```
160
-
161
- ```bash
162
- npm run build # 修改 src/*.css 或模板后重新生成 client.js
163
- npm run check # 校验 client.js、CSS/部件门禁、单元测试和 npm 包
164
- npm run pack:check # npm pack --dry-run
165
- npm pack # 生成 dsh-islands-ui-<version>.tgz
166
- ```
167
-
168
- 开发时直接在 Harness 中刷新(`⌘R`)即可;`client.js` 是自包含的浏览器模块,样式在加载时注入。模块加载器运行时无法读取包内文件,因此修改 CSS 后必须重新构建并提交 `client.js`。
133
+ ## 数据与隐私
169
134
 
170
- ### 包内容
135
+ 皮肤只重绘界面,不会修改或上传你的会话、设置或插件数据。
171
136
 
172
- | 路径 | 作用 |
173
- | --- | --- |
174
- | `index.js` | host 半边;皮肤没有 host 行为,仅用于保持合法的 profile row |
175
- | `client.js` | 浏览器半边:样式注入、左侧栏、置顶聚合、设置页与模型弹层 |
176
- | `cordis.patch.yml` | 一条 `insert`,row name 为 `dsh-islands-ui` |
177
- | `skin.json` | 给主题管理器的 id、名称、强调色、body 属性与挂载行 |
178
- | `screenshots.json` | 商店读取的 1–8 张仓库相对路径截图 |
179
- | `assets/` | 商店图标与 README 截图 |
180
-
181
- ### 仓库配置
182
-
183
- | 文件 | 作用 |
184
- | --- | --- |
185
- | `.github/workflows/ci.yml` | PR / main 上跑 `npm run check` 和 `npm pack --dry-run`,Node 20 / 22 / 24 矩阵 |
186
- | `.github/workflows/publish.yml` | 推送 `v*` tag 或手动触发发布;tag 必须与 `package.json` 版本一致,使用 `NPM_TOKEN` secret |
187
- | `.github/ISSUE_TEMPLATE/` | Bug / Feature 表单,强制填写 DSH 版本、平台和复现步骤 |
188
- | `.github/PULL_REQUEST_TEMPLATE.md` | PR 自检:构建、宽窄屏、深色模式、无本地路径 |
189
- | `.github/dependabot.yml` | 每周检查 GitHub Actions 版本更新 |
190
- | `.editorconfig` / `.gitattributes` | 统一 UTF-8、LF、2 空格;图片和 tarball 按二进制处理 |
191
- | `.nvmrc` | 本地开发使用 Node 24 |
192
- | `CONTRIBUTING.md` | 开发、构建、提交约定和 PR 清单 |
193
- | `SECURITY.md` | 支持版本与私密漏洞报告流程 |
194
- | `scripts/check-package.mjs` | 包里 manifest、row name、client 构建、截图和 `files[]` 的发布前校验 |
195
-
196
- 仓库设置:`main` 需要 PR、CI 的 `check (Node 20/22/24)` 通过和对话解决后才能合并,且禁止 force push;`v*` tag 禁止删除/移动;外部 fork PR 需要维护者批准。
137
+ 总开关、强调色、平滑光标开关、置顶折叠和左侧栏顺序保存在本机浏览器存储中;关闭皮肤不会删除这些偏好。需要重置时,可在设置中改回默认,或清除该站点的本地存储。
197
138
 
198
139
  ---
199
140
 
200
- ## 兼容性与边界
141
+ ## 兼容性
201
142
 
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`,由部件是否存在推断),便于排查升级后的样式问题。
206
- - 深色模式跟随 Harness 的 `data-ds-dark-theme`;强调色通过重映射 `--dsw-alias-state-business-primary` 生效,会同时影响皮肤和原生按钮。
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、强调色和挂载行。
143
+ - 支持 DSH `0.2.2-rc.1`、`0.2.2-rc.2` 与 `0.2.2-rc.3`;更低版本不会加载。
144
+ - 如果 DSH 升级改变了关键界面结构,皮肤会自动停用并提示;更新 Islands UI 后刷新页面即可恢复。确认界面正常时,可在 **设置 → Islands UI** 临时重新启用。
145
+ - 深色模式跟随 DSH;强调色会同时作用于皮肤和原生按钮。
146
+ - 不建议同时启用多个主题/皮肤:它们会修改同一批界面配色和布局规则,后加载的会覆盖先加载的。
147
+ - Windows 使用原生标题栏;Linux 使用原生窗口装饰,不同桌面环境的表现可能有差异。
209
148
 
210
149
  ---
211
150
 
@@ -213,41 +152,36 @@ npm pack # 生成 dsh-islands-ui-<version>.tgz
213
152
 
214
153
  **安装后没有变化?**
215
154
 
216
- 先确认当前 profile 里插件是启用状态,并刷新页面(`⌘R` / `Ctrl+R`)。本地开发版还需要确认 `client.js` 已经重新构建;从 npm 安装则检查 `npm view dsh-islands-ui version` 与已安装版本是否一致。DSH 版本低于 `0.2.2-rc.1` 时不会加载。
155
+ 先确认当前 DSH 配置(profile)中插件已启用,并刷新页面(`⌘R` / `Ctrl+R`)。如果 DSH 版本低于 `0.2.2-rc.1`,请先升级 DSH;也可以到 **设置 → Islands UI** 查看皮肤状态。
217
156
 
218
157
  **会修改我的会话、设置或插件数据吗?**
219
158
 
220
- 不会。皮肤只注入样式并注册浏览器端插槽;左侧栏固定、置顶聚合、定位和强调色都存在 `localStorage` 里,不写会话或 profile 数据。
159
+ 不会。皮肤只重绘界面;总开关、强调色、平滑光标开关、置顶折叠和左侧栏顺序保存在本机浏览器存储中。
221
160
 
222
161
  **怎么彻底恢复默认外观?**
223
162
 
224
- 设置 → Islands UI 关闭总开关即可立即恢复。需要连偏好一起清空时,删除 `dsh-islands-ui:*` 这几个 `localStorage` key(见[状态存储](#状态存储))。
163
+ 在 **设置 → Islands UI** 关闭总开关即可立即恢复。需要连偏好一起重置时,清除该站点的本地存储。
225
164
 
226
165
  **可以和别的主题/皮肤同时开吗?**
227
166
 
228
- 不建议。两个皮肤会同时改同一批 `--dsw-*` token 和布局,后加载的会覆盖前一个。dsh-market 的「主题」Tab 本身按单主题激活管理;如果你手动装了多个,保留一个即可。
167
+ 不建议。多个皮肤会同时修改同一批界面配色和布局规则,后加载的会覆盖前一个。
229
168
 
230
169
  **为什么某些界面还是旧样式?**
231
170
 
232
- 说明皮肤**检测到核心宿主契约缺失,已自动关闭**。DSH 升级可能改掉 `data-slot`、`data-phase` 等公开契约;半启用会变成双栏重叠,所以插件宁可保持默认外观:右下角会有提示,设置 → Islands UI 顶部有黄色说明条并列出缺失的契约。把 Islands UI 更新到适配当前 DSH 的版本即可恢复;确认界面正常也可以点「仍然启用」临时开启(下次启动重新检测)。
171
+ DSH 升级可能改变界面结构;皮肤检测到关键界面不匹配时会自动停用,避免出现双栏重叠。更新 Islands UI 到适配当前 DSH 的版本后刷新即可恢复;确认界面正常时,也可以在设置页点「仍然启用」临时开启(下次启动会重新检测)。
233
172
 
234
173
  **Windows / Linux 能用吗?**
235
174
 
236
- 已按原生标题栏(Windows 不渲染插件顶栏)、左侧栏、右侧工具原生位置和标题栏高度适配,但还没有在真实 Windows / Linux 机器上实测。遇到标题栏、拖拽区或窗口按钮问题,欢迎按 Issue 模板反馈。
237
-
238
- **会发到插件商店吗?**
239
-
240
- npm 发布后 DSHHub 会自动发现;dsh-market 的「主题」Tab 读取 awesome-dsh-plugin 目录,需要仓库满足收录条件后提交一条 `theme` 条目。具体步骤见 [docs/publishing.md](docs/publishing.md)。
175
+ Windows 已实测,使用原生标题栏布局;Linux 按原生窗口装饰适配,尚未实测。遇到标题栏、拖拽区或窗口按钮问题,欢迎反馈。
241
176
 
242
177
  ---
243
178
 
244
- ## 贡献与安全
179
+ ## 反馈
245
180
 
246
- - 开发、构建、提交约定和 PR 清单:[CONTRIBUTING.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/CONTRIBUTING.md)
247
- - Bug / 兼容性问题:[Issues](https://github.com/DawnCHL/dsh-islands-ui/issues)
248
- - 改进或新功能:欢迎直接开 PR
249
- - 特别欢迎 Windows / Linux 的实测反馈(截图 + 系统版本 + 窗口尺寸)
250
- - 安全漏洞:不要开公开 Issue,按 [SECURITY.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/SECURITY.md) 走私密报告
181
+ - 遇到 Bug 或兼容性问题:[提交 Issue](https://github.com/DawnCHL/dsh-islands-ui/issues)
182
+ - 反馈时请附上系统版本、DSH 版本、窗口尺寸和截图。
183
+ - 功能建议也欢迎在 Issues 中提出。
184
+ - 安全漏洞:请不要开公开 Issue,按 [SECURITY.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/SECURITY.md) 私密报告。
251
185
 
252
186
  ## License
253
187