dsh-settings-size

LIMITATIONS

Known limitations

### 版本兼容性 本插件在以下 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 一致）。 ---