前言¶

在 DeepSeek Harness 里看 PDF、Word 或 Excel，默认多是白底黑字。长时间盯侧边栏预览，有人更习惯黑底白字，有人想要护眼米黄或豆沙绿。系统级反转整屏并不只作用于预览区，也不区分 PDF 和表格。下面介绍社区插件 dsh-preview-theme：只改内置文档预览的显示配色，不动磁盘上的原文件。

这是什么¶

dsh-preview-theme（npm 包名同名）由维护者 FelixJiashengFu 发布，在 SkillHub 目录中归类为「趣味换装」。一句话定位：给 DSH 右侧边栏文档预览换纸张底色，支持 PDF、经 LibreOffice 转 PDF 的 Office 文档，以及浏览器内解析的 Excel / CSV 等表格预览。

英文简介为：Document preview color themes for DeepSeek Harness: PDF, Office, and spreadsheets. 当前 package.json 版本为 0.1.0，许可证 MIT，要求 DSH 引擎 >=0.2.0-rc.1 <0.3.0-0。

支持的预览类型¶

图片、Markdown、代码、HTML 等走其它预览器，本插件不覆盖。

核心功能¶

预设与自定义配色¶

预览标题栏（路径那一行）最右侧会出现调色盘按钮。点开配色面板可选：

• 原色 / 纯黑 / 墨黑 / 深灰 / 午夜蓝 / 墨绿 / 护眼米黄 / 豆沙绿 / 淡蓝 / 淡粉 / 自定义

「自定义」用系统取色器选任意颜色：深色自动黑底白字，浅色自动浅底深字。深色方案另有亮度滑杆（70%–120%），可微调白字刺眼程度。选过的配色写入 localStorage，刷新或重启 DSH 后仍生效；点「原色」或「恢复默认」恢复默认外观。

配色是全局预览主题：换文件、换标签页会沿用同一套纸色；若只想临时看某一文件，看完点回「原色」即可。

只改显示，不改文件¶

所有效果都是浏览器里的 CSS（含 token 覆盖与 blend / invert 组合），原文件一个字节都不会动。

实现要点（便于排查）¶

插件依赖内置包 @deepseek-ai/dsh-client-ui-sidebar-documentpreview 在 DOM 上留下的 data-* 钩子，例如 [data-pdf-preview]、[data-excel-preview] 等。纸色通过 ctx.theme.overrideTokens 覆盖 --dsw-alias-bg-document-preview；页面内容对 canvas / 表格子元素使用 mix-blend-mode，深色纸则配合 filter: invert(1) hue-rotate(180deg) 与 screen 混合。卸载或关闭后样式与 token 覆盖会被清理。

安装与启用¶

插件以当前 DSH 进程权限运行；安装前建议在 GitHub 查看源码与 MIT 许可证，确认符合你的环境策略。

从 npm 安装¶

在 DSH「插件」页选择「添加插件」/「安装第三方插件」，输入包名 dsh-preview-theme 安装并启用。界面未立刻变化时可刷新页面。

桌面版也可用 CLI（Web 配置把 desktop 换成 web）：

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

安装后重新启动 DSH。卸载：

dsh plugin --profile desktop remove dsh-preview-theme

从本地源码安装¶

将仓库放到稳定目录（例如 ~/.dsh/plugins/dsh-preview-theme），在插件页填写该目录绝对路径，或：

dsh plugin --profile desktop add /绝对路径/dsh-preview-theme

本地路径安装会链接该目录，安装后不要移动或删除它。资料中的本地安装步骤涉及克隆仓库；本文不展开 clone 操作，仅保留上述路径与 CLI 用法。

客户端 bundle 修改后支持热重载（资料称安装后小于 1 秒生效）；Host 半边为空实现，无需为此重启 Host。

典型用法¶

1. 安装并启用 dsh-preview-theme，打开右侧边栏中的 PDF、Word 或 Excel 预览。
2. 在预览标题栏最右侧点击调色盘，选择「纯黑」「护眼米黄」等预设，或「自定义」用取色器选色。
3. 深色方案下按需拖动亮度滑杆；需要恢复默认时点「原色」。

预设色值示例（完整表见仓库 README）：

适用场景与限制¶

适合谁：经常在 DSH 侧边栏里读 PDF、Office 转 PDF 预览、或 FortuneSheet 表格预览的开发者；需要快速切换黑底白字、护眼色，且不希望改源文件。

限制（README 原文要点）：

• 只影响内置预览。「近期成品」等位置里用系统 PDF 查看器 iframe 显示的 PDF 无法被本插件样式化。
• 深色方案会反转文档内图片/图表颜色（hue-rotate 只能近似还原色相），这是反色阅读模式的常见代价。
• Excel 为整块画布渲染，深色模式下公式栏、工作表标签会一起反色；不支持只改单元格区域。
• 预览用的 data-* 属性和 DSH 内部实现绑定，大版本升级后若失效需重新适配；仓库提供 node test/check-bundle.mjs 做静态冒烟检查。

DSH 生态强调「一切皆插件」；SkillHub 目录页是社区站点，与 DeepSeek / 幻方无官方从属关系，本文介绍的插件同样来自社区维护者。

结尾¶

dsh-preview-theme 把侧边栏 PDF / Office / 表格预览的纸色做成可切换主题，预设加自定义，记忆上次选择，且不改磁盘文件。需要安装命令、配色表与原理细节时，可直接看仓库 README。

• 目录页：https://www.skillhub.cn/plugins/FelixJiashengFu/dsh-preview-theme
• GitHub：https://github.com/FelixJiashengFu/dsh-preview-theme