25dcd7293c
Delete design-session citations (decision/audit/plan ordinals, stack positions), change narration, review choreography, and reviewer-addressed justification from comments, JSDoc, docs, READMEs, Agent Notes, tests, and generator templates; restate every affected fact as current-state contract prose. Fix generated docs at their sources and regenerate the catalogs and cordis-surface regions; re-paste type-equiv blocks; update every bilingual counterpart and re-record the pairs. Record the citation rule in the committed-artifact-citations Agent Note.
3.1 KiB
@deepseek-ai/dsh-client-ui-theme
English | 中文
主题插件：基于 --dsw-* token 基础样式表（静态尺度 + 别名语义层）的 ThemeService。该服务拥有主题偏好（light／dark／system，以 dsh.theme 为键持久化），将 system 通过 prefers-color-scheme 解析为实际主题，并发布不可变的 ThemeSnapshot，通过 theme/change 事件通知变化；它绝不接触 DOM：ui-layout 的呈现器会应用解析后的快照（html { color-scheme }、body[data-ds-dark-theme]，以及主题的别名 token 内联变量）。
src/styles/ 下有五张样式表，全部由 web 壳的 base.css 导入：base.css、design-platform.css、scrollbar.css、gradient-shadow-text.css 与 shiki.css。scrollbar.css 是 --dsw-alias-scrollbar-* token 的唯一消费方，必须排在声明这些 token 的 design-platform.css 之后。
滚动条重新绑定约定：scrollbar.css 在 body 上把 --dsh-scrollbar-thumb 与 --dsh-scrollbar-thumb-hover 绑定到 l1（基础表面）token，两条渲染路径都读取这一组变量。高层级表面（菜单、浮层、对话框）在自己的容器上设置 --dsh-scrollbar-thumb: var(--dsw-alias-scrollbar-bg-l2) 与 --dsh-scrollbar-thumb-hover: var(--dsw-alias-scrollbar-hover-l2)；一次重新绑定即可为引擎实际走的那条路径换色。这组变量的另一个合法目标是 transparent，即完全不绘制滑块——ui-sidebar 在指针不在栏内时就这样重新绑定自己的列。绑回 l1 那组不算重新绑定，它只是重述基础表面的默认值。
两条路径在构造上互斥。scrollbar-width／scrollbar-color 写在 @supports not selector(::-webkit-scrollbar) 之内，因为这两个属性中的任一个只要取非 auto 值，Chromium 与 Safari 就会丢弃该元素上的全部 ::-webkit-scrollbar* 规则，::-webkit-scrollbar-thumb:hover 也在其中——若无条件地同时声明，--dsh-scrollbar-thumb-hover 在任何引擎上都不会被渲染。因此 Firefox 走标准属性，WebKit 系引擎走伪元素，hover token 只经由伪元素这条路径渲染。推理过程与实测计算值见滚动条 Agent Note。
模型体验
无。主题服务管理浏览器偏好；这里没有任何内容进入模型请求。
KV Cache 影响
无；该包（package）既不组装也不发送提供方请求。
已知限制与暂缓事项
- 第三方主题是表层，不是产品：注册主题意味着覆盖同名别名变量；目前不会验证一组覆盖是否完整。
- token 样式表是颜色值的唯一权威来源：会有意不补入 cssdesign 中缺失的值（例如设计中的 #4176E6 标签页蓝色）；一律采用最接近的语义 token。设计负责人批准的新增值是例外：须在同一变更中以一个静态尺度层级与一个语义别名的形式进入（
--dsw-static-blue-900/--dsw-alias-label-primary-bluish）。