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 +37 -0
- package/README.en.md +46 -105
- package/README.md +44 -110
- package/client.js +757 -24
- package/docs/host-contracts.md +14 -1
- package/package.json +1 -1
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="
|
|
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
|
-
>
|
|
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
|
|
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
|
|
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
|
-
|
|
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 |
|
|
79
|
-
| Linux | 🟡
|
|
92
|
+
| Windows | ✅ Tested (native title bar layout) |
|
|
93
|
+
| Linux | 🟡 Native window decorations, not tested |
|
|
80
94
|
|
|
81
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
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
|
-
|
|
123
|
+
The skin only redraws the interface. It does not modify or upload your sessions, settings or plugin data.
|
|
156
124
|
|
|
157
|
-
|
|
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
|
-
-
|
|
188
|
-
-
|
|
189
|
-
-
|
|
190
|
-
-
|
|
191
|
-
-
|
|
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`).
|
|
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
|
|
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
|
|
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.
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
165
|
+
---
|
|
224
166
|
|
|
225
|
-
|
|
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
|
-
##
|
|
174
|
+
## License
|
|
230
175
|
|
|
231
|
-
|
|
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.
|
|
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
|
-
>
|
|
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
|
-
| 🌙 | **深色模式** |
|
|
86
|
+
| 🌙 | **深色模式** | 完整深色配色:近黑画布、深灰岛屿、白色透明交互层与深色阴影 |
|
|
77
87
|
| 🔄 | **桌面更新入口** | 设置齿轮上方常驻;发现新版本、下载、校验、安装与失败各有独立状态,加载态使用强调色 3×3 点阵动效 |
|
|
78
88
|
| ⌨️ | **快捷键** | `⌘B` 折叠工作区、`⌥⌘B` 右侧栏、`⌘,` 设置、`⌘⇧M` 模型弹层;按钮悬停显示当前键位 |
|
|
79
89
|
|
|
80
|
-
|
|
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 |
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
204
|
-
-
|
|
205
|
-
-
|
|
206
|
-
-
|
|
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
|
|
155
|
+
先确认当前 DSH 配置(profile)中插件已启用,并刷新页面(`⌘R` / `Ctrl+R`)。如果 DSH 版本低于 `0.2.2-rc.1`,请先升级 DSH;也可以到 **设置 → Islands UI** 查看皮肤状态。
|
|
217
156
|
|
|
218
157
|
**会修改我的会话、设置或插件数据吗?**
|
|
219
158
|
|
|
220
|
-
|
|
159
|
+
不会。皮肤只重绘界面;总开关、强调色、平滑光标开关、置顶折叠和左侧栏顺序保存在本机浏览器存储中。
|
|
221
160
|
|
|
222
161
|
**怎么彻底恢复默认外观?**
|
|
223
162
|
|
|
224
|
-
|
|
163
|
+
在 **设置 → Islands UI** 关闭总开关即可立即恢复。需要连偏好一起重置时,清除该站点的本地存储。
|
|
225
164
|
|
|
226
165
|
**可以和别的主题/皮肤同时开吗?**
|
|
227
166
|
|
|
228
|
-
|
|
167
|
+
不建议。多个皮肤会同时修改同一批界面配色和布局规则,后加载的会覆盖前一个。
|
|
229
168
|
|
|
230
169
|
**为什么某些界面还是旧样式?**
|
|
231
170
|
|
|
232
|
-
|
|
171
|
+
DSH 升级可能改变界面结构;皮肤检测到关键界面不匹配时会自动停用,避免出现双栏重叠。更新 Islands UI 到适配当前 DSH 的版本后刷新即可恢复;确认界面正常时,也可以在设置页点「仍然启用」临时开启(下次启动会重新检测)。
|
|
233
172
|
|
|
234
173
|
**Windows / Linux 能用吗?**
|
|
235
174
|
|
|
236
|
-
|
|
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
|
-
-
|
|
247
|
-
-
|
|
248
|
-
-
|
|
249
|
-
-
|
|
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
|
|