Overview
dsh-kami-theme
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
- **roster 生效需重启**:与 DSH 所有插件一致,启用状态(`disabled: true`) 与卸载在服务启动时组装生效;运行期间改配置需要重启 `dsh web`。 - **衬线字形有限**:Charter 只有 Regular/Bold 两档(400/700),500 会渲染为 400。标题层级依赖**字号级差 + 负字距 + 字距**而非字重;小标题(h4+)用 600 承担。中文衬线经系统栈回退到宋体(Songti/Source Han/SimSun),不打包 任何字体。 - **「深度求索中…」流光**保留 DSH 原生的渐变文字动效(`background-clip:text` + 扫光),只是把色板换成墨蓝;浅色下扫光高光段对比度较低(约 1.2:1), 这是原组件的装饰性设计,正文文字主色 11:1,不影响阅读。 - DSH 大量圆角由组件级 CSS 决定(`--dsl-*` 局部变量等),token 层无法以 不碰源码的方式统一收窄;本主题保留 DSH 默认圆角,但通过发丝线、留白与 衬线字让整体观感保持 Kami 的「平、细、静」。 - Kami 原始仓库没有深色模式与完整的成功/错误色板;本主题为 DSH 必要状态 (错误、警告、成功)提供了暖色系的克制配色,保证对比度与可辨别性,但 这些并不声称是 Kami 原文。 - **状态层依赖类名片段与结构特征**:发送键的 idle / running 之分靠 `:has(> svg > rect)`(停止方块 = running)与 `[class*="_primary"]`, 预设胶囊靠 `[class*="_seat"]` / `[class*="_chevron"]`,running 标记靠 `[class*="_markBusy"]` / `[class*="_glyphProgress"]`。这些片段与结构已在本 版本实测确认;若未来 DSH 改变图标结构或类名,对应规则会**自动停止匹配并 回落到原生外观**,不会误伤其它元素,也不需要改布局。 - **浅色下 hover / selected 的填充差本身很小**(胶囊底 `#eae8dd` 对画布 1.11:1,墨蓝薄染对胶囊底 1.03:1),这是浅底色的物理限制。因此浅色的选中与 hover 表达**主要靠描边与墨蓝文字**(墨蓝于薄染底 10.18:1),而不是靠填充深浅。 - **「创造模式」无法被 CSS 单独定位**(见上文限制框):胶囊按钮没有 preset-id 属性,激活态只能表达"当前预设"。若将来 DSH 暴露该属性,可在此加一条规则。 - 若未来 DSH 前端大面积重构 token 名,本主题会像社区其他皮肤一样随版本 跟进(token 覆盖天然有向后兼容的降级空间)。
