0.1.5 — 兼容 DSH 0.2.0

让插件在 DSH 0.2.0 及以后版本继续可用——这是一次兼容性修复，功能无变化。

背景

DSH 0.2.0 起会在启动时强制校验插件 package.json 的 peerDependencies（由 dsh-app-boot 的
evaluatePluginCompatibility 执行），范围不满足即拒绝加载插件。0.1.4 声明的
"@deepseek-ai/dsh": "^0.1.0" 在 0.2.0 上不再成立，升级后插件会直接不加载。

修复

• 兼容范围改为 "*" —— 显式声明兼容所有版本，不再锁主版本。
• 为什么可以声明为全兼容：本插件不持久化任何数据（尺寸存在浏览器 localStorage，与 DSH 版本
  无关），只依赖 settings.general.item 槽位与 slots / locale 两个客户端服务——都是长期稳定的
  契约。没有跨版本的存储格式或协议需要对齐，因此不存在"必须锁版本"的理由。

顺带记录一个易错点

声明"兼容所有版本"要写 "*"，不要写 workspace:* / workspace:^ / workspace:~——它们在比较前
会被替换成当前运行版本，语义是"只兼容我这一版"，下次 DSH 升级后同样会被拒绝。README 的兼容性
章节已把这条写清楚了。

验证

• 用 dsh-app-boot 导出的 evaluatePluginCompatibility 对真实 package.json 跑校验
  （runtime 0.2.0-rc.1）：通过。
• 反向验证：把声明换回 ^0.1.0 会被判定 REJECT，确认此修复确有必要。
• 运行态确认：settings.general.item 槽位中 settings-size（order 15）处于 active 状态，
  插件在 0.2.0-rc.1 上正常挂载。

兼容性

DSH 版本	结果
0.1.5-rc.2	✅ 通过
0.1.7-rc.2	✅ 通过
0.2.0-rc.1	✅ 通过（本次新增验证）

安装 / 升级

dsh plugin --profile web add -w <本仓库路径>
# 然后重启 dsh web

已在 0.1.4 及更早版本的用户直接升级即可；localStorage 中保存的尺寸不受影响。

---

English

Keeps the plugin loadable on DSH 0.2.0 and later — a compatibility fix with no functional change.

DSH 0.2.0 began enforcing a plugin's package.json peerDependencies at startup (via dsh-app-boot's
evaluatePluginCompatibility) and refuses to load a plugin whose range does not match. The
"@deepseek-ai/dsh": "^0.1.0" declared in 0.1.4 no longer holds on 0.2.0, so the plugin silently stopped
loading after the upgrade. This release declares "*" instead — compatible with every version.

That is safe here because the plugin persists no data (the size lives in browser localStorage,
independent of the DSH version) and depends only on the settings.general.item slot plus the
slots / locale client services — all long-stable contracts.

Note: to declare "compatible with everything", write "*" — not workspace:*, workspace:^ or
workspace:~, which are replaced by the current runtime version before comparison and therefore mean
"only this one version".

---

完整变更 / Full changelog: 0.1.4...0.1.5

0.1.4 — DSH 版本兼容声明

为插件补上显式的 DSH 版本兼容声明：把「升级 DSH 后莫名不工作」提前为「启动时明确的版本冲突告警」。

新增

• 声明 DSH 兼容范围 — package.json 的 peerDependencies 增加 "@deepseek-ai/dsh": "^0.1.0"。
  DSH 启动时由 dsh-app-boot 的 evaluatePluginCompatibility 读取，并以
  semver.satisfies(runtime, range, { includePrerelease: true }) 校验；不满足时输出插件名、插件版本与
  运行版本，不再等到运行期才失败。
• README 新增「版本兼容性」小节（中英双份）— 列出已手动验证的 DSH 版本
  （0.1.5-rc.2、0.1.7-rc.2），说明插件只依赖稳定契约（settings.general.item 槽位、
  slots / locale 服务、设置弹框的 DOM 结构），并给出 Issue / PR 反馈路径。

备注

• 兼容性声明只能写在 peerDependencies：dsh-app-boot 只扫描 @deepseek-ai/dsh 与
  @deepseek-ai/dsh-* 开头的 peer。cordis.yml / cordis.patch.yml 里的自定义字段不会被读取，
  多塞一个键只会让 loader 告警并跳过该条目。
• 源码包由 GitHub 自动附带：Source code (zip) 与 Source code (tar.gz)。本插件无构建步骤，
  仓库即产物，安装时按 link: 或 tarball 引用均可。

安装 / 升级

dsh plugin --profile web add -w <本仓库路径>
# 然后重启 dsh web

已安装用户无需额外操作；localStorage 中保存的尺寸不受影响。

---

English

This release gives the plugin an explicit DSH version-compatibility declaration, turning "silently broken
after a DSH upgrade" into "an explicit version-conflict warning at startup".

• Declared compatibility range — package.json now carries "@deepseek-ai/dsh": "^0.1.0" in
  peerDependencies. dsh-app-boot's evaluatePluginCompatibility reads it at startup and validates with
  semver.satisfies(runtime, range, { includePrerelease: true }), reporting the plugin name, plugin version,
  and runtime version on a mismatch instead of failing later at runtime.
• New "Version compatibility" section in both READMEs — lists the manually verified DSH versions
  (0.1.5-rc.2, 0.1.7-rc.2), explains that the plugin depends only on stable contracts (the
  settings.general.item slot, the slots / locale services, and the dialog's DOM structure), and points
  to the issue/PR feedback path.

A compatibility declaration can only live in peerDependencies: dsh-app-boot scans only peers named
@deepseek-ai/dsh or starting with @deepseek-ai/dsh-. Source archives are attached by GitHub
automatically; the plugin has no build step, so the repository is the artifact.

---

完整变更 / Full changelog: 0.1.3...0.1.4

0.1.3 — 中英双语

设置行接入 DSH 的本地化机制，中英界面自动切换；同时移除一个冗余按钮。

新增

• 中英双语 — 行内文案接入 DSH 的 locale 服务（命名空间 settings.size），随 DSH 的语言设置
  自动切换，无需刷新。
• README 增加界面截图 — 中文、英文各一张。

变更

• 移除「恢复默认」按钮 — 「标准 800×800」预设已覆盖同一功能，两者并存属于冗余。

安装 / 升级

dsh plugin --profile web add -w <本仓库路径>
# 然后重启 dsh web

已安装用户无需额外操作；localStorage 中保存的尺寸不受影响。

---

English

The settings row now follows DSH's locale service: it registers zh/en dictionaries under the settings.size
namespace and switches instantly with the active language. The redundant "Reset" button was removed — the
Standard 800×800 preset already covers it.

---

完整变更 / Full changelog: 0.1.2...0.1.3

0.1.2 — 预设单选高亮修复

首个带 tag 的发布。修复了预设选中态与「恢复默认」语义两个缺陷。

修复

• 预设选中态 — React 内联样式在 border 简写与 borderColor 长写之间切换时，取消选中只会清掉长写，
  留下 border-width / border-style，颜色回退到 currentColor：表现为每点一次预设就永久多一条边框。
  两个状态改用同一个属性名后解决。
• 「恢复默认」语义 — 此前回到插件的初始尺寸 1080×900，改为回到 DSH 原生的 800×800。

变更

• 预设药丸的边框处理对齐官方「外观」卡：未选中为 .5px 细边框，选中换亮边框并加底色。
• README 结构调整：安装 / 卸载提到简介之后，深挖内容折叠为 <details>。

安装 / 升级

dsh plugin --profile web add -w <本仓库路径>
# 然后重启 dsh web

---

English

First tagged release. Fixes two defects: a preset pill accumulated a permanent hairline border once it had
been selected (React clears only the borderColor longhand on deactivate, leaving the border shorthand's
width and style with currentColor), and the reset action restored the plugin's 1080×900 starting size
instead of DSH's own 800×800. Preset borders now match the shipped Appearance cubes.

---

完整变更 / Full history: https://github.com/alexzshl/dsh-settings-size/commits/0.1.2