dsh-theme-tuner

DSH web plugin: theme customization placed under the built-in Appearance (外观) settings. It reuses the Appearance light/dark switch and lets you adjust accent / background / foreground / contrast for the active theme, applied live through DSH theme token o

latest

Source

npm

Version: 0.1.0

Version published: 2 months ago

Weekly downloads: 0

Maintainers: 1

Weekly downloads

Created: 2 months ago

Source

dsh-theme-tuner

English

在 DeepSeek Harness (DSH) 的「通用设置 → 外观」下方直接调整界面主题——强调色 / 背景 / 前景 / 对比度 / 渐变度，实时生效。

复用「外观」自带的 浅色 / 深色 / 跟随系统 切换，无需重复的切换按钮。

效果

深色 · 主题效果	深色 · 主题效果	深色 · 主题效果
深色 · 主题效果	浅色 · 主题效果	主题调节面板

功能

挂在「通用设置 → 外观」正下方，调整 强调色 / 背景 / 前景 / 对比度 / 渐变度。
复用「外观」的浅色 / 深色 / 跟随系统切换，针对当前激活主题调整。
浅色、深色两套配色分别保存；对比度按当前主题微调前景文字的清晰度。
改动实时生效（theme.overrideTokens 写入 --dsw-alias-* 设计变量），可一键恢复当前主题默认。

安装

dsh plugin --profile web add github:shawnlone/dsh-theme-tuner

本仓库按「仓库根即插件包」组织：package.json 声明了 dsh.bundle.patch（安装入口）与 dsh.client（浏览器端 UI），根目录放置 cordis.patch.yml。新增插件需 重启一次对应的 web profile 才会生效。另提供 scripts/install.ps1 / scripts/install.sh 一键脚本（内含 pnpm 供应链策略无法通过时的本地 junction 安装回退）。

原理

插件通过 theme.overrideTokens 把自定义值写入 DSH 的设计 token：

强调色：--dsw-alias-brand-primary / --dsw-alias-button-primary-fill / --dsw-alias-state-business-primary
背景：--dsw-alias-bg-base / --dsw-alias-bg-layer-1/2/3 / --dsw-specific-sidebar-fill
前景：--dsw-alias-label-primary/secondary/tertiary（由所选前景色 + 对比度自动推导）

设置经 theme-tuner 命名空间持久化；设置行注册到 settings.general.item（order 15），排在「外观」（order 10）正下方。

目录结构

dsh-theme-tuner/
  package.json          # 双面插件清单：dsh.client + dsh.bundle.patch
  cordis.patch.yml      # bundle 挂载行 (insert)
  lib/index.js          # 主机半区：注册 theme-tuner 设置命名空间 + schema
  lib/client.js         # 浏览器半区：设置行 UI + 实时 token 应用
  scripts/              # install.ps1 / install.sh
  preview.html          # 独立效果演示
  assets/               # 文档 / 插件市场截图