FelixJiashengFu/dsh-preview-theme

预览配色（dsh-preview-theme）

给 DeepSeek Harness 的侧边栏文档预览换纸张底色：PDF、Word（docx/doc，经 LibreOffice 转 PDF）和 Excel（xlsx/xls/csv/tsv）都能一键变成「黑底白字」，也可以选护眼米黄、豆沙绿、淡蓝、午夜蓝等， 或者用取色器调任意颜色。只改显示，不改文件——所有改动都是浏览器里的 CSS，原文件一个字节都不会动。

纯黑（黑底白字） · 护眼米黄 ·

Excel 黑色 · Excel 淡蓝 ·

支持的文件类型

格式 · 预览方式 · 是否支持 .pdf · 内置 pdf.js 画布 · 支持 .doc / .docx · Host 用 LibreOffice 转成 PDF 后走 PDF 预览 · 支持 .ppt / .pptx · 同上（转 PDF） · 支持 .xlsx / .xls · FortuneSheet 表格（浏览器内解析） · 支持 .csv / .tsv · 表格预览（切到纯文本时不套用配色） · 支持 图片 / Markdown / 代码 / HTML · 其它预览器 · 不在本插件范围

安装

从 npm 安装

在 DSH 的「插件」页面选择「添加插件」/「安装第三方插件」，输入 dsh-preview-theme 并安装、启用。 如果界面没有立即变化，刷新页面。也可以在完全退出 DSH 后，用其 CLI 安装：

dsh plugin --profile desktop add dsh-preview-theme

然后重新启动 DSH。Web 配置请把 desktop 换成 web。卸载时使用 dsh plugin --profile desktop remove dsh-preview-theme。

从本地源码安装

将仓库克隆到一个稳定位置，例如 ~/.dsh/plugins/dsh-preview-theme，然后在插件页面输入该目录的 绝对路径，或用 CLI 执行 dsh plugin --profile desktop add /绝对路径/dsh-preview-theme。 本地路径安装会链接该目录，因此安装后不要移动或删除它。

使用

打开右侧边栏里的 PDF / Word / Excel 预览，预览标题栏（路径那一行）最右边会多一个调色盘按钮：

• 点开就是配色面板：原色 / 纯黑 / 墨黑 / 深灰 / 午夜蓝 / 墨绿 / 护眼米黄 / 豆沙绿 / 淡蓝 / 淡粉 / 自定义；
• 「自定义」用系统取色器选任意颜色，深色自动变黑底白字、浅色自动变浅底深字；
• 深色方案多一个亮度滑杆（70%–120%），觉得白字太亮可以调暗；
• 选过的配色会记住（localStorage），重启/刷新后仍然生效；
• 点「原色」或「恢复默认」就完全还原成默认外观。

改动是全局预览配色：换一个文件、换一个标签页都沿用；想只临时看一个文件时，看完点回「原色」即可。

配色表

名称 · 色值 · 效果 原色 · — · 关闭插件效果（白色纸张 + 浅灰底） 纯黑 · #000000 · 纯黑纸、白字 墨黑 · #0b0f14 · 近黑（偏冷） 深灰 · #1f2126 · 炭灰纸、浅字 午夜蓝 · #101b2d · 深蓝纸、白字 墨绿 · #101f17 · 深绿纸、白字 护眼米黄 · #f4ecd8 · 米黄纸、黑字 豆沙绿 · #cce8cf · 护眼绿纸、黑字 淡蓝 · #dbe7f5 · 淡蓝纸、黑字 淡粉 · #f6e3e5 · 淡粉纸、黑字 自定义 · 任意 · 按亮度自动选深色/浅色方案

原理（为什么不用改预览器）

内置预览包 @deepseek-ai/dsh-client-ui-sidebar-documentpreview 在 DOM 上留了稳定的 data-* 钩子：

• [data-textpreview-body]：预览滚动区；
• [data-pdf-preview]：PDF / Word / PPT 的页面容器（每页是一个 canvas + 透明文字层）；
• [data-excel-preview]：表格容器（FortuneSheet 画布 + 公式栏 + 工作表标签）。

本插件做两件事：

1. 纸色：覆盖主题 token --dsw-alias-bg-document-preview（通过 ctx.theme.overrideTokens，

官方扩展点，写成 body 内联变量，不跟内置样式抢优先级）；

1. 页面内容：

• 浅色纸：给 canvas（PDF）/ 表格子元素（Excel）加 mix-blend-mode: multiply —— 白纸乘上纸色变成纸色，黑字仍是黑字；
• 深色纸：先 filter: invert(1) hue-rotate(180deg) 把白纸/黑字翻成黑纸/白字，再 mix-blend-mode: screen

把页面底色染成所选深色（白色文字保持不变）。hue-rotate(180deg) 让图表和图片的颜色尽量保持原色相。

插件只注册一个标题栏按钮（文档预览的 sidebar.right.tab.document.actions 槽位）和一段样式表， 关掉/卸载后样式与 token 覆盖都会被清理干净。

限制

• 只影响内置预览。「近期成品」等其它位置里用系统 PDF 查看器 iframe 显示的 PDF 不在可样式化范围内。
• 深色方案会反转文档里的图片/图表颜色（hue-rotate 只能近似还原色相），这是所有「反色阅读模式」的通病。
• Excel 是整块画布渲染，深色模式下公式栏、工作表标签会跟着一起反色（通常正是想要的效果）；不支持只改单元格区域。
• 预览的 data-* 属性属于 DSH 内部实现，升级 DSH 大版本后如失效，重新适配即可（test/check-bundle.mjs 可做冒烟检查）。

开发与验证

node test/check-bundle.mjs # 无需浏览器：校验 bundle 契约、样式选择器、槽位注册 node --check lib/client.js # 语法检查

客户端半边修改后是热重载的（安装后 <1s 生效）；Host 半边是空实现，不需要重启。

目录

dsh-preview-theme/ package.json # dsh.bundle.patch + dsh.client（无构建步骤） cordis.patch.yml # Host 行（空实现，只为让 Loader 挂载并下发 client bundle） lib/index.js # Host 半边：空 apply lib/client.js # 全部功能：样式、token、标题栏按钮、配色面板（纯 React.createElement） locale/{zh,en}.json # 插件管理里显示的名称/描述 icon.svg # 插件图标 docs/*.png # 效果图 test/check-bundle.mjs # 静态冒烟测试 README.md # 本文件