dsh-islands-ui 1.0.2 → 1.0.4

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,32 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.0.4 — 2026-11-12
4
+
5
+ ### 兼容性
6
+
7
+ - 客户端读取 `window.__DSH_BOOT__.release.version`,按 DSH 版本选择侧栏结构样式:新增 `scroll` 变体(`src/variants/scroll.css`),适配 0.2.2-rc.2 新增的 `.kB3qhq_scrollRegion` / `.kB3qhq_scrollArea` 包装层,修复工作区列表被挤进 48px 图标栏、工作区岛只剩空白卡片的问题。旧版 DSH 不会匹配变体选择器,仍走原样式。
8
+ - 自检升级为「版本选样式 + 结构交叉验证」:版本选中的方言与挂载后的 DOM 不一致时以 DOM 为准切换变体;两者都不匹配才停用皮肤并弹出提示,避免再次静默半启用。
9
+ - `panelEntryActive` 兼容 0.2.2-rc.2 的面板选中类名(`panelActive` 已移除)。
10
+ - 设置 → Islands UI 显示检测到的 DSH 版本与侧栏结构。
11
+
12
+ ### 界面
13
+
14
+ - 重写左下角桌面更新入口:隐藏原生「新版本」胶囊,改为设置齿轮上方的 36px 圆形按钮,展开与收起侧栏都可见。
15
+ - 更新状态直接订阅 `window.dshDesktop.updates`:发现新版本显示蓝色实心圆 + 下载箭头,就绪显示重启图标,失败显示半透明红底、红色描边、状态点与重试图标。
16
+ - 下载、校验、安装不再使用圆形底色,直接用皮肤强调色绘制 3×3 点阵动画(Column Flux / Smiley Spin / Core Echo),并支持 `prefers-reduced-motion` 静态回退。
17
+ - 更新入口按 DSH 版本动态读取展示数据:0.2.2-rc.2 新增的 `configurationError`(配置读取/格式/channel/清理失败)复用错误态与重试图标,旧版没有该字段时行为不变。
18
+ - 设置 → Islands UI 的「更新按钮状态」预览卡暂时隐藏;组件与样式保留,取消 `client.template.js` 中对应渲染行的注释即可恢复。
19
+
20
+ ### 文档
21
+
22
+ - 新增三张 3:4 宣传图(封面、亮暗主题、三步安装),中英文 README 各加一节展示;`screenshots.json` 改为这三张,商店预览同步更新,原有的界面截图仍保留在 README 的「界面预览」中。
23
+
24
+ ## 1.0.3 — 2026-11-12
25
+
26
+ ### 发布
27
+
28
+ - npm 发布链路改用 npm Trusted Publishing(GitHub Actions OIDC):发布时由 npm 用 workflow 的 OIDC 身份换取短期凭据,仓库不再保存长期 `NPM_TOKEN`。本版本无功能变更,仅用于验证 OIDC 发布链路。
29
+
3
30
  ## 1.0.2 — 2026-11-12
4
31
 
5
32
  ### 修复
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
 
@@ -51,6 +51,7 @@ dsh plugin --profile desktop remove dsh-islands-ui
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 |
@@ -114,6 +125,7 @@ src/
114
125
  10-shell.css three-column shell → canvas + islands
115
126
  15-topbar.css window top bar
116
127
  16-rail.css left icon rail, plugin pin 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
  | 新会话 | 工作区折叠 |
@@ -64,6 +74,7 @@ dsh plugin --profile desktop remove dsh-islands-ui
64
74
  | ⚙️ | **独立设置页** | 设置 → Islands UI:一键开关皮肤、强调色(预设 + 自定义 + 跟随主题) |
65
75
  | 📌 | **置顶聚合** | 置顶会话同时保留在原工作区,并聚合到「新会话」与「工作区」标题之间;分类可折叠 |
66
76
  | 🌙 | **深色模式** | 完整深色 token:近黑画布、深灰岛屿、白色透明交互层与深色阴影 |
77
+ | 🔄 | **桌面更新入口** | 设置齿轮上方常驻;发现新版本、下载、校验、安装与失败各有独立状态,加载态使用强调色 3×3 点阵动效 |
67
78
  | ⌨️ | **快捷键** | `⌘B` 折叠工作区、`⌥⌘B` 右侧栏、`⌘,` 设置、`⌘⇧M` 模型弹层;按钮悬停显示当前键位 |
68
79
 
69
80
  皮肤是纯客户端样式层;左侧栏插件固定、置顶聚合、定位与设置页也都在浏览器端完成,不新增 host 工具、服务或会话数据。
@@ -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