前言¶
DeepSeek Harness（DSH）的 Web GUI 默认深色界面背景接近纯黑、对比度偏高，长时间盯屏时容易显得刺眼。社区里「趣味换装」类插件可以只改视觉层、不动布局与功能。下面介绍维护者 EnderBull 发布的 dsh-mist-ink-theme（雾墨 · Mist Ink）：在深色模式下把底色换成更柔的石墨灰，并为侧栏、输入区等表面加上可调强度的毛玻璃，且可随时一键恢复 DSH 默认深色。
这是什么¶
dsh-mist-ink-theme 是面向 DSH Web GUI 的客户端主题插件：通过注入作用域 CSS 覆盖设计令牌（Design Token），实现「更软的石墨灰 + 毛玻璃」外观。服务端 half 为空实现，不注册工具、不写文件、不发请求；客户端不联网、不读写会话。
- 维护者：EnderBull
- 分类：趣味换装（社区目录 SkillHub 插件页）
- 源码与说明：GitHub — EnderBull/dsh-mist-ink-theme
- 许可：MIT
- 包版本（资料中 package.json）：0.1.2，要求
dsh>= 0.2.0
DSH 生态遵循「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。安装前建议自行查看仓库源码与许可证，插件随当前 DSH 进程权限运行。
核心功能¶
只改深色模式¶
浅色模式、布局、字号、字体和所有业务功能保持不变；主题仅在深色模式下生效。
随时开关¶
- 侧边栏标题行左侧的调色板按钮打开主题面板，顶部开关可启用/关闭雾墨。
- 关闭后立即恢复 DSH 默认深色；再次打开即回到雾墨。
- 快捷键
Ctrl+Alt+M可快速切换。
开关与毛玻璃强度会写入浏览器 localStorage（键名 dsh-mist-ink:enabled、dsh-mist-ink:glass），卸载插件后如需可手动清除。
毛玻璃强度可调¶
主题面板内可调，也可在 设置 → 通用 → 毛玻璃强度 调整：0% 为完全不透明，变更实时生效并记住。
色板与对比度¶
雾墨把若干 --dsw-alias-* 与 --dsw-specific-sidebar-fill 等令牌从默认近黑底改为石墨灰系；README 说明正文对比度从约 17.5:1 降到约 11:1，次要文字约 7.3:1，辅助说明约 5.4:1，均高于 4.5:1 的常见可读性参考线。--dsw-specific-sidebar-fill 在 Windows 上还会被原生标题栏按钮通过 preload 的 setTitleBarOverlay 读取，以便窗口 chrome 与网页标题条同色。
各表面的视觉处理¶
| 表面 | 处理要点 |
|---|---|
| 左侧栏 | 8px 外缝悬浮卡片：16px 圆角、半透明冷灰渐变、blur()、发丝边与左上反光 |
| Windows 顶栏 | 与窗口按钮同色的实色 chrome（#141418） |
| 右侧栏、输入区、对话框等 | 半透明 + 模糊；输入区模糊放在伪元素上，避免 Chromium 下按钮 hover 导致整卡背景闪烁 |
页面画布为纯色 #202024，与右侧对话区一致，避免卡片缝隙泛光。
零依赖与无宿主副作用¶
运行物为内联 CSS 的客户端模块，免构建即可随 npm 包使用（开发时可用 node scripts/build.mjs 把 src/theme.css 打进 lib/client.js）。不增加 npm 运行时依赖链上的额外包（相对「零依赖」表述以 README 为准）。
安装与启用¶
Web profile（发布版）¶
从 npm 安装并挂到 Web profile：
dsh plugin --profile web add dsh-mist-ink-theme
安装后确认该 profile 的 package.json 里 dsh.profile.bundles 包含 dsh-mist-ink-theme。包内 cordis.patch.yml 带有 insert 条目，只有列入 bundles 才会进入插件树；应用内插件管理器安装时通常会代为接线。
桌面版（desktop profile）¶
dsh plugin --profile desktop 会被拒绝，需通过 Electron 应用内插件市场/插件管理安装，或按仓库 README「本地开发安装」在 ~/.dsh/profiles/desktop/ 下用目录联接 + cordis.patch.yml 手工接入（适合本地改主题，非普通用户必选路径）。
典型用法¶
- 按上文命令完成 Web profile 安装并确认 bundles。
- 打开 DSH Web GUI，切到深色模式。
- 点击侧栏标题行左侧调色板，在主题面板打开雾墨；用顶部开关或
Ctrl+Alt+M对比默认深色与雾墨。 - 在主题面板或 设置 → 通用 调节毛玻璃强度，找到个人舒适的透明度。
开发者可在仓库根目录用浏览器打开 preview.html 预览；preview.html?before 看默认深色，preview.html?settings 看设置滑杆。改样式编辑 src/theme.css 后执行 node scripts/build.mjs；客户端冒烟测试为 node test/client.test.mjs。
适用场景与注意¶
适合：长期在 DSH Web GUI 深色模式下工作、希望降低对比度并增加层次感的开发者；需要可随时还原默认主题、且不希望改动功能与布局的用户。
注意：
- 仅 Web 客户端注入（
dsh.client.platform:web）；桌面版走应用内市场或本地 profile 接线。 - 主题不持久化在服务端；卸载时删除
cordis.patch.yml中对应insert与node_modules联接即可，README 称不会留下服务端持久化数据。 - 安装前请阅读 GitHub 仓库 与 MIT 许可证，自行评估是否与团队安全策略一致。
结尾¶
雾墨把 DSH Web GUI 深色界面从「高对比近黑」调整为石墨灰与可调毛玻璃，并通过面板开关与快捷键保持可逆。社区目录页：https://www.skillhub.cn/plugins/EnderBull/dsh-mist-ink-theme；源码与完整安装、开发、发布说明：https://github.com/EnderBull/dsh-mist-ink-theme。
