dsh-sandrone-ui-patches

dsh-sandrone-ui-patches

DeepSeek Harness（DSH）的界面补丁集合 —— 以 client 半区注入全局 CSS 的方式， 在不改上游源码、不改 DOM 结构的前提下调整界面表现。

命名说明：本地开发时叫 dsh-suigintou-ui-patches（水银灯）， 公开发布用 dsh-sandrone-ui-patches（桑多涅）。同一个包，功能与代码完全相同。 差异只是早期注册时的命名习惯。

包含的补丁

补丁	内容
字体方案	正文字族 Source Serif 4 Variable（随包自带，@font-face）打头 → Source Serif 4 Display / Times New Roman / 中文仿宋 / 思源宋体兜底；
代码字族 Fira Code → 仿宋 → serif（与 VSCode 对齐）
字号倍率	不设死基准 —— 跟随 DSH 设置面板的「字号大小」（10–22px），正文基准由用户决定；
本补丁只定义倍率（代码 = 基准 × 16/18、行内代码同、小字号行高 × 24/18、横幅 × 15/18 等），基准一动整站等比跟随
随包字体	font/SourceSerif4Variable-Roman.woff2（全量 426,716 B，SIL OFL 1.1），由 host 半区的前缀路由发出（immutable 缓存 + 内容哈希 ETag）；
保留可变轴 wght 200-900 / opsz 8-60，故 font-optical-sizing: auto 能按实际字号自动选光学尺寸
侧栏字族	左右两栏（[data-slot="sidebar"] / [data-slot="rightbar"]）字族换 思源宋体一体，右栏编辑器正文例外（大字号细读区，保留原衬线栈）。
理由不是审美而是渲染地板：上游把侧栏字号写死成 14/12/10px（不跟「字号大小」设置），仿宋竖画仅 0.035em ⇒ 14px 下只有 0.74 设备像素，永远画不出一个实心笔画（实测墨像素均值 129/255、纯黑占比 0%）；思源宋体 0.0675em ⇒ 1.42 设备像素，稳过线
编辑日志卡字号	会话里的「已编辑 N 个文件」卡（[data-changed-files="true"]）五处字面 px（13 / 10 / 11 / 12 / 12）改成「基准 × 倍率」⇒ 基准 20px 时 18 / 17 / 17 / 16 / 16px。
字族刻意不动：实测只要把字号抬上来，仿宋 × Source Serif 4 混排毫不违和 —— 「违和」的根因自始至终是字号低于渲染地板，不是两个字体不搭
皮肤字族压制	两层通用规则压掉皮肤对 code/pre 的组件级直接声明（不逐皮肤枚举，新皮肤自动覆盖）
表格	宽 Markdown 表格（≥4 列）强制压缩；furina/navia 暗色皮肤表格分割线对比度增强
长会话渲染剪枝	content-visibility: auto —— 屏幕外消息跳过样式计算与布局（见下）

字体选择是我的个人审美，因为总感觉无衬线体太丑了。

字族与字号均通过覆盖 DSH 的 CSS 变量树实现；皮肤压制另需选择器层（见 lib/client.js 注释）。

关于官方的字号链，以及本补丁接管哪几档：DSH 把 markdown 标题族写成 calc( + var(--dsh-content-font-delta))（加法式，基准由 --dsh-content-font-size 派生）； 而 code / code-block / 横幅是硬编码绝对值（12px / 11px / 11px），不在这条链上。 本补丁不动官方的基准与 delta 链 —— 早期版本曾用 18px !important 覆盖基准值， 那会压掉设置面板（!important 赢过写在 body 内联样式上的用户设置），已撤销； 现在只在链外接管这几档，并统一写成倍率 × 基准的形式。详见 lib/client.js 内注释。 （可变字体的 opsz 轴也正因「基准可调」才必需：手工分档是静态映射，字号一变就失配。）

侧栏字族改动的技术要点：font: 简写会漏网

侧栏不是靠「写一条 font-family」改成的 —— 第一版就是这么写的，左栏成了、右栏没成。原因是两条叠在一起：

1. 右栏插件（dsh-better-sidebar）大量使用 font: 简写 token，例如 .explorerRow { font: var(--dsw-font-xxs-12) }。font: 简写会把 token 里烘着的字族展开成元素上的直系 font-family 声明 —— 继承永远压不过直系声明。
2. ui-theme 把这些 --dsw-font-* token 定义成 12px/18px var(--dsw-font-family)，字族被烘进了值里。而 CSS 自定义属性的 Computed value 是 「specified value with variables substituted」⇒ 嵌套 var() 在声明处（:root / html body）就解析完，之后按计算值继承。在子孙上重定义 --dsw-font-family 不会重算它。

⇒ 必须把这些简写 token 本身在侧栏根上重算一遍。本补丁用各 token 自己的子变量（-font-style / -font-weight / -font-size / -line-height，它们只是数值与长度、不含嵌套 var()）重建 27 个字族简写，不硬编码任何尺寸；代码族一概不碰（终端、代码块、git diff 的等宽必须原样）。

两条可复用的排查纪律（都是这次踩出来的）：

1. 查「谁覆盖了字体」时只 grep font-family 会漏 —— 必须连 font: 一起 grep。
2. CSS 变量是「声明处解析、按计算值继承」：改了子孙上的 --b，祖先上定义的 --a: var(--b) 不会重算。要给一棵子树换字族，凡「把字族烘进值里」的 token 都得在同一个根上重写。

同理，字号那一档的选择判据是**「这个元素抬不抬得动字号」**：编辑日志卡抬得动（行高跟着内容走）⇒ 抬字号、留仿宋；左右侧栏抬不动（行高被锁在 32px）⇒ 只能换字面。

长会话渲染剪枝

DSH 的消息列表既无虚拟化、也无 content-visibility，长会话下 style + layout 会随 DOM 节点数线性增长。实测（真实会话，186 条消息 / 30,181 个 DOM 节点）：

环境	content-visibility: off	auto	收益
Firefox 157	219 ms	39 ms	−82%
Edge 154	240 ms	0.8 ms	−99.7%

完整方法、全部原始读数、复现步骤与局限声明见：

📄 docs/perf-long-session-rendering.md

该报告同时记录了一条方法学教训（--headless 不能用来测 layout， 实测高估 4.5 倍），复现材料在 bench/。

安装

# 在 DSH profile 目录下
pnpm add file:packages/dsh-sandrone-ui-patches

或作为 bundle 挂载（见 cordis.patch.yml）。

兼容性

dsh.engines.dsh >= 0.1.1-rc.1

许可

MIT。

随包字体 font/SourceSerif4Variable-Roman.woff2 是 Source Serif 4（Adobe）的发行副本， 采用 SIL Open Font License 1.1；许可全文随包附于 font/LICENSE-SourceSerif4.md（OFL 要求随附）。

bench/katex/ 为上游 KaTeX 的发行副本（MIT）， 随本项目一并分发以便基准测试离线复现。

其余文本内容采用CC BY-SA 4.0协议予以授权，条款参考 https://creativecommons.org/licenses/by-sa/4.0/deed.zh-hans 。

免责

本项目为第三方界面补丁，与 DeepSeek 官方无隶属关系。 界面注入类补丁会随上游 UI 变更而失锚，升级 DSH 后请复验。