前言¶
DeepSeek Harness（DSH）的 Web GUI 自带明暗与系统外观切换，但预设配色、字体栈和界面字号往往不能满足长期盯屏或品牌统一的需求。改浏览器样式或本地 CSS 既难持久，也容易在 DSH 升级后失效。下面介绍社区插件 DSH Theme（@solvashq/dsh-theme）：在 Harness 侧边栏和设置页内完成主题与外观个性化，并把选择写入 DSH Host 配置，重启后仍有效。
这是什么¶
DSH Theme 由 SolvasHQ 维护，在 SkillHub 插件目录 中归类为「趣味换装」。它面向 DeepSeek Harness Web 客户端，提供轻量主题色、DIY 调色板、字体与界面文字大小等能力；入口是侧边栏左下角的调色板图标，与 Settings → 个性化 / Personalization 中的同一套面板。npm 包当前版本为 1.4.0，许可证 MIT。
核心功能¶
入口与界面语言¶
侧边栏底部、Settings 按钮上方一行的调色板图标，单击打开左下角锚定的紧凑面板；相同选项也出现在设置的「个性化 / Personalization」页。界面文案随应用语言在简体中文与英文之间切换。
预设与自定义主题¶
内置 10 套预设：Default（Harness 原样）、Warm、Mono、Claude、Claude+、Vermillion、Amber Mono、MX Brutalist、Tiesen、Vescrow，以及 Custom 卡片。明暗模式均为一等公民：每个预设和 DIY 颜色都包含 light / dark 两套值，在原生外观于浅色、深色与跟随系统之间切换时仍可用。
DIY 主题编辑器 按明暗模式分别设置 background、card、popover、sidebar、text、border 及该模式的 accent；error / success / warning 共用；另有 Bold borders 开关（全局 1 px 边框并使用 ink-strength 边框 token）。未固定的色槽会从 background / text 自动推导，保持单模式内协调。
字体与字号¶
拉丁与中文界面字体栈可独立配置，另有代码字体，分别作用于界面、对话与代码文本。文字大小可在 10–22 px 范围内调节，通过原生 theme 服务的 setFontSize('text', px) 持久化，与 Ctrl/Cmd + / - 快捷键一致。
持久化方式¶
选项保存在 DSH Host settings 文档中（插件 Host 侧声明 .volatile() 字符串字段，客户端经 ctx.configForms 读写），随 profile 与 localhost 端口配置保留，不依赖 localStorage。明暗偏好与字号仍走 Harness 原生 theme 设置。
实现要点（便于排查）¶
客户端通过 ctx.theme.overrideTokens('@solvashq/dsh-theme', tokens) 注册单层主题；每个 token 为 { light, dark } 对。每套 palette / 模式约 14 个锚色扩展为约 97 个 --dsw-alias-* / --dsw-specific-* 语义 token，并带对比度约束。字体经 --dsh-font-family-text / --dsh-font-family-code 写入同一 token 层。
安装与启用¶
DSH 生态采用「一切皆插件」；社区目录与 npm / jsDelivr 索引由维护者与社区提供，与 DeepSeek / 幻方无官方从属关系。安装前建议浏览 GitHub 仓库 源码与 MIT 许可证；插件在当前 DSH 进程权限下运行，仅安装你信任的来源。
推荐：Plugins → Discover¶
无需 npm 账号，也无需手改 profile：
- 打开 Plugins → Discover。
- 添加索引源（版本已固定，便于立即可用）：
https://cdn.jsdelivr.net/gh/SolvasHQ/dsh-theme@v1.4.0/market/index.json
若跟踪 @main 分支，可将 URL 中的 tag 改为 @main；jsDelivr 对 @main 最长缓存约 12 小时，需要时可 purge https://purge.jsdelivr.net/gh/SolvasHQ/dsh-theme@main/market/index.json。
- 在列表中找到 DSH Theme，进入详情页后点击 Install。
Discover 会安装该 release 对应的 Git commit；同一 release 亦发布为 @solvashq/dsh-theme@1.4.0，并在 GitHub Release 附带预构建的 dsh-theme.tgz。
npm¶
npm install @solvashq/dsh-theme
也可让 DSH agent 使用 spec @solvashq/dsh-theme@1.4.0 从 npm 安装 bundle。
安装完成后重启或刷新 Web GUI：侧边栏左下应出现调色板图标，Settings → 个性化 / Personalization 应出现相同页面。
典型用法¶
- 单击侧边栏左下角调色板图标，或进入 Settings → 个性化 / Personalization。
- 在预设卡片中选择 Warm、Mono、Claude 等之一，观察明暗模式下界面是否满意。
- 选择 Custom，在 DIY 编辑器中分别调整浅色与深色的背景、卡片、侧边栏、文字与 accent；需要清晰边界时打开 Bold borders。
- 在字体区域分别设置拉丁、中文与代码字体栈；用字号滑块或控件将界面文字调到 10–22 px 范围内。
- 切换 Harness 原生浅色 / 深色 / 系统外观，确认预设或 Custom 在两种模式下仍一致可用。
经上述步骤，个性化结果应写入 Host settings，关闭浏览器或重启 DSH 后仍保留（同一 profile 与认证身份下）。
适用场景与注意¶
- 适合：长期在 DSH Web GUI 上工作的开发者或使用者，需要多套可读配色、自定义品牌色、中英字体分离或更大界面字号。
- 注意：DIY 未固定色槽会随背景 / 文字自动推导；若某槽位需要固定，应在编辑器中明确指定。Host 侧插件逻辑变更需重启 DSH；仅改客户端 bundle 时，DSH 客户端 HMR 可在约一秒内热更新
client.js（开发场景）。 - 版本：本文安装索引与 npm 示例以资料中的 1.4.0 为准；升级时请改用 release 或 Discover 索引中的新 tag。
结尾¶
DSH Theme 把 Harness Web 界面的配色、DIY 调色、字体与字号收进侧边栏与设置页，并与明暗模式、原生字号快捷键和 Host 持久化对齐。目录页：SkillHub — SolvasHQ/dsh-theme；源码与说明：github.com/SolvasHQ/dsh-theme。
