前言¶
DeepSeek Harness(DSH)的 Web 界面自带一套官方主题 token。若你长时间盯着默认配色,链接色、侧栏与纸面层次往往是一整块「产品默认脸」,和你在其它工具里习惯的克制排版不太一致。社区里有「趣味换装」类插件,用官方主题运行时叠一层自定义 token,不必改核心代码。
下面介绍 rockyzhz/dsh-signal-blue-theme:维护者 rockyzhz,在 SkillHub 目录中归类为趣味换装。它给 DSH Web 设计了一套瑞士风(Swiss Style)配色,强调色为信号蓝 #1B3BFF;仓库同时包含可安装的 DSH 主题插件,以及一页讲这套配色的静态发布页。
这是什么¶
一句话:在官方 ThemeRuntime 之上,用 overrideTokens() 覆盖品牌色阶与纸面、侧栏等字面量,并额外注入一层质感 CSS,把 DSH Web 收成「纸色 + 墨色 + 中性灰 + 单一强调色」的瑞士风骨架。
明暗模式仍由 DSH「设置 → 通用 → 外观」控制;主题插件与明暗是两根独立轴。界面上没有单独开关——插件在则配色在,卸载后回到默认。
视觉与版本¶
瑞士风做法固定层次:纸色、墨色、四档中性灰承担结构,主题只替换强调色。信号蓝落在链接、按钮、选中态等「需要说话」的位置;README 描述其观感像电流而非大面积铺光。
浅色(当前 v1.1.0 代号「冷白版 Cool Paper」)主区纸面 #F6F8FD,侧栏 #E8EDF8。深色底为 #0F1A35(深蓝夜底,与强调色同色相 265.9°),链接提亮为 #7AA3FF,README 注明在深蓝底上对比度可达 4.5:1 以上。
v1.0.0「暖纸版 Warm Paper」纸面为 #F7F4ED、侧栏 #F4EFE6,深色底同为 #0F1A35。细节见仓库 CHANGELOG.md。package.json 当前版本为 1.1.0。
侧栏当前项为 3px 直角蓝竖条加蓝字,与发布页示意图一致。插件还把圆角收到 2–12px、卡片阴影改为发丝线,字体栈优先 Inter,焦点环与 aria-current="page" 标记使用信号蓝。
核心实现(它改了什么)¶
插件走官方 ThemeRuntime 的 ctx.theme.overrideTokens(),分三步:
- 品牌色阶:
--dsw-static-deepseek-*十档全部换成信号蓝色阶(OKLCH 重建,色相 265.9°),官方别名多引用该色阶,链接、按钮、业务状态色整族跟随。 - 字面量别名:纸面、墨色文字、边框、代码块底、侧栏等硬编码值单独覆盖。
- 质感层:额外注入
<style>,处理圆角、阴影、字体与焦点环;卸载时一并移除。
README 写明共覆盖 60 个 token,并对关键组合做过 WCAG 2.1 对比度校验(例如 #1b3bff 在纸色 #fafaf8 上约 6.45:1)。
安装与启用¶
插件声明面向 Web profile(package.json 中 dsh.client.platform 为 web,immediately: true)。引擎要求:dsh >=0.2.1-rc.1,Node ^22.19.0 || >=24.0.0。
本地路径安装:
dsh plugin --profile web add /path/to/dsh-signal-blue-theme
从 GitHub 远端安装:
dsh plugin --profile web add "github:rockyzhz/dsh-signal-blue-theme"
装完后刷新页面即可生效,无需重启 DSH。卸载:
dsh plugin --profile web remove dsh-signal-blue-theme
典型用法与仓库形态¶
日常用法就是安装后刷新 Web 界面,在设置里切换浅色/深色,观察纸面、侧栏与链接是否符合预期。
除插件外,仓库还提供主题说明的静态产物:dsh-signal-blue.html 可在浏览器直接打开;dsh-signal-blue.png 为 1440 × 6878 整页长图。发布页纸色取 #FAFAF8,与插件界面纸色略有区分(静态文档更接近白纸)。若你维护仓库本身,可用:
node build.mjs
重建发布页(渲染器路径写在 build.mjs 的 SKILL 常量,换机器需改该行)。
适用场景与注意¶
适合:长期在 DSH Web 上工作、希望界面偏瑞士排版、单一强调色为信号蓝的用户;也属于目录「趣味换装」里不动业务逻辑、只改视觉的一类插件。
注意:
- 插件在当前 DSH 进程权限下运行,安装前请阅读
client.js等源码并确认 MIT 许可证可接受。 - 依赖 peer:
@deepseek-ai/cordis^4.0.0、@deepseek-ai/dsh-client-ui-theme^0.2.1-rc.1(在package.json中标为 optional peer)。 - SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系;星标数随时间变化,以 GitHub 页面为准。
结尾¶
dsh-signal-blue-theme 用官方主题扩展点叠一层信号蓝瑞士风配色,安装卸载路径清晰,明暗仍由 DSH 自带外观设置控制。目录页:SkillHub 插件页;源码与说明:GitHub 仓库。