2754LM/dsh-theme-newsprint

报纸衬线 · Newsprint Serif

一个 DSH 主题插件，把 Typora newsprint 主题的报纸排版气质搬进 DSH Web GUI。纯 CSS，无 hooks，无图片资产。

亮色

- 亮色 — 暖白纸张 #f5f3ed，墨色正文 #1f0909，全篇只有一个海蓝强调色 #065588；中性色是一份 8 档暖纸阶，见下。
- 暗色 — 暖调暗色报纸：底色 #1a1815（暖褐黑，不是 #000，也不是蓝黑），暖白墨色 #ece7dd，强调色提亮为 #5aa9d6。报纸性格保留，不是官方中性黑的直接落地。
- 正文 — 整套换成衬线栈：Georgia → PT Serif → 思源宋体 → 宋体。

配色

两套方案共用同一套角色名（paper. 是「从最浮起到最硬的线」的表面阶，ink. 是「从最强到最装饰」的墨阶），颜色收敛在 lib/client.js 的 SCHEMES，改一个值全局跟着走。token 映射写成 buildTokens(scheme)，两套方案各生成一份，角色名不重复。

暖纸阶（SCHEMES.light.paper）：

| 档 | 值 | 用途 |
| --- | --- | --- |
| raised | #fdfdfa | 输入框、卡片、选中的代码页签 |
| base | #f5f3ed | 应用底色与阅读面 |
| stripe | #efeadd | 斑马行、渐变收尾 |
| container | #ebe7de | 侧栏、气泡、代码块面板 |
| emphasis | #e0dbcf | 表头、行内代码、悬停行、滚动条 |
| selected | #d7d0c0 | 选中行、多选高亮 |
| rule | #cfc8b8 | 细线、滚动条槽 |
| ruleDeep | #b3a996 | 滚动条悬停 |

暖暗纸阶（SCHEMES.dark.paper），角色顺序与亮色一致，方向相反：

| 档 | 值 | 用途 |
| --- | --- | --- |
| raised | #262320 | 输入框、卡片、选中的代码页签 |
| base | #1a1815 | 应用底色与阅读面 |
| stripe | #1f1d19 | 斑马行、渐变收尾 |
| container | #221f1b | 侧栏、气泡、代码块面板 |
| emphasis | #2b2823 | 表头、行内代码、悬停行、滚动条 |
| selected | #332f29 | 选中行、多选高亮 |
| rule | #3d3831 | 细线、滚动条槽 |
| ruleDeep | #4e483e | 滚动条悬停 |

墨阶（括号内为对各自 base 的对比度）：

| 角色 | 亮色 | 暗色 |
| --- | --- | --- |
| 正文 primary | #1f0909 (17.2:1) | #ece7dd (14.4:1) |
| 次级 secondary | #5a5049 (7.1:1) | #b8b0a4 (8.3:1) |
| 弱化 primaryDimmed | #6b6156 (5.5:1) | #a49c90 (6.5:1) |
| 三级 tertiary | #776c62 (4.6:1) | #948c80 (5.3:1) |
| 题注 caption | #948a7e (3.0:1) | #7d766c (3.9:1) |
| 装饰 dimmed | #c3bbae | #57514a |

唯一强调色是海蓝，亮色 #065588（7.1:1），暗色提亮到 #5aa9d6（6.8:1）——同一个色相，只是暗底上必须提亮度才读得出来。品牌色和主按钮用墨色；悬停方向随方案反转：亮色加深（#3f2d22），暗色提亮（#f7f4ec），因为填充按钮的悬停要更清晰、不是更浑浊。绿 / 琥珀 / 红一律降饱和到印刷油墨档。

三条硬约束：中性色必须落在暖阶里——纯中性灰（r=g=b）放在暖纸上会显脏，放在暖暗底上会发蓝；半透明色一律由 alpha() 从当前方案的墨色派生，不手写 rgba；题注档（约 3–4:1）只用于元信息，不得用于正文。

暗色不是亮色的机械反转：底色是暖褐黑而非 #000，墨色是暖白而非 #fff，暗阶间距比亮阶更宽（约 1.6 vs 1.1 亮度），因为暗色表面在感知上会被压缩，等距会糊成一片。

安装

本插件独立，不依赖任何市场、皮肤中心或第三方商店——它就是一个普通的 profile bundle，只用 dsh plugin 装。

从仓库装
dsh plugin --profile web add github:2754LM/dsh-theme-newsprint

或装预构建包（不拉整个仓库）
dsh plugin --profile web add https://github.com/2754LM/dsh-theme-newsprint/releases/latest/download/dsh-theme-newsprint.tgz

装完刷新页面；若主题没出现，重启一次 dsh（bundle 列表在启动时读取）。

开发

改配色的最快路径：只改 lib/client.js 里的 SCHEMES。两套方案共用 buildTokens() 的角色映射，所以一个角色只改一处。

改完刷新浏览器即可。插件的  是客户端挂载时注入的，profile 默认 patchReload: live，所以普通刷新就生效，不需要重启 dsh；只有改动 bundle 列表（package.json 的 dsh.profile.bundles）或增删插件时才需要重启。

回归测试在真实浏览器里校验两套方案（含排版笔画与 token 翻转），需要本机有 Chrome：

npm test

若 ws 不在本包旁边，用 DSH_ROOT 指向任一带 ws 的 checkout（脚本会从它的 pnpm store 里找）：

DSH_ROOT=/path/to/deepseek-harness npm test

启用 / 停用 / 卸载

- 停用 / 重新启用：编辑 ~/.dsh/profiles/web/cordis.patch.yml

- id: newsprint
disabled: true    # true = 停用；false 或删掉这一行 = 启用

加载器会热重载。装上但未启用时，DSH 整页与官方主题完全一致，没有任何排版泄露。
- 卸载：

dsh plugin --profile web remove dsh-theme-newsprint

多主题并存：同时启用两个主题会互相叠加，只留一个启用，其余写上 disabled: true。

它带来了什么

报纸版面的性格不在配色上，而在笔画上。除了把两档配色整套换掉，正文排版也按报纸重做（笔画规则与方案无关，亮暗共用；颜色走 --newsprint-* 私有 token，故换档时自动跟着变）：

| 元素 | 处理 |
| --- | --- |
| h1 | 下方一条 1px 细线，常规字重，上方留 2em |
| h3 | 回到常规字重 — 对比交给 h1/h2，而不是逐级加粗 |
| blockquote | 5px 粗左边框 + 斜体 + 弱化墨色 |
| thead th | 大写 |
| tr:nth-child(even) | 斑马行 |
| hr | 只留一条 1px 底线 |
| 链接 | 静止无下划线，悬停才出现 |
| 代码块 | 用官方 --dsw-alias-markdown-code-block，加 1px 下边线隔开 banner |
| 行内代码 | 用官方 --dsw-alias-markdown-inline-code |
| 任务列表 | checkbox 留 0.5em 右内边距 |
| 图片题注 | 暗砖红调（私有 --newsprint-image-caption） |

字体穿透到正文走两条路：

1. body 上设 font-family: var(--dsw-font-family)（chrome 走这条）；
2. [data-dsh-part='message-body'] 和 [data-chat-anchor-key] 上显式再设一次（markdown 走这条），不赌 DSH 内部那条 var(--dsw-font-markdown-base-font-family) 链路以后会不会被重构掉。

锚点选的是稳定属性（[data-chat-anchor-key] / [data-dsh-part='message-body'] / .md-code-block / [data-code-block-banner]），不选 .markdown 哈希类（那玩意编译后会变 _markdown_，字面量选择器永远落空）。

形态

cordis 埋点插件：package.json 里声明 dsh.bundle.patch（自带 cordis.patch.yml，插入 loader 条目 id: newsprint）与 dsh.client（web 平台）。不依赖 @deepseek-ai/dsh-client-ui-theme 运行时，也不调 ctx.theme.register()，没有任何市场侧或皮肤中心的运行时依赖。

宿主半边 apply() 是空实现；client 半边只做一件事：往  塞一个 （亮档 token + 暗档 token + L3 排版），并在 html 上加 dsh-newsprint-active 类把作用域限住；fiber dispose 时移除 class 与 。

好处是抗 DSH client 拓扑变更——dsh-client-runtime 被拆成 controller 那次（0.1.5-rc.2），所有走 ctx.theme 的主题插件都翻车了；本插件只往 DOM 注 CSS，免疫。代价是拿不到主题运行时那套亮/暗档切换 API，于是暗档由 CSS 自己判：DSH 把 data-ds-dark-theme 写在  上（ui-theme 的 boot-theme.ts），本插件就用属性选择器分流，不去订阅任何主题服务。这也是为什么两个方案的规则必须小心处理特异性：data-ds-dark-theme 的暗色块与亮色块同特异性，只能靠 :not() 与显式属性选择器分流。

许可

MIT。字体均调用系统已有的字族，不内嵌任何字体文件。