Overview
dsh-client-ui-mc-skin
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known 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`。 ---