dsh-islands-ui 1.0.0 → 1.0.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 +16 -0
- package/README.en.md +5 -1
- package/README.md +6 -2
- package/client.js +590 -209
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,20 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.0.2 — 2026-11-12
|
|
4
|
+
|
|
5
|
+
### 修复
|
|
6
|
+
|
|
7
|
+
- 修复右上角右侧栏开关点击无效:按钮原本困在 AppFrame 的 `shell.overlay` 层(z-index 20),被 `dsh-better-sidebar` 的面板宿主(铺满视口的 fixed 层,z-index 25)盖住,既不响应 hover 也没有 cursor/点击。现改为渲染到 `document.body` 并提升到 z-index 900,位于工作台图层之上、菜单与弹窗之下;同时补上皮肤关闭时的隐藏兜底。
|
|
8
|
+
- 右侧栏开关优先调用 `layoutService.openRightbar/closeRightbar`,服务未生效时再回退点击原生展开/收起控件。
|
|
9
|
+
|
|
10
|
+
## 1.0.1 — 2026-11-12
|
|
11
|
+
|
|
12
|
+
### 兼容性
|
|
13
|
+
|
|
14
|
+
- 启动时校验 DSH 界面锚点(`.PIRFFq_frame`、`.PIRFFq_centerCol`、`.kB3qhq_root`)。不匹配时不再"半启用"皮肤:保持 DSH 默认外观,只注册设置页,避免双栏重叠与悬浮控件遮挡。
|
|
15
|
+
- 不匹配时右下角弹出提示,5 秒自动关闭,可手动关闭,点击直接跳到设置 → Islands UI;设置页顶部常驻黄色说明条,列出缺失的锚点,并提供会话级「仍然启用」逃生开关。
|
|
16
|
+
- `shortcuts.observeFixedInput` 增加能力判断,缺失时不再中断整个 `apply()`(此前会导致设置页注册缺失)。
|
|
17
|
+
|
|
3
18
|
## 1.0.0 — 2026-11-12
|
|
4
19
|
|
|
5
20
|
首个公开发布版本。
|
|
@@ -25,3 +40,4 @@
|
|
|
25
40
|
- 新增 awesome-dsh-plugin 收录模板与 npm / DSHHub / dsh-market 发布说明。
|
|
26
41
|
- README 补充安装、常见问题、仓库配置、贡献与安全说明;新增英文 FAQ。
|
|
27
42
|
- 新增 GitHub Actions CI / Publish 工作流、Issue / PR 模板、`CONTRIBUTING.md`、`SECURITY.md`、`.editorconfig`、`.gitattributes` 和 `.nvmrc`。
|
|
43
|
+
- 启用 `main` 分支保护、`v*` tag 保护、外部 fork PR 审批和 Dependabot(GitHub Actions)。
|
package/README.en.md
CHANGED
|
@@ -154,12 +154,15 @@ The module loader cannot read package files at runtime, so `client.js` must cont
|
|
|
154
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
155
|
| `.github/ISSUE_TEMPLATE/` | Bug and feature forms that require the DSH version, platform and reproduction steps |
|
|
156
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 |
|
|
157
158
|
| `.editorconfig` / `.gitattributes` | UTF-8, LF, 2-space indentation; images and tarballs are binary |
|
|
158
159
|
| `.nvmrc` | Node 24 for local development |
|
|
159
160
|
| `CONTRIBUTING.md` | Development, build, commit conventions and PR checklist |
|
|
160
161
|
| `SECURITY.md` | Supported versions and the private vulnerability-reporting flow |
|
|
161
162
|
| `scripts/check-package.mjs` | Pre-publish validation of the manifest, row name, client build, screenshots and `files[]` |
|
|
162
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
|
+
|
|
163
166
|
---
|
|
164
167
|
|
|
165
168
|
## Publishing
|
|
@@ -189,9 +192,10 @@ Store coverage:
|
|
|
189
192
|
|
|
190
193
|
- The skin is a pure client style layer and does not replace session, settings or plugin data or behavior.
|
|
191
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".
|
|
192
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.
|
|
193
197
|
- Windows uses `data-windows-titlebar` and `--dsh-windows-titlebar-height`; Linux currently follows native window decorations.
|
|
194
|
-
- `dsh.engines.dsh` / `engines.dsh` pin the tested line to `>=0.2.2-rc.1 <0.3.0-0`; `skin.json` gives theme managers the id, accent and mount row.
|
|
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.
|
|
195
199
|
|
|
196
200
|
---
|
|
197
201
|
|
package/README.md
CHANGED
|
@@ -170,12 +170,15 @@ npm pack # 生成 dsh-islands-ui-<version>.tgz
|
|
|
170
170
|
| `.github/workflows/publish.yml` | 推送 `v*` tag 或手动触发发布;tag 必须与 `package.json` 版本一致,使用 `NPM_TOKEN` secret |
|
|
171
171
|
| `.github/ISSUE_TEMPLATE/` | Bug / Feature 表单,强制填写 DSH 版本、平台和复现步骤 |
|
|
172
172
|
| `.github/PULL_REQUEST_TEMPLATE.md` | PR 自检:构建、宽窄屏、深色模式、无本地路径 |
|
|
173
|
+
| `.github/dependabot.yml` | 每周检查 GitHub Actions 版本更新 |
|
|
173
174
|
| `.editorconfig` / `.gitattributes` | 统一 UTF-8、LF、2 空格;图片和 tarball 按二进制处理 |
|
|
174
175
|
| `.nvmrc` | 本地开发使用 Node 24 |
|
|
175
176
|
| `CONTRIBUTING.md` | 开发、构建、提交约定和 PR 清单 |
|
|
176
177
|
| `SECURITY.md` | 支持版本与私密漏洞报告流程 |
|
|
177
178
|
| `scripts/check-package.mjs` | 包里 manifest、row name、client 构建、截图和 `files[]` 的发布前校验 |
|
|
178
179
|
|
|
180
|
+
仓库设置:`main` 需要 PR、CI 的 `check (Node 20/22/24)` 通过和对话解决后才能合并,且禁止 force push;`v*` tag 禁止删除/移动;外部 fork PR 需要维护者批准。
|
|
181
|
+
|
|
179
182
|
---
|
|
180
183
|
|
|
181
184
|
## 发布与商店
|
|
@@ -205,9 +208,10 @@ npm publish --access public
|
|
|
205
208
|
|
|
206
209
|
- 皮肤是**纯客户端样式层**,不替换会话、设置或插件的数据与交互;左侧栏插件固定、置顶聚合、定位等额外能力也只在客户端完成。
|
|
207
210
|
- 选择器依赖 Harness 当前构建的 CSS Module 哈希类名(如 `PIRFFq_*`、`kB3qhq_*`、`JoiKIa_*`、`_77Pn0W_*`)与少量 `data-*` 挂点;**Harness 升级或重新构建后类名可能变化,需要同步更新对应 CSS**。
|
|
211
|
+
- 启动时会检测三个界面锚点(`.PIRFFq_frame`、`.PIRFFq_centerCol`、`.kB3qhq_root`):缺失就**不启用皮肤**,DSH 保持默认外观,右下角弹出说明(5 秒自动关闭、可手动关闭、点击进入插件设置),设置 → Islands UI 里也常驻一条黄色说明,并提供会话级的「仍然启用」。
|
|
208
212
|
- 深色模式跟随 Harness 的 `data-ds-dark-theme`;强调色通过重映射 `--dsw-alias-state-business-primary` 生效,会同时影响皮肤和原生按钮。
|
|
209
213
|
- Windows 使用 `data-windows-titlebar` 与 `--dsh-windows-titlebar-height` 适配原生标题栏;Linux 暂无专用标题栏变量,按原生窗口装饰处理。
|
|
210
|
-
- `dsh.engines.dsh` / `engines.dsh` 把兼容线钉在 `>=0.2.2-rc.1 <0.3.0-0
|
|
214
|
+
- `dsh.engines.dsh` / `engines.dsh` 把兼容线钉在 `>=0.2.2-rc.1 <0.3.0-0`,越界时插件管理器会拒绝安装或升级;同一兼容线内部的构建差异由启动时的锚点自检兜底。`skin.json` 为主题管理器提供 id、强调色和挂载行。
|
|
211
215
|
|
|
212
216
|
---
|
|
213
217
|
|
|
@@ -231,7 +235,7 @@ npm publish --access public
|
|
|
231
235
|
|
|
232
236
|
**为什么某些界面还是旧样式?**
|
|
233
237
|
|
|
234
|
-
|
|
238
|
+
说明皮肤**检测到界面结构不匹配,已自动关闭**。DSH 升级可能改掉皮肤依赖的 CSS Module 哈希类名,半启用会变成双栏重叠,所以插件宁可保持默认外观:右下角会有提示,设置 → Islands UI 顶部有黄色说明条并列出缺失的锚点。把 Islands UI 更新到适配当前 DSH 的版本即可恢复;确认界面正常也可以点「仍然启用」临时开启(下次启动重新检测)。
|
|
235
239
|
|
|
236
240
|
**Windows / Linux 能用吗?**
|
|
237
241
|
|