dsh-islands-ui 1.0.3 → 1.1.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,38 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.1.0 — 2026-11-13
4
+
5
+ ### 界面
6
+
7
+ - 左侧栏不再把其他插件收进「…」弹层:所有 `sidebar.panellist` 面板图标直接排列在工作区按钮下方,点击即按面板默认行为切换(`layoutService.selectPanel`)。
8
+ - 图标支持按住拖动排序,顺序写入 `localStorage`;拖动超过 4px 才进入排序,普通点击仍只切换面板。图标较多时栏内可滚动,并在拖动到上下边缘时自动滚动。进入排序后源图标变淡,同时出现一个 36px、90% 不透明度、保持抓取偏移并跟随鼠标的浮层,松手即移除。
9
+ - 右键左侧栏或任一图标打开「左侧栏图标」菜单,勾选 / 取消勾选即可增删入口;隐藏的图标仍保留在菜单中,可随时恢复。旧版 `dsh-islands-ui:rail-pins` 的固定顺序会自动迁移到新的 `dsh-islands-ui:rail` 配置。
10
+ - 菜单副标题不再把 DSH 官方客户端 bundle 的内部 fiber 名 `WC` 直接显示出来,内置项改标为「DSH 内置」;匹配时忽略大小写,第三方插件仍显示其包名。
11
+ - 左侧栏首页(工作区)图标改为纯导航触发器:不再进入 `is-active`、不再设置 `aria-pressed`、不参与拖动样式;hover 使用标准浅色反馈,点击在按钮内绘制半透明的圆形涟漪(键盘触发时从中心扩散);全局面板图标仍按 `activePanelId` 高亮。
12
+ - 修复首页按钮在空闲状态被误标为拖动中:`dragId` 初始为 `null`,而房子的 id 也是 `null`,`dragId === id` 让房子从首帧起一直带 `is-dragging`(选中底色 + 45% 透明度)。拖动判断改为 `id !== null && dragId === id`,房子在空闲和拖动其他图标时都不再进入拖动样式。
13
+ - 移除左侧栏底部原有的「…」按钮与插件固定弹层。
14
+
15
+ ## 1.0.4 — 2026-11-12
16
+
17
+ ### 兼容性
18
+
19
+ - 客户端读取 `window.__DSH_BOOT__.release.version`,按 DSH 版本选择侧栏结构样式:新增 `scroll` 变体(`src/variants/scroll.css`),适配 0.2.2-rc.2 新增的 `.kB3qhq_scrollRegion` / `.kB3qhq_scrollArea` 包装层,修复工作区列表被挤进 48px 图标栏、工作区岛只剩空白卡片的问题。旧版 DSH 不会匹配变体选择器,仍走原样式。
20
+ - 自检升级为「版本选样式 + 结构交叉验证」:版本选中的方言与挂载后的 DOM 不一致时以 DOM 为准切换变体;两者都不匹配才停用皮肤并弹出提示,避免再次静默半启用。
21
+ - `panelEntryActive` 兼容 0.2.2-rc.2 的面板选中类名(`panelActive` 已移除)。
22
+ - 设置 → Islands UI 显示检测到的 DSH 版本与侧栏结构。
23
+
24
+ ### 界面
25
+
26
+ - 重写左下角桌面更新入口:隐藏原生「新版本」胶囊,改为设置齿轮上方的 36px 圆形按钮,展开与收起侧栏都可见。
27
+ - 更新状态直接订阅 `window.dshDesktop.updates`:发现新版本显示蓝色实心圆 + 下载箭头,就绪显示重启图标,失败显示半透明红底、红色描边、状态点与重试图标。
28
+ - 下载、校验、安装不再使用圆形底色,直接用皮肤强调色绘制 3×3 点阵动画(Column Flux / Smiley Spin / Core Echo),并支持 `prefers-reduced-motion` 静态回退。
29
+ - 更新入口按 DSH 版本动态读取展示数据:0.2.2-rc.2 新增的 `configurationError`(配置读取/格式/channel/清理失败)复用错误态与重试图标,旧版没有该字段时行为不变。
30
+ - 设置 → Islands UI 的「更新按钮状态」预览卡暂时隐藏;组件与样式保留,取消 `client.template.js` 中对应渲染行的注释即可恢复。
31
+
32
+ ### 文档
33
+
34
+ - 新增三张 3:4 宣传图(封面、亮暗主题、三步安装),中英文 README 各加一节展示;`screenshots.json` 改为这三张,商店预览同步更新,原有的界面截图仍保留在 README 的「界面预览」中。
35
+
3
36
  ## 1.0.3 — 2026-11-12
4
37
 
5
38
  ### 发布
package/README.en.md CHANGED
@@ -32,7 +32,7 @@ dsh plugin --profile web add dsh-islands-ui
32
32
 
33
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
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.
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
36
 
37
37
  ### Uninstall
38
38
 
@@ -47,10 +47,11 @@ dsh plugin --profile desktop remove dsh-islands-ui
47
47
  | | Feature | Details |
48
48
  | :---: | --- | --- |
49
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 |
50
+ | 🧭 | **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
51
  | ⚙️ | **Settings page** | Settings → Islands UI: on/off, accent presets, custom color and follow-theme |
52
52
  | 📌 | **Pinned shelf** | Pinned sessions stay in their workspace and are also aggregated between “New session” and “Workspace”; the group collapses |
53
53
  | 🌙 | **Dark mode** | Full dark token set: near-black canvas, dark islands, translucent interaction layers |
54
+ | 🔄 | **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 |
54
55
  | ⌨️ | **Shortcuts** | `⌘B`, `⌥⌘B`, `⌘,`, `⌘⇧M`; buttons show the current binding on hover |
55
56
 
56
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.
@@ -83,6 +84,16 @@ If you hit a title-bar, drag-region, window-button or layout issue, please open
83
84
 
84
85
  ---
85
86
 
87
+ ## Key visuals
88
+
89
+ <p align="center">
90
+ <img src="assets/promo-cover.png" width="32%" alt="Islands UI key visual: a more modern interface, more complete interactions" />
91
+ <img src="assets/promo-themes.png" width="32%" alt="Islands UI key visual: light and dark themes" />
92
+ <img src="assets/promo-install.png" width="32%" alt="Islands UI key visual: install in three steps" />
93
+ </p>
94
+
95
+ ---
96
+
86
97
  ## Screenshots
87
98
 
88
99
  | New session | Workspace collapsed |
@@ -102,7 +113,7 @@ Stored in `localStorage`; clear these keys to reset:
102
113
  | `dsh-islands-ui:enabled` | `1` / `0`, master switch |
103
114
  | `dsh-islands-ui:accent` | Custom accent color; absent means follow theme |
104
115
  | `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 |
116
+ | `dsh-islands-ui:rail` | Left-rail icon order and hidden entries |
106
117
 
107
118
  ---
108
119
 
@@ -113,7 +124,8 @@ src/
113
124
  00-tokens.css design tokens + --dsw-* aliases (single source of truth)
114
125
  10-shell.css three-column shell → canvas + islands
115
126
  15-topbar.css window top bar
116
- 16-rail.css left icon rail, plugin pin menu, settings gear
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
117
129
  20-sidebar.css workspace island, pinned shelf, session row states
118
130
  30-conversation.css conversation page, composer, top tool group
119
131
  40-settings.css settings dialog and section shell
@@ -165,37 +177,15 @@ Repository settings: `main` requires a PR, the `check (Node 20/22/24)` CI jobs a
165
177
 
166
178
  ---
167
179
 
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
180
  ## Compatibility
192
181
 
193
182
  - The skin is a pure client style layer and does not replace session, settings or plugin data or behavior.
194
183
  - Selectors depend on the current Harness build's CSS Module hashes (e.g. `PIRFFq_*`, `kB3qhq_*`, `JoiKIa_*`, `_77Pn0W_*`) and a few `data-*` hooks. A Harness upgrade or rebuild can change those class names and require a matching CSS update.
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".
184
+ - On startup the plugin verifies the layout anchors (`.PIRFFq_frame`, `.PIRFFq_centerCol`, `.kB3qhq_root`) and the sidebar structure dialect: it injects the stylesheet for the reported DSH release, then cross-checks it against the mounted DOM (`flat` / `scroll`) and switches the variant when the two disagree. Only a structure it cannot recognize leaves the skin **off**; DSH keeps its default look, a toast explains why (5s auto-dismiss, manual close, click to open the plugin settings) and Settings → Islands UI carries a persistent amber notice plus a session-scoped "Enable anyway".
185
+ - Settings → Islands UI shows the detected DSH release and sidebar structure for support triage.
196
186
  - Dark mode follows `data-ds-dark-theme`; the accent remaps `--dsw-alias-state-business-primary`, so it affects both the skin and native buttons.
197
187
  - 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.
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.
199
189
 
200
190
  ---
201
191
 
package/README.md CHANGED
@@ -9,7 +9,7 @@
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
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
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" />
12
+ <img alt="DSH" src="https://img.shields.io/badge/DeepSeek%20Harness-0.2.2--rc.2-4f7cff?style=flat-square" />
13
13
  <img alt="Platform" src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-3b3b3b?style=flat-square" />
14
14
  <img alt="Windows/Linux" src="https://img.shields.io/badge/Windows%2FLinux-untested-orange?style=flat-square" />
15
15
  </p>
@@ -35,7 +35,7 @@ dsh plugin --profile web add dsh-islands-ui
35
35
 
36
36
  安装后刷新页面(`⌘R` / `Ctrl+R`)。皮肤默认开启;可在 **设置 → Islands UI** 关闭,关闭后立即恢复 Harness 默认外观,偏好和强调色会保留。
37
37
 
38
- > 适用于 DSH `0.2.2-rc.1` 及 `0.2.x` 后续版本。包内声明了完整的 `dsh.bundle` + `dsh.client` manifest,`dsh plugin add` 会自动写入 profile 的 bundle 栈,不需要手工改 `cordis.patch.yml`。
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`。
39
39
 
40
40
  ### 卸载
41
41
 
@@ -45,6 +45,16 @@ dsh plugin --profile desktop remove dsh-islands-ui
45
45
 
46
46
  ---
47
47
 
48
+ ## 宣传图
49
+
50
+ <p align="center">
51
+ <img src="assets/promo-cover.png" width="32%" alt="Islands UI 宣传图:更现代的界面,更完整的交互" />
52
+ <img src="assets/promo-themes.png" width="32%" alt="Islands UI 宣传图:亮暗主题,自由选择" />
53
+ <img src="assets/promo-install.png" width="32%" alt="Islands UI 宣传图:三步安装" />
54
+ </p>
55
+
56
+ ---
57
+
48
58
  ## 界面预览
49
59
 
50
60
  | 新会话 | 工作区折叠 |
@@ -60,13 +70,14 @@ dsh plugin --profile desktop remove dsh-islands-ui
60
70
  | | 功能 | 说明 |
61
71
  | :---: | --- | --- |
62
72
  | 🏝 | **浮岛布局** | 画布、主会话、工作区、右侧栏、底部面板各自独立;扁平无投影,以色块 + 1px 发丝线分隔 |
63
- | 🧭 | **常驻左侧栏** | 工作区 / 自动化任务 / 插件 / 已固定插件 / 更多;右键或「…」打开插件固定菜单 |
73
+ | 🧭 | **常驻左侧栏** | 工作区与全部插件图标直接排列;首页按钮只作会话 / 工作区抽屉触发器、不占选中态(hover 浅色反馈、点击半透明涟漪);面板图标点击切换,按住拖动排序(浮动预览跟随鼠标),右键显示 / 隐藏图标 |
64
74
  | ⚙️ | **独立设置页** | 设置 → Islands UI:一键开关皮肤、强调色(预设 + 自定义 + 跟随主题) |
65
75
  | 📌 | **置顶聚合** | 置顶会话同时保留在原工作区,并聚合到「新会话」与「工作区」标题之间;分类可折叠 |
66
76
  | 🌙 | **深色模式** | 完整深色 token:近黑画布、深灰岛屿、白色透明交互层与深色阴影 |
77
+ | 🔄 | **桌面更新入口** | 设置齿轮上方常驻;发现新版本、下载、校验、安装与失败各有独立状态,加载态使用强调色 3×3 点阵动效 |
67
78
  | ⌨️ | **快捷键** | `⌘B` 折叠工作区、`⌥⌘B` 右侧栏、`⌘,` 设置、`⌘⇧M` 模型弹层;按钮悬停显示当前键位 |
68
79
 
69
- 皮肤是纯客户端样式层;左侧栏插件固定、置顶聚合、定位与设置页也都在浏览器端完成,不新增 host 工具、服务或会话数据。
80
+ 皮肤是纯客户端样式层;左侧栏图标排序与显隐、置顶聚合、定位与设置页也都在浏览器端完成,不新增 host 工具、服务或会话数据。
70
81
 
71
82
  ### 设计语言
72
83
 
@@ -115,7 +126,7 @@ Windows 下保留 Harness 原生标题栏,自定义顶栏显示在它下方;
115
126
  | `dsh-islands-ui:enabled` | `1` / `0`,总开关 |
116
127
  | `dsh-islands-ui:accent` | 自定义强调色(不存在表示跟随主题) |
117
128
  | `dsh-islands-ui:pinned-collapsed` | 置顶分类是否折叠 |
118
- | `dsh-islands-ui:rail-pins` | 左侧栏额外固定的插件 id 列表 |
129
+ | `dsh-islands-ui:rail` | 左侧栏图标的顺序与隐藏列表 |
119
130
 
120
131
  清除这些 key 即可恢复默认。
121
132
 
@@ -128,7 +139,7 @@ src/
128
139
  00-tokens.css 设计变量 + 重定向 Harness 的 --dsw-* 别名(唯一真源)
129
140
  10-shell.css 三栏框架 → 画布 + 岛屿
130
141
  15-topbar.css 窗口顶部栏
131
- 16-rail.css 左侧图标栏、插件固定菜单、设置齿轮
142
+ 16-rail.css 左侧图标栏、拖动排序、显隐菜单、设置齿轮
132
143
  20-sidebar.css 工作区岛屿、置顶聚合、会话行状态
133
144
  30-conversation.css 会话页、输入框、顶部工具组
134
145
  40-settings.css 设置弹窗、设置页外壳
@@ -181,37 +192,15 @@ npm pack # 生成 dsh-islands-ui-<version>.tgz
181
192
 
182
193
  ---
183
194
 
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
195
  ## 兼容性与边界
208
196
 
209
- - 皮肤是**纯客户端样式层**,不替换会话、设置或插件的数据与交互;左侧栏插件固定、置顶聚合、定位等额外能力也只在客户端完成。
197
+ - 皮肤是**纯客户端样式层**,不替换会话、设置或插件的数据与交互;左侧栏图标排序与显隐、置顶聚合、定位等额外能力也只在客户端完成。
210
198
  - 选择器依赖 Harness 当前构建的 CSS Module 哈希类名(如 `PIRFFq_*`、`kB3qhq_*`、`JoiKIa_*`、`_77Pn0W_*`)与少量 `data-*` 挂点;**Harness 升级或重新构建后类名可能变化,需要同步更新对应 CSS**。
211
- - 启动时会检测三个界面锚点(`.PIRFFq_frame`、`.PIRFFq_centerCol`、`.kB3qhq_root`):缺失就**不启用皮肤**,DSH 保持默认外观,右下角弹出说明(5 秒自动关闭、可手动关闭、点击进入插件设置),设置 → Islands UI 里也常驻一条黄色说明,并提供会话级的「仍然启用」。
199
+ - 启动时检测界面骨架锚点(`.PIRFFq_frame`、`.PIRFFq_centerCol`、`.kB3qhq_root`)并校验侧栏结构方言:先按 DSH 版本注入对应样式,再用挂载后的 DOM 交叉验证(`flat` / `scroll`),两者不一致时以 DOM 为准切换样式;结构无法识别时才**不启用皮肤**,DSH 保持默认外观,右下角弹出说明(5 秒自动关闭、可手动关闭、点击进入插件设置),设置 → Islands UI 里也常驻一条黄色说明,并提供会话级的「仍然启用」。
200
+ - 设置 → Islands UI 显示检测到的 DSH 版本与侧栏结构,便于排查升级后的样式问题。
212
201
  - 深色模式跟随 Harness 的 `data-ds-dark-theme`;强调色通过重映射 `--dsw-alias-state-business-primary` 生效,会同时影响皮肤和原生按钮。
213
202
  - 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、强调色和挂载行。
203
+ - `dsh.engines.dsh` / `engines.dsh` 把兼容线钉在 `>=0.2.2-rc.1 <0.3.0-0`,越界时插件管理器会拒绝安装或升级;同一兼容线内部的结构差异由客户端按版本选择的样式变体处理,变体未覆盖的新结构会触发上述自检降级。`skin.json` 为主题管理器提供 id、强调色和挂载行。
215
204
 
216
205
  ---
217
206
 
Binary file
Binary file
Binary file