dsh-theme-obsidian

dsh-theme-obsidian · 曜石桌面级主题与 UI 增强插件

为 DeepSeek Harness (DSH) 桌面端与 Web 端打造的 macOS 原生质感客户端主题插件。1:1 复刻官方海报级冷灰蓝毛玻璃侧栏 (Vibrancy Slate) + #151517 纯粹曜石主画布 + #2c2c2e 悬浮输入坞 + 0.5px Retina 镜面高光边框，并提供三档 GPU 流畅度优化与实时调色台。

---

核心特性

• 双材质高反差高级感：侧边栏采用半透明冷灰蓝磨砂材质（自动折射背部体积微光），主对话区采用零色偏 #151517 石墨曜石底色，消除普通暗色网页的灰蒙感。
• 4 套高定双模配色预设（同时适配 DSH 外观浅色 / 深色 / 跟随系统）：
  • 深空曜石 (obsidian-origin)：1:1 原版桌面复刻（#3d434f 毛玻璃侧栏 + #151517 画布 + #4f5d7f 灰蓝强调色）
  • 极夜冰川 (glacier-midnight)：DeepSeek 冷海蓝透光玻璃质感
  • 钛金灰羽 (titanium-noir)：Space Black 阳极氧化钛金属极简中性灰
  • 晨雾银砂 (sonoma-frost)：日间高透云母磨砂侧栏与纸感阅读画布
• 流畅度与跨平台深度兼容：
  • requestAnimationFrame 帧合并管线：拖动模糊度/不透明度滑块时按屏幕刷新率（60Hz/120Hz）合并提交 Token，零主线程卡顿。
  • 三档 GPU 性能开关：极致光影 (Ultra) / 均衡流畅 (Balanced，默认 CSS contain 隔离) / 低功耗省电 (Eco，零实时模糊开销，核显/远程桌面满帧)。
  • 全环境优雅降级：支持 @supports not (backdrop-filter) 实色回退、prefers-reduced-motion 系统动效减弱适配、Windows 桌面端 data-windows-titlebar 标题栏避让，以及 WebKit/Firefox 双引擎极细滚动条。
  • 跨代际 DSH 兼容：一套零构建产物同时兼容 DSH 0.1.x (settingsScope + dsh-client-runtime) 与 DSH 0.2.x (configForms + .volatile() + dsh-client-store)。

---

安装方式

方式一 · 预构建包（免构建，推荐）

直接从 GitHub Release 安装打包好的 tarball，无需本地目录：

dsh plugin --profile desktop add https://github.com/Inh-ui/dsh-theme-obsidian/releases/latest/download/dsh-theme-obsidian.tgz

latest/download/ 里的资产名刻意不带版本号（dsh-theme-obsidian.tgz），所以每次发新版这个链接都继续有效。

方式二：从本地目录安装

支持安装到 desktop（桌面客户端）或 web profile：

# 安装到桌面版 profile
dsh plugin --profile desktop add file:/path/to/dsh-theme-obsidian

# 或安装到 Web 版 profile（开发调试可用 link: 实时热刷新）
dsh plugin --profile web add link:/path/to/dsh-theme-obsidian

包内已声明 dsh.bundle.patch 与 dsh.client，dsh plugin add 会自动将其追加至 dsh.profile.bundles，无需手动修改 cordis.patch.yml。首次安装后重启一次 DSH 即可生效。

方式三：一键脚本安装

• macOS / Linux：

  bash scripts/install.sh desktop   # 或 bash scripts/install.sh web
  

• Windows PowerShell：

  .\scripts\install.ps1 -Profile desktop
  

---

使用与实时精调

安装并重启 DSH 后，打开 设置 (Settings) → 通用 (General)，在内置 「外观 (Appearance)」 正下方即可看到 「曜石桌面主题 (Obsidian Vibrancy)」 面板，支持实时切换预设、流畅度档位、毛玻璃模糊度与镜面边框增强，所有修改自动持久化并即时生效。

卸载

dsh plugin --profile desktop remove dsh-theme-obsidian