dsh-label-tune:压低 DSH Web 深色主题里过亮的文字

前言

长时间盯着 DSH Web GUI 的深色界面时,正文标签色偏亮、加粗字在 Windows 上由 Chromium 合成粗体后更容易显得刺眼。官方对比度虽高,但观感未必适合长时间阅读。下面介绍社区插件 dsh-label-tune:纯客户端半边、零依赖,通过覆盖标签 token 与字重,把正文、加粗和标题压到更克制的层级,刷新页面即可生效。

这是什么

dsh-label-tune 由维护者 Upstream196 发布,在 SkillHub 插件目录 中归类为「趣味换装」。仓库描述为:调暗 DSH Web GUI 过亮文字,包含更柔和的标签 token、放松的加粗字重(500)与标题字重,作用范围限于深色主题。

实现上不碰宿主代码、无运行时依赖、无需构建;样式全部引用官方静态变量 var(--dsw-static-neutral-bluish-N),不写死 rgb,便于跟随上游配色。当前版本 0.1.0,许可证 MIT。

核心功能

插件通过注入 CSS,在深色主题下调整以下几类视觉层级(对比度按底色 rgb(21,21,23) 手算,正文参考 WCAG AAA 7:1 要求):

部位 官方 本插件
正文 --dsw-alias-label-primary bluish-50,约 17.4:1 bluish-200,约 14.5:1
正文暗档 -primary-dimmed bluish-100 bluish-300(避免比正文更亮、层级倒置)
次要 -secondary / 三级 -tertiary bluish-300 / bluish-400 不变
加粗 <strong> 与正文同色,字重 600 颜色 bluish-300,字重 500
标题 h1–h3 / h4 700 / 600 600 / 500

加粗单独处理的原因:DSH 未给加粗单独颜色 token,加粗仅继承正文色并提高字重;在 Windows 上微软雅黑真实字重多为 400/700,600 由浏览器合成,笔画发糊时会更显亮,因此插件同时压暗一档并降到 500。

README 注明:--dsw-font-markdown-base-strong* 一类 token 实测覆盖后观感无变化,插件不启用该段,只保留选择器级规则。

安装与启用

安装方式取决于你用的是桌面 App 还是 CLI 的 web profile。桌面的 desktop profile 由 Electron 独占管理,CLI 无法向该 profile 添加插件。

桌面版 App

在 App 内置插件市场搜索 dsh-label-tune,或填写仓库地址安装,然后重启 App。若执行 dsh plugin --profile desktop add ...,会被拒绝,错误信息为:profile "desktop" is managed exclusively by the Electron application。

CLI + web profile

先添加插件,再把包名写入 profile 的 bundles:

dsh plugin --profile web add github:Upstream196/dsh-label-tune

随后在 %USERPROFILE%\.dsh\profiles\web\package.json 的 dsh.profile.bundles 中加入 dsh-label-tune。

本地开发(link)

dsh plugin --profile web add link:F:\path\to\dsh-label-tune

将路径换成你本机克隆或下载后的目录。

零安装(不通过 DSH 插件系统)

把仓库中的 dsh-label-tune.css 粘贴到 Stylus 用户样式(域 http://127.0.0.1:19387),或写入 dsh-custom-css、dsh-theme-studio 等插件的 Custom CSS 框。

生效方式

纯客户端半边:保存后刷新页面(F5)即可,一般不需要重启 dsh web。只有「新增了配置层」(例如刚装完插件)时,才需要重启一次 DSH 进程。

典型用法与微调

默认规则装好后无需额外配置。若需要更亮或更暗,可改插件 CSS 中对应变量或段落(改完后刷新页面):

想要的效果 改哪里
正文再亮一档 --dsw-alias-label-primary → bluish-150 或 bluish-100
正文再暗一档 → bluish-300
加粗再暗 strong 段 bluish-300 → bluish-400
加粗用真 Bold strong 段 font-weight: 500 → 700
加粗保持原色 删掉 strong 段里的 color 行
标题别那么重 h1–h3 的 600 → 500,或删掉对应段
浅色主题同样处理 去掉末尾可选段的注释

维护者在仓库提供离线自测:

node --test test/verify.mjs

用于校验模块契约、样式只注入一次、色阶与加粗/标题规则在位等。

卸载时移除插件即可;仅当前会话临时恢复可在 DevTools 执行:

document.getElementById('dsh-label-tune-style')?.remove()

适用场景与注意

适合:主要使用 DSH Web 深色主题、希望长时间阅读时降低标签与加粗刺眼感、又希望仍满足较高对比度的开发者。

注意:

  • 插件以当前 DSH 进程的权限运行;安装前请自行查看 GitHub 源码 与 MIT 许可证,确认变更范围符合你的安全策略。
  • peerDependencies 声明可选的 @deepseek-ai/cordis(>=4.0.0),宿主从 0.2.0-rc.1 起会在 boot 阶段做 semver 闸门;范围外的 bundle 可能被静默跳过(日志可能出现 dsh: skipping profile bundle "X")。
  • SkillHub 等为社区目录站点,与 DeepSeek / 幻方无官方从属关系;DSH 生态强调「一切皆插件」,本插件是其中一条纯 CSS 侧的微调路径。

结尾

dsh-label-tune 不重构主题,只针对深色界面里过亮的标签与合成加粗做小幅压暗与降字重,安装路径清晰,刷新即可验证。目录页:SkillHub - dsh-label-tune;源码与完整说明:github.com/Upstream196/dsh-label-tune。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜