dsh-islands-ui 0.0.0-stage → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +36 -0
- package/LICENSE +21 -0
- package/README.en.md +242 -0
- package/README.md +261 -2
- package/assets/all-panels.png +0 -0
- package/assets/icon-180.png +0 -0
- package/assets/new_session.png +0 -0
- package/assets/pin-session.png +0 -0
- package/assets/settings.png +0 -0
- package/assets/workspace-closed.png +0 -0
- package/client.js +1975 -0
- package/cordis.patch.yml +6 -0
- package/icon.svg +7 -0
- package/index.js +9 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +104 -4
- package/screenshots.json +7 -0
- package/skin.json +11 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 1.0.1 — 2026-11-12
|
|
4
|
+
|
|
5
|
+
### 兼容性
|
|
6
|
+
|
|
7
|
+
- 启动时校验 DSH 界面锚点(`.PIRFFq_frame`、`.PIRFFq_centerCol`、`.kB3qhq_root`)。不匹配时不再"半启用"皮肤:保持 DSH 默认外观,只注册设置页,避免双栏重叠与悬浮控件遮挡。
|
|
8
|
+
- 不匹配时右下角弹出提示,5 秒自动关闭,可手动关闭,点击直接跳到设置 → Islands UI;设置页顶部常驻黄色说明条,列出缺失的锚点,并提供会话级「仍然启用」逃生开关。
|
|
9
|
+
- `shortcuts.observeFixedInput` 增加能力判断,缺失时不再中断整个 `apply()`(此前会导致设置页注册缺失)。
|
|
10
|
+
|
|
11
|
+
## 1.0.0 — 2026-11-12
|
|
12
|
+
|
|
13
|
+
首个公开发布版本。
|
|
14
|
+
|
|
15
|
+
### 界面
|
|
16
|
+
|
|
17
|
+
- 浮岛式布局:画布、主会话、工作区、右侧栏和底部面板各自成岛,统一 5px 间隙与 1px 发丝描边。
|
|
18
|
+
- 常驻左侧图标栏:工作区、自动化任务、插件、已固定插件与更多插件;右键或「…」打开固定菜单。
|
|
19
|
+
- 置顶聚合:置顶会话在「新会话」与「工作区」之间聚合展示,支持定位、取消置顶和折叠分类。
|
|
20
|
+
- 独立设置页:总开关、强调色预设、自定义取色与跟随主题。
|
|
21
|
+
- 完整深色 token;macOS、Windows 自定义顶栏和 Linux 原生窗口装饰适配。
|
|
22
|
+
- 快捷键沿用 DSH 绑定系统:`⌘B`、`⌥⌘B`、`⌘,`、`⌘⇧M`,按钮悬停显示当前键位。
|
|
23
|
+
- 窄屏(<768px)保留顶栏与常驻左侧栏,工作区改为 home 按钮打开的抽屉,恢复 5px 边距、圆角与遮罩层级;宽窄切换不再出现空白抽屉。
|
|
24
|
+
- 修复工作区折叠后打开右侧栏不可见的问题,按右侧面板偏好宽度设置网格轨道;resize 触发区回到画布间隙,底部面板不再裁剪拖拽条。
|
|
25
|
+
- 统一窄屏与 Windows 下顶栏、左侧栏、右侧栏开关的层级和标题栏偏移。
|
|
26
|
+
|
|
27
|
+
### 发布
|
|
28
|
+
|
|
29
|
+
- 包名改为 `dsh-islands-ui`,可直接通过 `dsh plugin add` 安装。
|
|
30
|
+
- 补齐 `dsh.bundle` / `dsh.client` / `dsh.compatibility` / `engines` 元数据,`files`、`exports`、`publishConfig` 面向 npm 发布。
|
|
31
|
+
- 新增 `skin.json`,供主题管理器识别皮肤 id、强调色与挂载行。
|
|
32
|
+
- 新增 MIT `LICENSE`、英文 README、`screenshots.json` 校验和发布前 `npm run check`。
|
|
33
|
+
- 新增 awesome-dsh-plugin 收录模板与 npm / DSHHub / dsh-market 发布说明。
|
|
34
|
+
- README 补充安装、常见问题、仓库配置、贡献与安全说明;新增英文 FAQ。
|
|
35
|
+
- 新增 GitHub Actions CI / Publish 工作流、Issue / PR 模板、`CONTRIBUTING.md`、`SECURITY.md`、`.editorconfig`、`.gitattributes` 和 `.nvmrc`。
|
|
36
|
+
- 启用 `main` 分支保护、`v*` tag 保护、外部 fork PR 审批和 Dependabot(GitHub Actions)。
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 DawnCHL
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.en.md
ADDED
|
@@ -0,0 +1,242 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
<img src="assets/icon-180.png" width="86" height="86" alt="Islands UI" />
|
|
3
|
+
<h1>Islands UI</h1>
|
|
4
|
+
<p><strong>A floating-island interface skin for DeepSeek Harness</strong></p>
|
|
5
|
+
<p>Rounded islands · persistent rail · pinned-session shelf · adjustable accent</p>
|
|
6
|
+
<p>
|
|
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://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
|
+
<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" />
|
|
12
|
+
</p>
|
|
13
|
+
</div>
|
|
14
|
+
|
|
15
|
+
<p align="center">
|
|
16
|
+
<img src="assets/all-panels.png" alt="Islands UI: rail, conversation, right sidebar and bottom panel" width="100%" />
|
|
17
|
+
</p>
|
|
18
|
+
|
|
19
|
+
Islands UI reorganizes the Harness three-column shell into a set of rounded islands floating on a solid canvas: a persistent icon rail, a separate workspace list, the conversation island, a right workbench and a bottom panel, separated by 5px canvas gaps and hairline borders. It does not touch sessions, settings or plugin logic — it only redraws the interface.
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Install
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
# Desktop profile (the default app profile)
|
|
27
|
+
dsh plugin --profile desktop add dsh-islands-ui
|
|
28
|
+
|
|
29
|
+
# Or the web profile used by a browser/remote setup
|
|
30
|
+
dsh plugin --profile web add dsh-islands-ui
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
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
|
+
> Requires DeepSeek Harness `0.2.2-rc.1` or newer within the `0.2.x` line. The package declares `dsh.bundle` + `dsh.client`, so `dsh plugin add` installs and mounts it without editing the profile by hand.
|
|
36
|
+
|
|
37
|
+
### Uninstall
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
dsh plugin --profile desktop remove dsh-islands-ui
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## What it changes
|
|
46
|
+
|
|
47
|
+
| | Feature | Details |
|
|
48
|
+
| :---: | --- | --- |
|
|
49
|
+
| 🏝 | **Floating islands** | Canvas, conversation, workspace, right sidebar and bottom panel become separate rounded surfaces; flat, no drop shadows, separated by color and a 1px hairline |
|
|
50
|
+
| 🧭 | **Persistent rail** | Workspace / automation / plugins / pinned plugins / more; right-click or “…” opens the plugin pin menu |
|
|
51
|
+
| ⚙️ | **Settings page** | Settings → Islands UI: on/off, accent presets, custom color and follow-theme |
|
|
52
|
+
| 📌 | **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 |
|
|
54
|
+
| ⌨️ | **Shortcuts** | `⌘B`, `⌥⌘B`, `⌘,`, `⌘⇧M`; buttons show the current binding on hover |
|
|
55
|
+
|
|
56
|
+
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.
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## Design language
|
|
61
|
+
|
|
62
|
+
| Layer | Rule |
|
|
63
|
+
| --- | --- |
|
|
64
|
+
| Canvas | Solid `#f7f7f7` (dark `#0f1012`), opaque, no blur |
|
|
65
|
+
| Islands | White / dark-gray surfaces, 16–20px radius, 1px hairline, no shadows |
|
|
66
|
+
| Spacing | 5px between every island, including the bottom panel |
|
|
67
|
+
| Top bar | 40px window strip; macOS clears the traffic lights, Windows/Linux starts at 8px below the native title bar |
|
|
68
|
+
| Accent | Brand blue by default; purple / green / orange / pink / red presets or any custom color |
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## Platform support
|
|
73
|
+
|
|
74
|
+
| Platform | Status |
|
|
75
|
+
| --- | --- |
|
|
76
|
+
| macOS | ✅ Tested |
|
|
77
|
+
| Windows | 🟡 Custom top bar, rail, settings gear, right-sidebar toggle and model picker adapted; **not tested on a physical Windows machine** |
|
|
78
|
+
| Linux | 🟡 Uses the same top bar and rail; **not tested** |
|
|
79
|
+
|
|
80
|
+
On Windows the native title bar stays in place and the custom strip sits below it; `--dsh-windows-titlebar-height` is respected. Linux follows native window decorations, which vary by desktop environment.
|
|
81
|
+
|
|
82
|
+
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.
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## Screenshots
|
|
87
|
+
|
|
88
|
+
| New session | Workspace collapsed |
|
|
89
|
+
| :---: | :---: |
|
|
90
|
+
|  |  |
|
|
91
|
+
| **Pinned and reveal** | **Settings · Islands UI** |
|
|
92
|
+
|  |  |
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## State
|
|
97
|
+
|
|
98
|
+
Stored in `localStorage`; clear these keys to reset:
|
|
99
|
+
|
|
100
|
+
| Key | Purpose |
|
|
101
|
+
| --- | --- |
|
|
102
|
+
| `dsh-islands-ui:enabled` | `1` / `0`, master switch |
|
|
103
|
+
| `dsh-islands-ui:accent` | Custom accent color; absent means follow theme |
|
|
104
|
+
| `dsh-islands-ui:pinned-collapsed` | Whether the pinned group is collapsed |
|
|
105
|
+
| `dsh-islands-ui:rail-pins` | Extra plugin ids pinned to the left rail |
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## Development
|
|
110
|
+
|
|
111
|
+
```text
|
|
112
|
+
src/
|
|
113
|
+
00-tokens.css design tokens + --dsw-* aliases (single source of truth)
|
|
114
|
+
10-shell.css three-column shell → canvas + islands
|
|
115
|
+
15-topbar.css window top bar
|
|
116
|
+
16-rail.css left icon rail, plugin pin menu, settings gear
|
|
117
|
+
20-sidebar.css workspace island, pinned shelf, session row states
|
|
118
|
+
30-conversation.css conversation page, composer, top tool group
|
|
119
|
+
40-settings.css settings dialog and section shell
|
|
120
|
+
45-model-picker.css model / reasoning popover
|
|
121
|
+
50-components.css preference rows, switches, accent picker
|
|
122
|
+
client.template.js browser entry (React components + slot registrations)
|
|
123
|
+
build.mjs inline src/*.css into client.js
|
|
124
|
+
client.js built, self-contained artifact
|
|
125
|
+
scripts/check-package.mjs pre-publish packaging checks
|
|
126
|
+
skin.json theme-manager manifest
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
```bash
|
|
130
|
+
npm run build # regenerate client.js after editing CSS or the template
|
|
131
|
+
npm run check # verify the build is current and the package is publishable
|
|
132
|
+
npm run pack:check # npm pack --dry-run
|
|
133
|
+
npm pack # produce dsh-islands-ui-<version>.tgz
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
The module loader cannot read package files at runtime, so `client.js` must contain the full stylesheet. Always commit the rebuilt artifact.
|
|
137
|
+
|
|
138
|
+
### Package layout
|
|
139
|
+
|
|
140
|
+
| Path | Purpose |
|
|
141
|
+
| --- | --- |
|
|
142
|
+
| `index.js` | Host half; the skin has no host behavior, so this only keeps the bundle a valid profile row |
|
|
143
|
+
| `client.js` | Browser half: stylesheet injection, rail, pinned shelf, settings page and model picker |
|
|
144
|
+
| `cordis.patch.yml` | One `insert` row named `dsh-islands-ui` |
|
|
145
|
+
| `skin.json` | id, display name, accent, body attribute and wiring row for theme managers |
|
|
146
|
+
| `screenshots.json` | 1–8 repository-relative screenshots read by storefronts |
|
|
147
|
+
| `assets/` | Store icon and README screenshots |
|
|
148
|
+
|
|
149
|
+
### Repository configuration
|
|
150
|
+
|
|
151
|
+
| File | Purpose |
|
|
152
|
+
| --- | --- |
|
|
153
|
+
| `.github/workflows/ci.yml` | Runs `npm run check` and `npm pack --dry-run` on PRs / main across Node 20, 22 and 24 |
|
|
154
|
+
| `.github/workflows/publish.yml` | Publishes on a `v*` tag or manual dispatch; the tag must match `package.json`, and `NPM_TOKEN` is required |
|
|
155
|
+
| `.github/ISSUE_TEMPLATE/` | Bug and feature forms that require the DSH version, platform and reproduction steps |
|
|
156
|
+
| `.github/PULL_REQUEST_TEMPLATE.md` | Build, wide/narrow layout, dark mode and local-path checks |
|
|
157
|
+
| `.github/dependabot.yml` | Weekly GitHub Actions version updates |
|
|
158
|
+
| `.editorconfig` / `.gitattributes` | UTF-8, LF, 2-space indentation; images and tarballs are binary |
|
|
159
|
+
| `.nvmrc` | Node 24 for local development |
|
|
160
|
+
| `CONTRIBUTING.md` | Development, build, commit conventions and PR checklist |
|
|
161
|
+
| `SECURITY.md` | Supported versions and the private vulnerability-reporting flow |
|
|
162
|
+
| `scripts/check-package.mjs` | Pre-publish validation of the manifest, row name, client build, screenshots and `files[]` |
|
|
163
|
+
|
|
164
|
+
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.
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## Publishing
|
|
169
|
+
|
|
170
|
+
See [docs/publishing.md](docs/publishing.md) for the full checklist. Short version:
|
|
171
|
+
|
|
172
|
+
```bash
|
|
173
|
+
npm login
|
|
174
|
+
npm run check
|
|
175
|
+
npm publish --access public
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
The package targets `https://registry.npmjs.org/` explicitly in `publishConfig`, so a local npm mirror (e.g. `registry.npmmirror.com`) cannot swallow the publish.
|
|
179
|
+
|
|
180
|
+
Store coverage:
|
|
181
|
+
|
|
182
|
+
- **npm** — canonical install source; [dsh-islands-ui](https://www.npmjs.com/package/dsh-islands-ui). Confirm with `npm view dsh-islands-ui version`
|
|
183
|
+
- **DSHHub** — discovers npm packages with a valid `dsh.bundle` manifest automatically; claim the listing with the GitHub App
|
|
184
|
+
- **awesome-dsh-plugin / dsh-market** — submit the ready-to-copy `theme` entry in [docs/awesome-dsh-plugin.yml](docs/awesome-dsh-plugin.yml)
|
|
185
|
+
- **dsh-market Themes tab** — follows the `theme` category from awesome-dsh-plugin
|
|
186
|
+
|
|
187
|
+
> awesome-dsh-plugin requires a repository at least **1 day old**, the `dsh-plugin` topic, and a root `package.json` with `dsh.bundle`. Publish to npm first, then submit the `theme` entry once the repository age requirement is met.
|
|
188
|
+
|
|
189
|
+
---
|
|
190
|
+
|
|
191
|
+
## Compatibility
|
|
192
|
+
|
|
193
|
+
- The skin is a pure client style layer and does not replace session, settings or plugin data or behavior.
|
|
194
|
+
- Selectors depend on the current Harness build's CSS Module hashes (e.g. `PIRFFq_*`, `kB3qhq_*`, `JoiKIa_*`, `_77Pn0W_*`) and a few `data-*` hooks. A Harness upgrade or rebuild can change those class names and require a matching CSS update.
|
|
195
|
+
- On startup the plugin verifies three layout anchors (`.PIRFFq_frame`, `.PIRFFq_centerCol`, `.kB3qhq_root`). If any is missing the skin stays **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".
|
|
196
|
+
- Dark mode follows `data-ds-dark-theme`; the accent remaps `--dsw-alias-state-business-primary`, so it affects both the skin and native buttons.
|
|
197
|
+
- Windows uses `data-windows-titlebar` and `--dsh-windows-titlebar-height`; Linux currently follows native window decorations.
|
|
198
|
+
- `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 build-to-build drift inside the line is caught by the startup anchor check. `skin.json` gives theme managers the id, accent and mount row.
|
|
199
|
+
|
|
200
|
+
---
|
|
201
|
+
|
|
202
|
+
## FAQ
|
|
203
|
+
|
|
204
|
+
**Nothing changed after install.**
|
|
205
|
+
|
|
206
|
+
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.
|
|
207
|
+
|
|
208
|
+
**Does it touch my sessions or settings?**
|
|
209
|
+
|
|
210
|
+
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.
|
|
211
|
+
|
|
212
|
+
**How do I fully reset the skin?**
|
|
213
|
+
|
|
214
|
+
Turn off **Settings → Islands UI**. To clear the saved preferences too, delete the `dsh-islands-ui:*` localStorage keys (see [State](#state)).
|
|
215
|
+
|
|
216
|
+
**Can I run it with another theme?**
|
|
217
|
+
|
|
218
|
+
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.
|
|
219
|
+
|
|
220
|
+
**Why do some surfaces keep the old look?**
|
|
221
|
+
|
|
222
|
+
Selectors depend on Harness CSS Module hashes. A DSH upgrade can rename them and disable individual rules. Update Islands UI, or open an issue with a screenshot and DSH version.
|
|
223
|
+
|
|
224
|
+
**Windows / Linux?**
|
|
225
|
+
|
|
226
|
+
The top bar, rail, right-panel toggle and title-bar height are adapted, but neither has been tested on a physical machine. Please report title-bar, drag-region or window-button issues using the issue template.
|
|
227
|
+
|
|
228
|
+
**Will it be in plugin stores?**
|
|
229
|
+
|
|
230
|
+
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).
|
|
231
|
+
|
|
232
|
+
---
|
|
233
|
+
|
|
234
|
+
## Contributing and security
|
|
235
|
+
|
|
236
|
+
- Development, build, commit conventions and PR checklist: [CONTRIBUTING.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/CONTRIBUTING.md)
|
|
237
|
+
- Bugs / compatibility: [Issues](https://github.com/DawnCHL/dsh-islands-ui/issues)
|
|
238
|
+
- Improvements: PRs welcome
|
|
239
|
+
- Windows / Linux test reports especially welcome (screenshot + OS version + window size)
|
|
240
|
+
- Security issues: do not open a public issue; follow [SECURITY.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/SECURITY.md)
|
|
241
|
+
|
|
242
|
+
<p align="center"><sub>Made for DeepSeek Harness · Islands UI</sub></p>
|
package/README.md
CHANGED
|
@@ -1,3 +1,262 @@
|
|
|
1
|
-
|
|
1
|
+
<div align="center">
|
|
2
|
+
<img src="icon.svg" width="76" height="76" alt="Islands UI" />
|
|
3
|
+
<h1>Islands UI</h1>
|
|
4
|
+
<p><strong>为 DeepSeek Harness 打造的浮岛式界面皮肤</strong></p>
|
|
5
|
+
<p>圆角岛屿 · 常驻左侧栏 · 置顶聚合 · 可调强调色</p>
|
|
6
|
+
<p>
|
|
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>
|
|
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
|
+
<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.1-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" />
|
|
15
|
+
</p>
|
|
16
|
+
</div>
|
|
2
17
|
|
|
3
|
-
|
|
18
|
+
<p align="center">
|
|
19
|
+
<img src="assets/all-panels.png" alt="Islands UI 主界面:左侧栏、会话区、右侧栏与底部面板" width="100%" />
|
|
20
|
+
</p>
|
|
21
|
+
|
|
22
|
+
Islands UI 把 Harness 的三栏界面重新组织成一组悬浮在纯色画布上的圆角岛屿:左侧常驻图标栏、独立的工作区列表、主会话区、右侧工作台和底部面板各自成块,用 5px 的画布间隙与发丝描边分层。它不修改 Harness 的会话、设置或插件逻辑,只重绘界面。
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## 安装
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
# 桌面端默认 profile
|
|
30
|
+
dsh plugin --profile desktop add dsh-islands-ui
|
|
31
|
+
|
|
32
|
+
# 浏览器 / 远程场景使用的 web profile
|
|
33
|
+
dsh plugin --profile web add dsh-islands-ui
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
安装后刷新页面(`⌘R` / `Ctrl+R`)。皮肤默认开启;可在 **设置 → Islands UI** 关闭,关闭后立即恢复 Harness 默认外观,偏好和强调色会保留。
|
|
37
|
+
|
|
38
|
+
> 适用于 DSH `0.2.2-rc.1` 及 `0.2.x` 后续版本。包内声明了完整的 `dsh.bundle` + `dsh.client` manifest,`dsh plugin add` 会自动写入 profile 的 bundle 栈,不需要手工改 `cordis.patch.yml`。
|
|
39
|
+
|
|
40
|
+
### 卸载
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
dsh plugin --profile desktop remove dsh-islands-ui
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## 界面预览
|
|
49
|
+
|
|
50
|
+
| 新会话 | 工作区折叠 |
|
|
51
|
+
| :---: | :---: |
|
|
52
|
+
|  |  |
|
|
53
|
+
| **置顶与定位** | **设置 · Islands UI** |
|
|
54
|
+
|  |  |
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## 功能
|
|
59
|
+
|
|
60
|
+
| | 功能 | 说明 |
|
|
61
|
+
| :---: | --- | --- |
|
|
62
|
+
| 🏝 | **浮岛布局** | 画布、主会话、工作区、右侧栏、底部面板各自独立;扁平无投影,以色块 + 1px 发丝线分隔 |
|
|
63
|
+
| 🧭 | **常驻左侧栏** | 工作区 / 自动化任务 / 插件 / 已固定插件 / 更多;右键或「…」打开插件固定菜单 |
|
|
64
|
+
| ⚙️ | **独立设置页** | 设置 → Islands UI:一键开关皮肤、强调色(预设 + 自定义 + 跟随主题) |
|
|
65
|
+
| 📌 | **置顶聚合** | 置顶会话同时保留在原工作区,并聚合到「新会话」与「工作区」标题之间;分类可折叠 |
|
|
66
|
+
| 🌙 | **深色模式** | 完整深色 token:近黑画布、深灰岛屿、白色透明交互层与深色阴影 |
|
|
67
|
+
| ⌨️ | **快捷键** | `⌘B` 折叠工作区、`⌥⌘B` 右侧栏、`⌘,` 设置、`⌘⇧M` 模型弹层;按钮悬停显示当前键位 |
|
|
68
|
+
|
|
69
|
+
皮肤是纯客户端样式层;左侧栏插件固定、置顶聚合、定位与设置页也都在浏览器端完成,不新增 host 工具、服务或会话数据。
|
|
70
|
+
|
|
71
|
+
### 设计语言
|
|
72
|
+
|
|
73
|
+
| 层级 | 规则 |
|
|
74
|
+
| --- | --- |
|
|
75
|
+
| 画布 | 纯色 `#f7f7f7`(深色 `#0f1012`),不透明、无毛玻璃 |
|
|
76
|
+
| 岛屿 | 白色 / 深灰表面,16–20px 圆角,1px 发丝描边,无投影 |
|
|
77
|
+
| 间距 | 所有岛屿统一 5px 间隙,左右、顶部、底部、底部面板四周一致 |
|
|
78
|
+
| 顶部栏 | 40px 窗口栏,承载工作区折叠、对话工具组和右侧栏开关;macOS 避开红绿灯,Windows/Linux 从 8px 开始 |
|
|
79
|
+
| 强调色 | 默认品牌蓝,可改为紫 / 绿 / 橙 / 粉 / 红或任意取色 |
|
|
80
|
+
|
|
81
|
+
### 常用快捷键
|
|
82
|
+
|
|
83
|
+
| 快捷键 | 功能 |
|
|
84
|
+
| --- | --- |
|
|
85
|
+
| `⌘B` / `Ctrl+B` | 折叠 / 展开工作区 |
|
|
86
|
+
| `⌥⌘B` / `Ctrl+Alt+B` | 打开 / 关闭右侧栏 |
|
|
87
|
+
| `⌘,` / `Ctrl+,` | 打开设置 |
|
|
88
|
+
| `⌘⇧M` / `Ctrl+Shift+M` | 打开模型 / 推理弹层 |
|
|
89
|
+
| `⌘N` / `Ctrl+N` | 新会话 |
|
|
90
|
+
| `⌘K` / `Ctrl+K` | 搜索会话 |
|
|
91
|
+
| `⌘/` / `Ctrl+/` | 快捷键向导 |
|
|
92
|
+
|
|
93
|
+
> 快捷键沿用 Harness 的绑定系统,可在「设置 → 快捷键」里重新绑定;悬停对应按钮会显示当前键位。
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## 平台支持
|
|
98
|
+
|
|
99
|
+
| 平台 | 状态 |
|
|
100
|
+
| --- | --- |
|
|
101
|
+
| macOS | ✅ 已实测(开发与日常使用环境) |
|
|
102
|
+
| Windows | 🟡 已适配自定义顶栏、左侧栏、设置齿轮、右侧开关、置顶聚合与模型弹层,并在原生标题栏下方预留高度;**尚未在真实 Windows 电脑上实测** |
|
|
103
|
+
| Linux | 🟡 使用同一套顶栏与左侧栏;**尚未实测** |
|
|
104
|
+
|
|
105
|
+
Windows 下保留 Harness 原生标题栏,自定义顶栏显示在它下方;左侧栏、设置齿轮、右侧栏开关和快捷键均已启用。Linux 按原生窗口装饰处理,不同桌面环境可能有差异。
|
|
106
|
+
|
|
107
|
+
> **反馈**:如果你在 Windows 或 Linux 上遇到标题栏高度、拖拽区域、窗口按钮重叠、布局错位或快捷键问题,欢迎提交 [Issue](https://github.com/DawnCHL/dsh-islands-ui/issues) 或 PR,附系统版本、窗口尺寸和截图即可。
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## 状态存储
|
|
112
|
+
|
|
113
|
+
| `localStorage` key | 作用 |
|
|
114
|
+
| --- | --- |
|
|
115
|
+
| `dsh-islands-ui:enabled` | `1` / `0`,总开关 |
|
|
116
|
+
| `dsh-islands-ui:accent` | 自定义强调色(不存在表示跟随主题) |
|
|
117
|
+
| `dsh-islands-ui:pinned-collapsed` | 置顶分类是否折叠 |
|
|
118
|
+
| `dsh-islands-ui:rail-pins` | 左侧栏额外固定的插件 id 列表 |
|
|
119
|
+
|
|
120
|
+
清除这些 key 即可恢复默认。
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## 开发
|
|
125
|
+
|
|
126
|
+
```text
|
|
127
|
+
src/
|
|
128
|
+
00-tokens.css 设计变量 + 重定向 Harness 的 --dsw-* 别名(唯一真源)
|
|
129
|
+
10-shell.css 三栏框架 → 画布 + 岛屿
|
|
130
|
+
15-topbar.css 窗口顶部栏
|
|
131
|
+
16-rail.css 左侧图标栏、插件固定菜单、设置齿轮
|
|
132
|
+
20-sidebar.css 工作区岛屿、置顶聚合、会话行状态
|
|
133
|
+
30-conversation.css 会话页、输入框、顶部工具组
|
|
134
|
+
40-settings.css 设置弹窗、设置页外壳
|
|
135
|
+
45-model-picker.css 模型/推理两级弹层
|
|
136
|
+
50-components.css 偏好行、开关、强调色选择器等共享组件
|
|
137
|
+
client.template.js 浏览器端入口模板(React 组件 + 插槽注册)
|
|
138
|
+
build.mjs 把 src/*.css 内联进 client.js
|
|
139
|
+
client.js 构建产物(自包含,运行时无法读文件)
|
|
140
|
+
scripts/check-package.mjs 发布前包内容校验
|
|
141
|
+
skin.json 主题管理器清单
|
|
142
|
+
docs/ 发布与商店收录说明
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
```bash
|
|
146
|
+
npm run build # 修改 src/*.css 或模板后重新生成 client.js
|
|
147
|
+
npm run check # 校验 client.js 是否为最新,并检查 npm 包是否可发布
|
|
148
|
+
npm run pack:check # npm pack --dry-run
|
|
149
|
+
npm pack # 生成 dsh-islands-ui-<version>.tgz
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
开发时直接在 Harness 中刷新(`⌘R`)即可;`client.js` 是自包含的浏览器模块,样式在加载时注入。模块加载器运行时无法读取包内文件,因此修改 CSS 后必须重新构建并提交 `client.js`。
|
|
153
|
+
|
|
154
|
+
### 包内容
|
|
155
|
+
|
|
156
|
+
| 路径 | 作用 |
|
|
157
|
+
| --- | --- |
|
|
158
|
+
| `index.js` | host 半边;皮肤没有 host 行为,仅用于保持合法的 profile row |
|
|
159
|
+
| `client.js` | 浏览器半边:样式注入、左侧栏、置顶聚合、设置页与模型弹层 |
|
|
160
|
+
| `cordis.patch.yml` | 一条 `insert`,row name 为 `dsh-islands-ui` |
|
|
161
|
+
| `skin.json` | 给主题管理器的 id、名称、强调色、body 属性与挂载行 |
|
|
162
|
+
| `screenshots.json` | 商店读取的 1–8 张仓库相对路径截图 |
|
|
163
|
+
| `assets/` | 商店图标与 README 截图 |
|
|
164
|
+
|
|
165
|
+
### 仓库配置
|
|
166
|
+
|
|
167
|
+
| 文件 | 作用 |
|
|
168
|
+
| --- | --- |
|
|
169
|
+
| `.github/workflows/ci.yml` | PR / main 上跑 `npm run check` 和 `npm pack --dry-run`,Node 20 / 22 / 24 矩阵 |
|
|
170
|
+
| `.github/workflows/publish.yml` | 推送 `v*` tag 或手动触发发布;tag 必须与 `package.json` 版本一致,使用 `NPM_TOKEN` secret |
|
|
171
|
+
| `.github/ISSUE_TEMPLATE/` | Bug / Feature 表单,强制填写 DSH 版本、平台和复现步骤 |
|
|
172
|
+
| `.github/PULL_REQUEST_TEMPLATE.md` | PR 自检:构建、宽窄屏、深色模式、无本地路径 |
|
|
173
|
+
| `.github/dependabot.yml` | 每周检查 GitHub Actions 版本更新 |
|
|
174
|
+
| `.editorconfig` / `.gitattributes` | 统一 UTF-8、LF、2 空格;图片和 tarball 按二进制处理 |
|
|
175
|
+
| `.nvmrc` | 本地开发使用 Node 24 |
|
|
176
|
+
| `CONTRIBUTING.md` | 开发、构建、提交约定和 PR 清单 |
|
|
177
|
+
| `SECURITY.md` | 支持版本与私密漏洞报告流程 |
|
|
178
|
+
| `scripts/check-package.mjs` | 包里 manifest、row name、client 构建、截图和 `files[]` 的发布前校验 |
|
|
179
|
+
|
|
180
|
+
仓库设置:`main` 需要 PR、CI 的 `check (Node 20/22/24)` 通过和对话解决后才能合并,且禁止 force push;`v*` tag 禁止删除/移动;外部 fork PR 需要维护者批准。
|
|
181
|
+
|
|
182
|
+
---
|
|
183
|
+
|
|
184
|
+
## 发布与商店
|
|
185
|
+
|
|
186
|
+
完整步骤见 [docs/publishing.md](docs/publishing.md)。最短路径:
|
|
187
|
+
|
|
188
|
+
```bash
|
|
189
|
+
npm login
|
|
190
|
+
npm run check
|
|
191
|
+
npm publish --access public
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
`publishConfig.registry` 已显式指向 `https://registry.npmjs.org/`,避免本机 npm 镜像(如 `registry.npmmirror.com`)把发布吞掉。
|
|
195
|
+
|
|
196
|
+
商店覆盖:
|
|
197
|
+
|
|
198
|
+
- **npm** — 安装源;包名 [`dsh-islands-ui`](https://www.npmjs.com/package/dsh-islands-ui),用 `npm view dsh-islands-ui version` 确认线上版本
|
|
199
|
+
- **DSHHub** — 自动发现带合法 `dsh.bundle` manifest 的 npm 包,发布后无需额外操作;可在 Hub 用 GitHub App 认领条目
|
|
200
|
+
- **awesome-dsh-plugin / dsh-market** — 用 [docs/awesome-dsh-plugin.yml](docs/awesome-dsh-plugin.yml) 里的 `theme` 条目提 PR;合并后 dsh-market 的「主题」Tab 会自动收录
|
|
201
|
+
- **dsh-market** — 直接读取 awesome-dsh-plugin 的 `theme` 分类
|
|
202
|
+
|
|
203
|
+
> awesome-dsh-plugin 要求仓库创建满 **1 天**、带 `dsh-plugin` topic,并且根 `package.json` 声明 `dsh.bundle`。先完成 npm 发布,满足仓库年龄要求后再提交 `theme` 条目,避免被 CI 打回。
|
|
204
|
+
|
|
205
|
+
---
|
|
206
|
+
|
|
207
|
+
## 兼容性与边界
|
|
208
|
+
|
|
209
|
+
- 皮肤是**纯客户端样式层**,不替换会话、设置或插件的数据与交互;左侧栏插件固定、置顶聚合、定位等额外能力也只在客户端完成。
|
|
210
|
+
- 选择器依赖 Harness 当前构建的 CSS Module 哈希类名(如 `PIRFFq_*`、`kB3qhq_*`、`JoiKIa_*`、`_77Pn0W_*`)与少量 `data-*` 挂点;**Harness 升级或重新构建后类名可能变化,需要同步更新对应 CSS**。
|
|
211
|
+
- 启动时会检测三个界面锚点(`.PIRFFq_frame`、`.PIRFFq_centerCol`、`.kB3qhq_root`):缺失就**不启用皮肤**,DSH 保持默认外观,右下角弹出说明(5 秒自动关闭、可手动关闭、点击进入插件设置),设置 → Islands UI 里也常驻一条黄色说明,并提供会话级的「仍然启用」。
|
|
212
|
+
- 深色模式跟随 Harness 的 `data-ds-dark-theme`;强调色通过重映射 `--dsw-alias-state-business-primary` 生效,会同时影响皮肤和原生按钮。
|
|
213
|
+
- Windows 使用 `data-windows-titlebar` 与 `--dsh-windows-titlebar-height` 适配原生标题栏;Linux 暂无专用标题栏变量,按原生窗口装饰处理。
|
|
214
|
+
- `dsh.engines.dsh` / `engines.dsh` 把兼容线钉在 `>=0.2.2-rc.1 <0.3.0-0`,越界时插件管理器会拒绝安装或升级;同一兼容线内部的构建差异由启动时的锚点自检兜底。`skin.json` 为主题管理器提供 id、强调色和挂载行。
|
|
215
|
+
|
|
216
|
+
---
|
|
217
|
+
|
|
218
|
+
## 常见问题
|
|
219
|
+
|
|
220
|
+
**安装后没有变化?**
|
|
221
|
+
|
|
222
|
+
先确认当前 profile 里插件是启用状态,并刷新页面(`⌘R` / `Ctrl+R`)。本地开发版还需要确认 `client.js` 已经重新构建;从 npm 安装则检查 `npm view dsh-islands-ui version` 与已安装版本是否一致。DSH 版本低于 `0.2.2-rc.1` 时不会加载。
|
|
223
|
+
|
|
224
|
+
**会修改我的会话、设置或插件数据吗?**
|
|
225
|
+
|
|
226
|
+
不会。皮肤只注入样式并注册浏览器端插槽;左侧栏固定、置顶聚合、定位和强调色都存在 `localStorage` 里,不写会话或 profile 数据。
|
|
227
|
+
|
|
228
|
+
**怎么彻底恢复默认外观?**
|
|
229
|
+
|
|
230
|
+
设置 → Islands UI 关闭总开关即可立即恢复。需要连偏好一起清空时,删除 `dsh-islands-ui:*` 这几个 `localStorage` key(见[状态存储](#状态存储))。
|
|
231
|
+
|
|
232
|
+
**可以和别的主题/皮肤同时开吗?**
|
|
233
|
+
|
|
234
|
+
不建议。两个皮肤会同时改同一批 `--dsw-*` token 和布局,后加载的会覆盖前一个。dsh-market 的「主题」Tab 本身按单主题激活管理;如果你手动装了多个,保留一个即可。
|
|
235
|
+
|
|
236
|
+
**为什么某些界面还是旧样式?**
|
|
237
|
+
|
|
238
|
+
说明皮肤**检测到界面结构不匹配,已自动关闭**。DSH 升级可能改掉皮肤依赖的 CSS Module 哈希类名,半启用会变成双栏重叠,所以插件宁可保持默认外观:右下角会有提示,设置 → Islands UI 顶部有黄色说明条并列出缺失的锚点。把 Islands UI 更新到适配当前 DSH 的版本即可恢复;确认界面正常也可以点「仍然启用」临时开启(下次启动重新检测)。
|
|
239
|
+
|
|
240
|
+
**Windows / Linux 能用吗?**
|
|
241
|
+
|
|
242
|
+
已按自定义顶栏、左侧栏、右侧栏开关和标题栏高度适配,但还没有在真实 Windows / Linux 机器上实测。遇到标题栏、拖拽区或窗口按钮问题,欢迎按 Issue 模板反馈。
|
|
243
|
+
|
|
244
|
+
**会发到插件商店吗?**
|
|
245
|
+
|
|
246
|
+
npm 发布后 DSHHub 会自动发现;dsh-market 的「主题」Tab 读取 awesome-dsh-plugin 目录,需要仓库满足收录条件后提交一条 `theme` 条目。具体步骤见 [docs/publishing.md](docs/publishing.md)。
|
|
247
|
+
|
|
248
|
+
---
|
|
249
|
+
|
|
250
|
+
## 贡献与安全
|
|
251
|
+
|
|
252
|
+
- 开发、构建、提交约定和 PR 清单:[CONTRIBUTING.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/CONTRIBUTING.md)
|
|
253
|
+
- Bug / 兼容性问题:[Issues](https://github.com/DawnCHL/dsh-islands-ui/issues)
|
|
254
|
+
- 改进或新功能:欢迎直接开 PR
|
|
255
|
+
- 特别欢迎 Windows / Linux 的实测反馈(截图 + 系统版本 + 窗口尺寸)
|
|
256
|
+
- 安全漏洞:不要开公开 Issue,按 [SECURITY.md](https://github.com/DawnCHL/dsh-islands-ui/blob/main/SECURITY.md) 走私密报告
|
|
257
|
+
|
|
258
|
+
## License
|
|
259
|
+
|
|
260
|
+
[MIT](LICENSE) © DawnCHL
|
|
261
|
+
|
|
262
|
+
<p align="center"><sub>Made for DeepSeek Harness · Islands UI</sub></p>
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|