前言¶
DeepSeek Harness（DSH）的 Web 界面默认是实底面板。长时间对着会话、文件预览和各类弹层工作时，有人希望界面更「透」、背后有一点层次，又不想让统计面板和 diff 里的字糊在背景上。改宿主 CSS 不现实；换系统主题也管不到 DSH 自己的 token。社区维护者 rans725 的 dsh-glass-ranswork 以 DSH bundle 形式挂在浏览器半侧，在 设置 → 自定义主题 里提供可调参页，出厂默认约 80% 半透明（表面 opacity: 20），信息面板单独一档 panelOpacity: 85。下面介绍它做什么、怎么装、怎么调。
这是什么¶
dsh-glass-ranswork（npm 包名同名）给 DSH Web 界面加上半透明与背景模糊的毛玻璃外观，并在设置里集中管理透明度、模糊、饱和度、氛围光配色，以及本机背景图（裁剪、显示方式、蒙层、文字保护与跟随图片明暗）。仓库：github.com/rans725/dsh-glass-ranswork；社区目录分类为「趣味换装」。当前资料中的发行版本为 v1.1.1，许可证 MIT。本包声明为 DSH bundle（cordis.patch.yml + 浏览器 client 注入），无需构建、无额外 npm 依赖；在 DSH 0.2.1-rc.3（Windows 桌面版）上开发与验证（v1.1.1 起）。
插件只使用公开的客户端服务（slots / locale / theme）和宿主 webServer，无私有 API、无原生依赖。
核心功能¶
毛玻璃与分层不透明度¶
- 表面不透明度（
opacity，默认 20）：控制装饰性骨架（侧栏、输入框、选区等）的不透明百分比；20 表示约 80% 半透明。 - 面板不透明度（
panelOpacity，默认 85）：弹层、文件预览、Modal、费用面板等「要读字」的区域，避免与骨架共用同一档透明度。 - 模糊：背景层
blur（默认 32px）、浮层overlayBlur（默认 32px）、发送框与任务卡片composerBlur（默认 24px）；运行时对部分值有上限夹紧。 - 饱和度（
saturate，默认 180%）与 氛围光（ambient，默认可开；配色accent：aurora / ocean / sunset / mono）。
关闭 enabled 后完全恢复 DSH 原生外观。
自定义背景图¶
设置页可选本机图片作为壁纸，铺在半透明表面后面，支持 cover / contain / stretch / tile / center（bgFit），以及比例裁剪（bgCrop）、背景蒙层（bgDim）。可选 文字保护（bgGuard）与 跟随图片明暗（bgAutoTone）：暗图切深色主题、亮图切浅色。
图片落盘为 $DSH_HOME/glass-theme-bg.<ext>，设置 JSON 里只存短 token（bgImage），避免每次拖滑块重写大段 base64。宿主提供 /glass-theme/background 相关 GET/POST/DELETE 路由供上传与读取。
设置持久化与版本提示¶
配置写在 $DSH_HOME/glass-theme.json；范围校验以宿主半侧为准。浏览器半侧会把未知键镜像到 localStorage（键 dsh-glass-theme:settings），用于宿主尚未重启、不认识新字段时的过渡。
设置 → 自定义主题 页顶显示当前加载版本（如 v1.1.1）；有新 Release 时可能出现「有新版本」链接。宿主半侧约每 6 小时静默查询 GitHub 最新 Release（资料原文描述）。
常规界面约 7 个滑块；设背景图后多「背景蒙层」滑块及文字保护、跟随明暗开关，并出现「自定义裁剪」区域。
安装与启用¶
升级前建议先看仓库 README 的「升级」一节：若用 main.tar.gz 一类会动的地址，pnpm 会把 integrity 写进 lockfile，重装不一定拉到新内容；固定版本请写进 tag 的 URL 或使用 npm。
在 DSH 图形界面安装（推荐入口）¶
- 打开 DSH → 设置 → 插件 → 安装插件；
- 粘贴安装地址（资料推荐第一种）：
npm（推荐）
dsh-glass-ranswork
codeload 固定版本（不想用 npm 时）
https://codeload.github.com/rans725/dsh-glass-ranswork/tar.gz/refs/tags/v1.1.1
本地目录安装：解压含 package.json 的目录，填绝对路径，例如 D:\Plugins\dsh-glass-ranswork。
- 按提示 重启 DSH；
- 打开 设置 → 自定义主题 调外观。
npm 方式的好处是插件市场能感知 registry 版本并推送更新提醒；纯 URL 安装资料说明通常收不到市场更新推送。从旧 URL 方式迁到 npm 时，可能需要 pnpm remove dsh-glass-ranswork && pnpm add dsh-glass-ranswork 重装一次。
在 profile 目录用 pnpm 安装¶
pnpm add dsh-glass-ranswork
固定 tag 的 codeload 示例：
pnpm add https://codeload.github.com/rans725/dsh-glass-ranswork/tar.gz/refs/tags/v1.1.1
Release 资产示例：
https://github.com/rans725/dsh-glass-ranswork/releases/download/v1.1.1/dsh-glass-ranswork-1.1.1.tgz
资料不推荐 github: 前缀（Windows 上可能依赖系统 git）；受限网络下 README 建议优先 codeload 直链而非 github.com/.../archive/...。
典型用法¶
- 安装并重启后，进入 设置 → 自定义主题，确认页顶版本号。
- 用滑块调整表面与面板不透明度、各级模糊和饱和度；需要氛围光时保持
ambient并切换accent配色。 - 上传背景图后，选择
bgFit，按需拖「背景蒙层」、开「文字保护」与「跟随图片明暗」，在「自定义裁剪」里框选可见区域。 - 若效果过重，可先提高
panelOpacity或previewOpacity（默认 85），再微调表面opacity。
卸载：设置 → 插件 → 卸载。插件不改 DSH 本体；若要彻底复位，可删除 $DSH_HOME/glass-theme.json 与 $DSH_HOME/glass-theme-bg.<ext>。
Tarball / URL 升级时，需更换 spec 或删 lockfile 对应条目后再 pnpm install，否则 lockfile 可能钉住旧包；详见 README「升级」与自查表。
适用场景与注意¶
适合谁：长期在 DSH Web 界面工作、希望界面半透明与模糊、并想用本机壁纸且自动适配明暗的用户；分类上属于「趣味换装」，不改变模型或工具链行为。
运行与信任边界：插件以当前 DSH 进程权限运行，会上传图片到 $DSH_HOME 并在宿主注册静态路由。安装前应浏览 仓库源码 与 MIT 许可证，确认可接受数据落盘方式。
兼容性预期：DSH 大版本若重命名主题 token，可能出现部分颜色或模糊不生效，资料说明一般不会因此崩溃。宿主每次升级会重编译客户端，CSS Modules 哈希会变；插件对装饰性规则使用稳定 data 属性或结构判据（v1.1.1 起）。
社区目录 skillhub.cn 与 GitHub 由社区维护，与 DeepSeek / 幻方无官方从属关系；DSH 生态本身是「一切皆插件」，本介绍仅依据公开 README 与 package 元数据。
结尾¶
dsh-glass-ranswork 把毛玻璃参数和壁纸能力收进 DSH 自带设置页，默认即偏透明的观感，又单独照顾可读面板。需要固定版本与升级路径时，优先 npm 包名或带 tag 的 codeload URL。
- 目录页：https://www.skillhub.cn/plugins/rans725/dsh-glass-ranswork
- GitHub：https://github.com/rans725/dsh-glass-ranswork
