前言¶
DeepSeek Harness（DSH）的 Web 界面默认使用不透明面板叠在背景之上。若只想让主区域、侧栏、卡片或菜单各自变透一点，又不想改 DSH 源码或手写一堆 CSS，常见做法是全局改主题或接受「滑到 20% 仍像八九成不透明」的叠层误差。dsh-appearance-glass 走另一条路：用官方主题 token 覆盖，为四个界面分区提供独立透明度滑块，并附带内置壁纸与透底模式；1.1 起只保留纯 alpha，不再提供模糊、饱和度或玻璃类特效。
这是什么¶
dsh-appearance-glass 由维护者 david0304git 发布，在 SkillHub 上归类为「趣味换装」。它面向 DSH Web UI（--profile web），通过 ctx.theme.overrideTokens 改写 --dsw-* 变量，不碰 DSH 源码文件；卸载后效果全部消失。配置写在当前 profile 的 cordis.patch.yml 的 config: 段，保存即生效，无需重启 DSH。
核心功能¶
四个分区、独立透明度¶
滑块对应四个区域，数值表示合成后的视觉不透明度（例如 20% 即看起来约两成不透明），插件会按各区域实际叠层次数反算每层 token：
| 区域 | 含义 |
|---|---|
| 主面板 | 对话区背景等（macOS 上同一 token 可能被绘制两次） |
| 侧栏 | 侧栏及选中态（壳层还会叠约 40% tint） |
| 卡片与输入 | 卡片、输入框、消息气泡、代码块 |
| 菜单与浮层 | 菜单、工具提示、Toast、Popover |
设置页提供 Sync，可将主面板数值一键同步到另外三区。
透底与内置壁纸¶
See-through backdrop 三选一：auto（桌面端用系统窗口材质，其余环境用壁纸）、wallpaper（内置壁纸）、none（纯透明底）。
内置壁纸包含：三个可配色色块（wallpaperA/B/C）、底色（wallpaperBase）、强度（wallpaperStrength）、五套调色板，以及使用真实 token 与层数的实时预览。壁纸仅作用于 <html> 的 background-image；插件不为容器添加 backdrop-filter，避免影响 DSH 基于 anchor 定位的固定菜单。
总开关¶
enabled 为 false 时所有 token 保持原样，便于与默认界面对比，不会卸载插件。
实现边界（与「玻璃」名称的关系）¶
README 明确：Plain alpha only — no blur, no saturation, no glass effects（1.1 已移除 mode 与 liquid glass）。macOS 桌面版窗口本身带 vibrancy: 'sidebar' 与透明背景，材质一直存在，只是被不透明面板盖住；调透面板后可见系统材质，这不是 CSS 仿造的毛玻璃。若需要完全无模糊，可在浏览器中打开 DSH。
安装与启用¶
环境要求：dsh >= 0.2.0（package.json 中 engines.dsh）；README 注明在 0.2.1-rc.2 上测试。唯一 peer 为 @deepseek-ai/schemastery（由宿主提供，标记为 optional）。
从 npm 或 GitHub 安装（须带 --profile web）：
dsh plugin --profile web add dsh-appearance-glass
dsh plugin --profile web add github:david0304git/dsh-appearance-glass
在界面中的入口：
- Settings → Interface appearance（独立
settings.section页，位于 General 之后、Models 之前） - Settings → Plugins → dsh-appearance-glass（
plugins.bundle.config）
若在插件市场发现：DSH 自带的 Discover 需自行配置索引 URL（例如 https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json 或 https://awesome-dsh-plugin.com/index.json）；dsh-market 仅安装 awesome-dsh-plugin 列表中的条目，本插件需先被列入该列表。
典型用法¶
- 安装后打开 Settings → Interface appearance，确认页头 Enabled 为开。
- 在 Interface opacity 中分别拖动四个滑块，或设好主面板后点 Sync。
- 在 See-through backdrop 选择
auto/ 内置壁纸 / 纯透明；若选壁纸，在预览下方调整色块、底色、强度与调色板。 - 需要恢复默认时，使用 Reset to defaults。
主要配置字段（节选，范围与默认值以 README 为准）：
| 字段 | 范围 | 默认 | 说明 |
|---|---|---|---|
enabled |
boolean | true |
总开关 |
opacityBase |
0–100 % | 68 | 主面板 |
opacitySidebar |
0–100 % | 68 | 侧栏 |
opacitySurface |
0–100 % | 68 | 卡片与输入 |
opacityOverlay |
0–100 % | 72 | 菜单与浮层 |
backdrop |
auto / wallpaper / none |
auto |
透底模式 |
wallpaperA/B/C |
#rrggbb 或 auto |
auto |
三个色块 |
wallpaperBase |
#rrggbb 或 auto |
auto |
底色 |
wallpaperStrength |
10–100 | 58 | 色块强度 |
排错时常见情况：控件变灰多为宿主半端未就绪；无效果先查 Enabled 与 backdrop 是否为 none；macOS 要看桌面应用而非浏览器标签；配置里若仍有 1.0 的 mode / blur / saturate 可删，无害。
适用场景与注意¶
适合希望在 DSH Web 端微调分区透明度、搭配简单渐变壁纸、或在 macOS 桌面版利用真实窗口透底的开发者与个人用户。不适合期待 CSS 毛玻璃、液态玻璃或独立模糊/饱和度控件的场景——这些在 1.1 已移除。
插件以当前 DSH 进程的权限运行，安装前建议阅读 GitHub 仓库 源码与 MIT 许可证，并确认与本地 dsh 版本匹配。社区目录（如 SkillHub、awesome-dsh-plugin 索引）为独立生态站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-appearance-glass 用主题 token 做四区独立透明度与合成值校正，加上可选内置壁纸与透底模式，在不动 DSH 核心的前提下改 Web 界面观感。当前版本 1.1.1。目录页：SkillHub - dsh-appearance-glass；源码与完整参数说明：github.com/david0304git/dsh-appearance-glass。
