dsh-theme-quartet

主题四合 · dsh-theme-quartet

给 DeepSeek Harness（DSH）桌面版 Web 界面用的换肤插件。四套预设皮肤，一个悬浮换肤面板，明暗自动跟随。

不修改宿主源码、不替换渲染逻辑：只叠一层设计令牌（--dsw-alias-* / --dsw-specific-*）+ 一层装饰 CSS。

四套皮肤

每套都写了 light / dark 两套色板，切换宿主明暗时自动换值。

截图来自 preview.html 的宿主替身，不是 DSH 真实界面；装进 DSH 后布局由宿主决定，配色与底图一致。

安装

一条命令

dsh plugin --profile web add dsh-theme-quartet

装完完全退出并重启 DSH。右下角出现换肤圆钮，Alt + Shift + S 也能开关面板。

想锁死某个版本、或不想走 npm，可以直接装 GitHub Release 里的 tgz：

dsh plugin --profile web add "https://github.com/RZ-0410/dsh-theme-quartet/releases/download/v0.1.0/dsh-theme-quartet-0.1.0.tgz"

方式一：本地一键脚本

node tools\install.mjs

脚本做三件事，都是幂等的：

1. 把整个包复制到 %USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-theme-quartet；
2. 在 cordis.patch.yml 里补一条 insert: theme-quartet（已有就跳过）；
3. 打印需要重启的提示。

然后完全退出并重启 DeepSeek Harness（loader 组合变了，必须重启；之后改 bundle 只需刷新页面）。

方式二：手动安装

1. 复制 dsh-theme-quartet 文件夹到 %USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-theme-quartet
2. 在 %USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml 末尾追加：

- insert:
    - id: theme-quartet
      name: dsh-theme-quartet

3. 重启 DSH。

方式三：CLI（若 dsh 在 PATH 里）

dsh plugin --profile desktop add "<本目录绝对路径>"

使用

• 右下角圆钮：点开换肤面板，2×2 卡片点选即生效；圆钮本身显示当前皮肤的画面。
• Alt + Shift + S：开关面板。
• 面板打开时按 1 / 2 / 3 / 4：直接切到对应皮肤。
• 双击圆钮：恢复原生外观，并把圆钮位置复位。
• 拖动圆钮：位置会被记住，方便避开右下角的其它悬浮控件。
• 恢复原生外观：面板底部按钮，整层令牌摘掉，界面回到未装插件的样子。

选择存在 localStorage（键 dsh-theme-quartet.skin），不进 DSH 的设置文档。

为什么不写进「设置 → 主题」

DSH 的主题偏好字段有白名单，只接受 light / dark / system，自定义主题 id 存不进去（写进去也会在下次读取时被回滚）。所以皮肤选择由插件自己持久化，面板标题仍是「主题皮肤」，入口在右下角而不是设置页。

如果以后宿主开放自定义主题注册，把 SKINS 注册成主题即可，令牌表可以直接复用。

与其它皮肤插件共存

同一套令牌层被多个插件覆盖时，后注册的那层逐令牌胜出。同时装 dsh-joi-channel-theme 之类的皮肤，会出现"一半这套、一半那套"的混色。建议一次只启用一个皮肤插件；关掉本插件的方式是从 cordis.patch.yml 移除那三行。

自定义

node build.mjs

• 色板、圆角、装饰层：src/skins.mjs（唯一数据源，预览页与插件共用）。
• 面板 UI：src/client.template.js 里的 UI_CSS。
• 底图：替换 assets/<slug>.webp，或用 tools/compress.py 从原始 PNG 重新裁切压缩（会自动切掉生成器水印条）。

产物：

• lib/client.js — 浏览器半边（自包含，无运行时依赖，底图以 data URI 内嵌）
• preview.html — 离线预览页，不装插件也能看四套皮肤

目录结构

dsh-theme-quartet/
├─ package.json          # dsh.bundle.patch + dsh.client 声明
├─ cordis.patch.yml      # 往 loader 组合里插一行
├─ lib/
│  ├─ index.js           # 宿主半边：空 apply，只负责"让包出现在 entries 里"
│  └─ client.js          # 浏览器半边：令牌覆盖 + 装饰 CSS + 换肤面板
├─ src/                  # 源码（色板 / 客户端模板 / 预览模板）
├─ assets/               # 压缩后的底图（WebP，合计约 300 KB）
├─ tools/                # 压缩脚本、安装脚本、冒烟测试页
└─ preview.html          # 离线预览

实现要点

• 令牌通过 ctx.theme.overrideTokens("dsh-theme-quartet", tokens) 叠层，ctx.effect 负责在插件卸载时整层摘除；换肤时用同一个 source 再调一次即可替换（不闪原生色）。
• 底图只画在 [data-conversation-scroll] 上，用 90° 渐变做「中间纸面、两侧透气」的纱幕；侧栏、输入框、代码块保持各自的不透明表面，长文阅读不受影响。
• 面板用 Shadow DOM 隔离，宿主 CSS 进不来，面板样式也漏不出去；配色仍读 --dsw-alias-*，所以面板自己也会跟着皮肤变。
• 没有主题服务时降级为 body 上的 !important 变量表，功能不缺，只是换肤动画会少一点。

已验证环境

• DeepSeek Harness 桌面版（E:\aadsh），profile desktop，令牌体系 --dsw-*
• Edge / Chromium（color-mix、backdrop-filter、Shadow DOM 均可用）
• 冒烟测试：tools/smoke.html（宿主替身，验证挂载、79 个令牌覆盖、四张卡片切换）

已知限制

• 底图在宽窗口中会被正文列挤到两侧，角色只露出边缘 —— 这是为了保证正文可读性做的取舍。想要更强的人物存在感，可以调低 src/skins.mjs 里 normalize() 的 veil 透明度，代价是文字对比度下降。
• 面板位置按像素记忆，换到更小的窗口会被夹回可视区。
• 主题层的最终解释权在宿主：DSH 大版本改动 --dsw-* 令牌名时，需要同步 src/skins.mjs 的映射表。

许可

MIT。底图由本插件自行生成（AI 绘制），随包分发。