DSH 护眼配色包：5 套低蓝光主题

前言¶

DeepSeek Harness（DSH）的配色系统通过语义 token 控制界面外观，但默认主题偏向冷色，长时间使用容易产生视觉疲劳。本插件提供一套覆盖 66 个 token 的低蓝光配色方案，通过官方扩展点动态注入，无需修改任何布局代码。

插件定位¶

dsh-warm-theme 是一个护眼主题包，由 yrsxy 维护，属于「趣味换装」分类。它不改变任何 DOM 结构，只覆盖颜色与材质 token，安装后立即生效，卸载即可还原。

核心能力¶

5 套配色方案，每套包含浅色与深色模式
覆盖 66 个语义 token：22 个基础色、19 个派生色、8 个残留色、17 个形状材质
支持 macOS 与 Windows 双平台
所有组合的对比度均达到 WCAG AA 标准（正文 ≥ 4.5:1，重点文本 ≥ 10.6:1）
持久化生效，跨重启保留，卸载无残留

安装与启用¶

从 npm 安装（推荐）：

dsh plugin --profile desktop add dsh-warm-theme

从 GitHub 安装：

dsh plugin --profile desktop add github:yrsxy/dsh-warm-theme

在插件市场搜索「护眼配色」也可一键安装。

启用方式：进入 DSH 设置 → 通用 → 配色主题，点选即可。选「跟随内置」可恢复原生配色。

配色方案¶

id	名称	底色	特点
`paper`	暖纸 Warm Paper	`#f6f1e7`	纸质书感，降蓝光最多
`sepia`	柔褐书页 Old Book	`#f2e8d5`	旧书页黄，层次分明
`tea`	茶褐 Tea Brown	`#f1e9e4`	偏红暖棕，最浓郁
`olive`	橄榄静绿 Quiet Olive	`#eff2e6`	最低存在感，最专注
`mist`	雾蓝 Mist Blue	`#eef1f4`	唯一冷调，最清醒

工作原理¶

DSH 的主题扩展点为 ctx.theme.overrideTokens(source, { '--dsw-alias-bg-base': { light, dark }, ... })。

本插件通过这个接口注册一层覆盖层，按顺序叠加到活动主题上，不修改内置主题。切换主题时会先撤销旧层再叠新层，任何时刻最多贡献一层。卸载插件时自动移除覆盖层，无残留。

Token 覆盖细节¶

基础色：画布、层次、文字、边框、链接、代码块等 22 个手工调校颜色
派生色：处理悬停态、通知浮层、提示气泡等容易与暖底冲突的位置，通过文字色做叠加源避免发灰
残留色：如 switch-thumb、border-l4 等原本为纯白或冷色的 token，本包统一用暖色系替换
形状材质：将圆角上调一档，阴影改为暖黑（浅色用文字色，深色用 #0a0806），过渡时长略放缓，滚动条宽度加粗

macOS 侧边栏的特殊处理¶

macOS 侧栏底色原本通过 CSS 规则置空以透出系统原生效果。本包用两条选择器补上同类效果：

[data-platform='darwin'] div[class*='_sidebarCol'],
div:has(> [data-window-drag]):not([data-window-drag]) {
  background: var(--dsw-specific-sidebar-fill);
}

第一条按类名匹配，第二条按结构反查，两者都命中时取值相同，重复无碍。这条规则不影响 Windows 原生布局。

适用场景与注意¶

适合长时间使用 DSH 进行智能体开发的用户
所有配色均通过官方扩展点注入，不依赖 fork 或重建前端
依赖 DSH 版本 >= 0.2.1-rc.2
安装前建议查看源码与许可证（MIT）
本插件以当前 DSH 进程权限运行，如遇异常可尝试卸载后重新安装

结尾¶

dsh-warm-theme 提供了一套完整、可逆的护眼配色方案，通过 token 级覆盖实现零布局改动、热生效。如需查看更多细节，可访问插件目录或 GitHub 仓库。