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 +34 -0
- package/README.en.md +45 -100
- package/README.md +43 -105
- package/client.js +664 -177
- package/docs/host-contracts.md +51 -0
- package/package.json +7 -3
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="
|
|
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
|
|
@@ -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
|
|
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
|
|
|
@@ -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,
|
|
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 |
|
|
79
|
-
| Linux | 🟡
|
|
91
|
+
| Windows | ✅ Tested (native title bar layout) |
|
|
92
|
+
| Linux | 🟡 Native window decorations, not tested |
|
|
80
93
|
|
|
81
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
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
|
-
|
|
122
|
+
The skin only redraws the interface. It does not modify or upload your sessions, settings or plugin data.
|
|
151
123
|
|
|
152
|
-
|
|
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
|
-
-
|
|
183
|
-
-
|
|
184
|
-
-
|
|
185
|
-
-
|
|
186
|
-
-
|
|
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`).
|
|
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
|
|
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
|
|
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.
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
164
|
+
---
|
|
219
165
|
|
|
220
|
-
|
|
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
|
-
##
|
|
173
|
+
## License
|
|
225
174
|
|
|
226
|
-
|
|
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.
|
|
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
|
## 宣传图
|
|
@@ -73,11 +83,11 @@ dsh plugin --profile desktop remove dsh-islands-ui
|
|
|
73
83
|
| 🧭 | **常驻左侧栏** | 工作区与全部插件图标直接排列;首页按钮只作会话 / 工作区抽屉触发器、不占选中态(hover 浅色反馈、点击半透明涟漪);面板图标点击切换,按住拖动排序(浮动预览跟随鼠标),右键显示 / 隐藏图标 |
|
|
74
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
|
|
|
@@ -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
|
|
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 |
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
199
|
-
-
|
|
200
|
-
-
|
|
201
|
-
-
|
|
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
|
|
154
|
+
先确认当前 DSH 配置(profile)中插件已启用,并刷新页面(`⌘R` / `Ctrl+R`)。如果 DSH 版本低于 `0.2.2-rc.1`,请先升级 DSH;也可以到 **设置 → Islands UI** 查看皮肤状态。
|
|
212
155
|
|
|
213
156
|
**会修改我的会话、设置或插件数据吗?**
|
|
214
157
|
|
|
215
|
-
|
|
158
|
+
不会。皮肤只重绘界面;总开关、强调色、置顶折叠和左侧栏顺序保存在本机浏览器存储中。
|
|
216
159
|
|
|
217
160
|
**怎么彻底恢复默认外观?**
|
|
218
161
|
|
|
219
|
-
|
|
162
|
+
在 **设置 → Islands UI** 关闭总开关即可立即恢复。需要连偏好一起重置时,清除该站点的本地存储。
|
|
220
163
|
|
|
221
164
|
**可以和别的主题/皮肤同时开吗?**
|
|
222
165
|
|
|
223
|
-
|
|
166
|
+
不建议。多个皮肤会同时修改同一批界面配色和布局规则,后加载的会覆盖前一个。
|
|
224
167
|
|
|
225
168
|
**为什么某些界面还是旧样式?**
|
|
226
169
|
|
|
227
|
-
|
|
170
|
+
DSH 升级可能改变界面结构;皮肤检测到关键界面不匹配时会自动停用,避免出现双栏重叠。更新 Islands UI 到适配当前 DSH 的版本后刷新即可恢复;确认界面正常时,也可以在设置页点「仍然启用」临时开启(下次启动会重新检测)。
|
|
228
171
|
|
|
229
172
|
**Windows / Linux 能用吗?**
|
|
230
173
|
|
|
231
|
-
|
|
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
|
-
-
|
|
242
|
-
-
|
|
243
|
-
-
|
|
244
|
-
-
|
|
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
|
|