前言¶

DeepSeek Harness（DSH）支持通过插件扩展桌面壳行为与界面表现。社区里已有换肤、视频背景等「趣味换装」类插件，但多数仍沿用官方浅色主题的明暗关系。官方主题里主区、卡片、面板等多层背景都落在同一 #fff，侧栏与主区仅差约 2% 明度，表格、会话行、回答状态条等细节也偏「靠眼力分辨边界」。若你长时间在 DSH 里读对话、看表格和代码块，这类结构性扁平会放大疲劳感。

dsh-reading-comfort（维护者 chaizedong73-arch）针对上述问题：用纯 CSS、一次 DOM 标记和从官方图标抠出的头像，把配色与几何对齐到对 WorkBuddy 截图的像素级测量结果，不改布局结构、不注入可见 DOM、零运行时依赖。分类上属于社区目录中的「趣味换装」；仓库当前星标为 0，许可证 MIT，版本 0.1.0（见 package.json）。

这是什么¶

一句话：给 DSH 换一套阅读舒适度更高的浅色皮肤，设计令牌来自 WorkBuddy 逆向规格，而非随意调色。

插件通过 Cordis patch 向 webserver/index-inject 注入样式与引导脚本，并注册三条热加载路由（comfort.css、runtime.js、logo.png）。深色模式不修改，保持官方原样。

它具体改了什么¶

README 将改动归纳为以下几块（均可在仓库演示页 docs/index.html 对比「原生 dsh ⇄ WorkBuddy 皮肤」）：

设计侧三条原则在文档中写得很明确：底色饱和度不超过 24%；尽量不用边框分块（侧栏与主区可无分隔线，靠底色差）；焦点区域用「最亮 + 最大圆角」（输入框为全界面唯一纯白处）。

安装与启用¶

资料中的安装方式不是 dsh plugin add，而是将插件目录放到本地后执行 PowerShell 安装脚本，并完全重启 DSH。

1、把仓库放到任意目录，例如 ~/.dsh/plugins/dsh-reading-comfort。

2、执行安装（desktop 为 profile 名，按你的环境调整）：

powershell -ExecutionPolicy Bypass -File install.ps1 -Profile desktop

install.ps1 会：在 package.json 里写入 dependencies["dsh-reading-comfort"] = "link:<本目录>"；把包追加进 dsh.profile.bundles；在 node_modules/ 下建立 junction，并留下备份。

3、完全退出并重开 DeepSeek Harness，首次安装后皮肤才会生效。

环境要求：package.json 声明 node >= 22。

典型用法与调参¶

改 CSS / JS / logo 后如何生效¶

启动时注入的引导脚本极简且不变；每次页面加载会从本地 web 服务拉最新资源：

• /dsh-reading-comfort/comfort.css
• /dsh-reading-comfort/runtime.js
• /dsh-reading-comfort/logo.png

因此：第一次安装需重启 DSH；之后改 CSS、JS 或 logo，刷新页面即可。

在 comfort.css 顶部调 :root¶

所有可调数字集中在 comfort.css 最上面的 :root，例如：

:root {
  --dsrc-base-alpha:    1;
  --dsrc-sidebar-alpha: 1;

  --dsrc-base-rgb:    245 248 245;
  --dsrc-sidebar-rgb: 228 236 229;
  --dsrc-selected-rgb:213 229 214;
  --dsrc-bubble-rgb:  233 241 233;

  --dsrc-accent: var(--dsrc-brand-ink);
  --dsrc-blue:   #2d6cfe;

  --dsrc-head-name:    "DeepSeek";
  --dsrc-head-avatar:  30px;
  --dsrc-head-gap-bot: 26px;
}

若配合 dsh-video-skin 等让壁纸或视频透出，可将 --dsrc-base-alpha、--dsrc-sidebar-alpha 调到约 0.9。文档说明本插件选择器特异性高于 video-skin，此处参数优先生效。点睛色默认 WorkBuddy 绿，可改为 var(--dsrc-blue) 切换蓝色强调。

回答头显示名可通过 --dsrc-head-name 修改；头像来自官方 resources/icon.png 处理后的 data URI，不依赖额外路由。

卸载¶

powershell -ExecutionPolicy Bypass -File uninstall.ps1 -Profile desktop

或手动恢复 install.ps1 生成的 package.json.<时间戳>.bak。

适用场景与注意¶

适合谁：主要在 DSH 桌面端长时间阅读对话、表格和代码的用户；希望浅色界面有清晰层级、侧栏与会话列表更易扫读，且接受 WorkBuddy 式低饱和绿灰配色的人。

权限与安全：插件以当前 DSH 进程权限运行，会修改 profile 下的 package.json、bundles 与 node_modules 链接。安装前应自行阅读仓库源码（index.js、runtime.js、comfort.css、cordis.patch.yml）并确认 MIT 许可证；社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，不代表官方认证。

兼容性：选择器针对 CSS Modules 类名与回答头文案（「已完成…用时」/ Completed in）做标记；DSH 大版本升级后若 DOM 或类名变化，可能需要作者或自行更新选择器。仅动浅色主题，深色仍走官方样式。

结尾¶

dsh-reading-comfort 用可验证的测量规格和最小注入面，把 DSH 浅色界面的明度阶梯、侧栏与会话区、回答头与输入焦点区拉回「能长时间看」的状态，并支持刷新即热更新样式。目录页：https://www.skillhub.cn/plugins/chaizedong73-arch/dsh-reading-comfort；源码与完整技术说明：https://github.com/chaizedong73-arch/dsh-reading-comfort。