前言¶
长时间盯着 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。