前言¶
DeepSeek Harness(DSH)的界面由 composer、弹窗、菜单、代码块等多块区域组成。若只想换一层半透明、带模糊与高光的外观,而不改业务逻辑或动应用源码,通常需要手写 CSS 或 fork 主题。社区插件 dsh-glass-effect 把 composer、对话框、菜单、卡片、代码块、任务面板与右侧边栏统一到同一套玻璃材质,并在 设置 → 通用 → 外观 提供单一开关;关闭后恢复 DSH 默认外观,且不残留插件写入的属性。
下面介绍插件定位、能力、安装与用法,以及使用前需要了解的权限与兼容范围。
这是什么¶
dsh-glass-effect 是 DSH 的「趣味换装」类客户端插件,由维护者 Yinhefuluoye 发布在 GitHub(Yinhefuluoye/dsh-glass-effect),社区目录页见 SkillHub。插件在浅色与深色主题下分别调校同一层半透明材质(顶高光、边缘反射、背景模糊),不发起网络请求、不采集会话数据,卸载时可完整释放注入的样式与设置项。
实现上参考了 MIT 许可的 dsh-liquid-glass,归属说明保留在仓库 LICENSE 中。
核心功能¶
README 中已核实的能力如下:
- 统一材质:composer、对话框、菜单、代码块、任务面板、右侧边栏共用一层玻璃效果。
- 按主题调校:浅色 / 深色各自配置高光、反射与模糊。
- 单一开关:Settings → General → Appearance(设置 → 通用 → 外观)中,位于三个主题选项下方;开启应用玻璃外观,关闭后与未装插件时一致。
- 无其它入口:无全局快捷键,也无额外配置面板。
- 客户端实现:注入一份 stylesheet、在
body上标记属性、经 theme 服务覆盖一层 token,并注册一行设置;仅写入插件自身的 localStorage 键。lib/client.js为单文件手写实现,无构建步骤;仓库提供离线自检脚本tools/verify.mjs(43 条断言,含对网络访问与会话数据读取的静态检查)。
当前 package.json 中版本为 0.2.2;从 Release 安装时 README 示例文件名为 dsh-glass-effect-0.2.0.tgz,以 Releases 页实际文件为准。
安装与启用¶
DSH 自带图形化插件安装,无需在资料中未出现的 CLI 命令(例如不要自行拼接 dsh plugin add github:...)。
从 GitHub 安装(推荐)¶
- 打开 Settings → Plugins → Add plugin(设置 → 插件 → 添加插件)。
- 在 package name or address 字段填入:
https://github.com/Yinhefuluoye/dsh-glass-effect
- 点击 Install,然后 重启 DSH。
GitHub 地址或 .tgz 链接不经 npm registry 拉取,机器需能直接访问该地址或经代理访问。
从 Release 安装¶
- 在仓库 Releases 下载
dsh-glass-effect-0.2.0.tgz(或复制其下载 URL)。 - 同样在 Add plugin 的地址栏粘贴该链接并安装。
- 安装后重启 DSH。
桌面客户端无 Ctrl+R 重载快捷键,改插件或安装后应重启应用而非指望热重载。
启用玻璃效果¶
安装并重启后,进入 Settings → General → Appearance,打开玻璃效果开关即可。开关状态按 origin 存储;桌面 Electron 与 dsh web 互不影响。
典型用法¶
除开关外无额外 API。对照 README 中的行为表:
| 开关状态 | 效果 |
|---|---|
| On(开) | 应用玻璃外观 |
| Off(关) | 与默认 DSH 外观一致 |
若只想临时恢复默认样式,应使用开关,而不是卸载插件。
卸载¶
从 profile 的 package.json 里 dsh.profile.bundles 移除 "dsh-glass-effect",执行 pnpm remove dsh-glass-effect,再重启 DSH。README 未将其作为日常「关皮肤」的推荐方式。
适用场景与注意¶
适合谁:长时间使用 DSH 桌面或 Web 客户端、希望界面统一为 glassmorphism 风格、且能接受仅通过设置开关控制的开发者。
兼容性:需 DSH 0.2.x(使用 settings.general.item 插槽与 ui-primitives 的 Switch)。桌面与 Web 共用同一 Web 客户端实现。
安全与权限:插件在 当前 DSH 进程权限 下运行;安装前应阅读 lib/client.js 与 cordis.patch.yml,并确认 MIT 许可证与 NOTICE。资料明确声明:无网络访问、无 cookies / 会话 / 凭证读取、不修改应用源码树;卸载后不应留下插件写入的 DOM 属性(关闭开关即可恢复默认外观)。
生态说明:DSH 采用「一切皆插件」的扩展方式;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系,本文安装步骤以 GitHub README 为准。
结尾¶
dsh-glass-effect 用一处设置开关,把 DSH 主要 UI 表面换成统一的半透明玻璃材质,关断即还原默认主题。进一步细节与 Release 包见 GitHub 仓库,目录索引见 SkillHub 插件页。