概览
dsh-settings-size
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
### 版本兼容性 本插件在以下 DSH 版本上**手动验证通过**: | DSH 版本 | 结果 | |---|---| | `0.1.5-rc.2` | ✅ 通过 | | `0.1.7-rc.2` | ✅ 通过 | 未列出的版本**预期同样可用**。插件只依赖少数稳定契约——`settings.general.item` 槽位、`slots` 与 `locale` 两个客户端服务、以及设置弹框的 DOM 结构——不读取任何内部实现或未公开字段,因此升级带来破坏性变更的 概率很低。第三方平台整理的兼容性结果(如 [dsh.so](https://www.dsh.so/artifact/dsh-settings-size/))也值得一并参考。 插件在 `package.json` 中声明了 `"@deepseek-ai/dsh": "^0.1.0"`,DSH 启动时会用 `semver.satisfies()` 自动校验,不满足时给出明确的版本冲突告警。 如果你在某个版本上遇到问题,或者有改进建议,欢迎[提交 Issue](https://github.com/alexzshl/dsh-settings-size/issues) 或直接发起 PR;报告时请附上 `dsh --version` 的输出与具体现象。 ### 已知限制 - **依赖弹框的 DOM 结构** `role="presentation" > role="dialog"[aria-modal]`。若未来 DSH 改版换了这层结构, 只需要改 `lib/client.js` 里的 `PANEL` 常量,其余逻辑不受影响——这也是不用哈希类名的原因。 - **只影响 Web GUI**。TUI / desktop profile 不加载 `dsh.client`,插件对它无副作用。 - **不修改任何 shipped 文件**:全部通过覆盖式 CSS 与槽位注册实现。 - **版本兼容声明只能写在 `peerDependencies`**:`dsh-app-boot` 的 `evaluatePluginCompatibility` 只扫描 `package.json` 里 `@deepseek-ai/dsh` 与 `@deepseek-ai/dsh-*` 开头的 peer,用 `semver.satisfies(runtime, range, { includePrerelease: true })` 比对,不满足时给出插件名、版本与 运行版本的告警(另有 exact-version 豁免机制)。`cordis.yml` / `cordis.patch.yml` 里的 `dshCompatibility` 之类字段**不会被读取**——那个文件是 patch 数组,多塞一个键只会让 loader 告警并跳过。 - 尺寸以 CSS 像素计,浏览器缩放会等比影响观感(与 DSH 其他 UI 一致)。 ---
