前言¶
DeepSeek Harness（DSH）桌面端与 Web 客户端都支持通过插件扩展界面。若只想换配色、背景或侧栏品牌位，而不动核心逻辑，常见做法是改 CSS 或 fork 主题仓库，维护成本高，且升级 DSH 时容易冲突。Traveritas 维护的 averita-dsh-theme-inspiration（npm 包名 dsh-theme-averita，当前版本 0.7.1，MIT）是一套纯客户端主题插件：四套完整主题、点阵或流光背景、品牌位与新会话首屏等模块均可单独开关，适合当作「做自己的 DSH 皮肤」的参考实现或直接日常使用。
这是什么¶
- 定位：DSH 主题宿主插件；README 自述为轻量主题插件，分享个性化 DSH 的灵感，可随意取用或魔改。
- 维护者：Traveritas；同系列插件见 AveritA 的 DSH 插件目录。
- 社区目录：skillhub.cn 插件页（分类：趣味换装；与 DeepSeek / 幻方无官方从属关系，仅为社区收录）。
- 运行形态：Host 半
index.js为空壳；浏览器半为client.js（手写 lazy-CJS，无构建依赖）。样式与令牌通过ctx.effect挂载，卸载后在管理器移除即可，README 说明不会残留。
核心功能¶
四套主题¶
在 设置 → 主题 中即时切换，选择保存在 localStorage；切换通过 overrideTokens 换令牌图层，并用 html[data-av-theme] 换 CSS 变量，无需重装或重启 DSH。
| 主题 ID | 名称 | 数据文件 |
|---|---|---|
averita |
昼雾 · 靛夜 | src/tokens.js |
coldmorning |
冷晨 | src/themes/coldmorning.js |
duskrose |
暮玫瑰 | src/themes/duskrose.js |
duskpurple |
暮紫 | src/themes/duskpurple.js |
每套主题含 205 个令牌（浅/深成对）：128 个语义/语法令牌 + 77 个静态色板阶（--dsw-static-*）；主题变量仅 --av-space / --av-dot / --av-mark 三枚。README 实机截图基于 DSH 0.2.1-rc.3 · Windows。
README 推荐配套字体：正文「Source Serif 4」「霞鹜文楷」；代码「Hurmit Nerd Font Mono Light」「Microsoft YaHei」。
背景（二选一）¶
- 点阵：圆点 / 方块 / 字符 / 字符墙；缩放、浓淡、动效、呼吸下限可调；实现于
src/components/dots/style.css的 fixed 伪元素，不跑逐帧动画。 - 流光：WebGL2 画布（
src/flow.js，构建时内联），1/5 分辨率、30fps，仅在选择流光时创建；默认从当前主题取色，另有四套固定色板；缩放、浓淡、速率可调；明暗默认反转（浅色下白做底、深色只落在光带上）。
点阵与流光互斥。
品牌位、新会话与装饰¶
- 品牌位：
sidebar.brand.mark/sidebar.brand.name两个 single slot，priority-1（低于官方 0）。默认 32px 三轴正交六芒星 + 衬线字标AveritA's DSH；设置 → 主题 → 品牌字标 可改，留空只显示图标。 - 新会话首屏：
conversation.hero.brand.mark使用同一颗星（34px）；标题可自定义，「预览版」徽章隐藏。 - 装饰：用户消息与输入框支持纸品或星芒等样式；输入框底衬默认去掉（背景透到输入框后），可在 设置 → 主题 → 输入框底衬 开回 DSH 渐隐。
主题覆盖总开关¶
设置 → 主题 → 主题覆盖 提供四个区域总开关：品牌位 / 新会话 / 装饰 / 背景，默认全开；关闭后对应区域完全不覆盖，回退 DSH 原生。品牌位与新会话模块内另有「图标是否换成星标」开关。
UI 动效¶
过渡使用 --ds-transition-*（180/120ms + 柔出曲线）；位移动效包括会话切换上浮 6px、会话行 hover 横移 2px、按钮按下 0.5px、最后一条回复上浮 6px、侧栏折叠 300ms 等（详见 README）。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前请自行审阅 GitHub 仓库 源码与 MIT 许可证。
README 给出的步骤如下。
1、将仓库克隆到本机任意目录（示例路径可替换为你的环境）：
git clone --depth 1 https://github.com/Traveritas/averita-dsh-theme-inspiration.git D:\dsh\averita-dsh-theme-inspiration
2、打开 DSH 设置 → 插件 → 添加插件，在 spec 中填写克隆目录的绝对路径（已 clone 过的目录也可在管理器中直接选择）。管理器会 pnpm link 进 profile 并写入 dsh.profile.bundles；若返回的 application 为 applied 即生效，若为 restart-required 则需完全退出桌面端再启动。
桌面端的
desktopprofile 由 Electron 独占，dsh plugin --profile desktop ...会被拒。桌面端只走应用内插件管理器；其它 profile 可使用dsh plugin --profile <名字> add "link:<绝对路径>"（路径含空格时需加引号）。
3、装好后进入 设置 → 主题 切换主题、调整背景与字标，并按需配置「主题覆盖」各总开关。
典型用法¶
在客户端里日常切换¶
经过上面的安装步骤后，在 设置 → 主题 选择四套主题之一，在同一面板调整点阵/流光、底衬、品牌字标、新会话首屏文案等；「主题覆盖」用于快速回退原生品牌、首屏、装饰或背景。
本地预览（不依赖 DSH）¶
仓库内提供近似 DSH 三栏骨架的预览页，用于看配色与比例（字体、间距与实机有差异，以实机为准）。用浏览器打开仓库中的 preview/index.html，左下角可切换主题与背景参数；亦可通过 URL 查询参数直达，例如：
?theme=coldmorning— 冷晨主题?bg=flow— 流光背景?dark=1— 深色模式
完整参数列表见 README「预览」一节。实机首屏截图位于 preview/shots-new/a-l.png … d-d.png（四套 × 浅/深）。
魔改与参考¶
令牌与主题数据在 src/tokens.js 与 src/themes/；组件样式在 src/components/*/style.css。README 说明预览页 DOM 与真实 DSH 结构同构（如 data-composer-seat、_bubble 等），便于在浏览器里验证选择器后再在 DSH 中启用。
卸载¶
在 设置 → 插件 的同一管理器中移除即可；README 说明样式与令牌挂在 ctx.effect 上，卸载后不残留。
适用场景与注意¶
- 适合：希望多套成套配色、可调背景与品牌位，且需要「一键回退原生 UI」的 DSH 用户；也需要一份可拆模块的主题插件示例的开发者。
- 注意：插件注入
@deepseek-ai/dsh-client-ui-theme等客户端 UI 包（见package.json的dsh.client.inject），需与当前 DSH 客户端版本兼容；README 实机说明针对 DSH 0.2.1-rc.3，升级 DSH 后若异常应核对插件版本（当前 0.7.1）与 release 说明。 - 许可：MIT；GitHub 仓库当前约 1 star（以仓库页为准）。
结尾¶
averita-dsh-theme-inspiration 把四套主题、点阵/流光背景、品牌与新会话覆盖、装饰与动效收进一个纯客户端插件，并通过「主题覆盖」保留回退原生界面的能力。若要安装或查看配色细节，可访问社区目录页与 GitHub 仓库：
- 目录页：https://www.skillhub.cn/plugins/Traveritas/averita-dsh-theme-inspiration
- 仓库：https://github.com/Traveritas/averita-dsh-theme-inspiration
