dsh-client-ui-mc-skin

LIMITATIONS

已知限制

- **开关状态已持久化**（1.2.0 起），但**只在 Host 提供 settings 服务时**。连接处于 memory 模式或 ui-settings 未装配时退化为内存态，重启回到默认。设置行末尾会自动据此显示或隐藏那句持久化说明。 - **主题是深色单套。** 浅色/深色模式目前是同一组值，切换不改变外观——因为模板图本身就是深色体系。本主题会把上表那 10 个面板 token 也钉成深色，所以即使应用处于**浅色模式**也不会漏白底（**只限用户报过的那几个面**，见《浅色模式漏白底》里的范围纪律）。 - **第三方插件的自绘界面不在覆盖范围内。** 本主题只负责 DSH 自己的 token 和类名；别的插件如果写死了浅色背景，那部分仍是它自己的样子。 - **字体文件 16 MB。** 首次开启要下 3.85 MB（gzip 后）。本机 loopback 无感，但如果哪天把 DSH 挂到网络上，这就是一笔真实流量。想变小只能做字体子集化——实测 ASCII+拉丁 602 个字形只占 60 KB，但中日韩统一表意区就要 6.2 MB，所以"只留常用字"可以做到 ~1 MB，代价是生僻字回落到系统字体。 - **像素字体在小字号下是设计尺寸。** 这份字体是 16×16 点阵风格，12–15 px 下最锐利；界面缩放（Ctrl +/-）到非整数倍时笔画会糊。 - **依赖内部类名后缀。** 按钮/分页/卡片等规则按 `[class*="_xxx"]` 匹配 DSH 的 CSS Module 局部名。DSH 若把这些名字改掉，对应规则会静默失效（不会报错，只是那部分回到原生样式）。**别靠肉眼判断是否失效** —— 跑 `node tools/verify-selectors.mjs`，它会拿真实源码核对每一条。 - **依赖内部槽位名。** `sidebar.brand.mark` / `sidebar.brand.name` / `conversation.hero.brand.mark` / `settings.general.item` 同理，改了就少渲染一部分。 - **文字色不可调。** 十六色调色板已移除；想改主色就改 `src/client.js` 的 `TEXT_PRIMARY` 再 `node build.mjs`。 ---