前言¶

DeepSeek Harness（DSH）的 Web 界面默认是一套相对固定的壳层样式。若你希望在不改业务逻辑的前提下，把侧边栏、对话区、对话框等表面做成磨砂半透明、可选壁纸与色调，并在 Windows 桌面上进一步透出桌面或调节窗口模糊，就需要一套以插件形式注入的主题方案。下面介绍社区维护的 air-pixel-liquid-glass：在 Harness 内挂载可配置 Liquid Glass 主题，并区分「仅 Web 层样式」与「依赖宿主补丁的桌面透明 / 窗口材质」两类能力。

这是什么¶

air-pixel-liquid-glass（维护者 AIR-pixel）是面向 DeepSeek Harness 的 Liquid Glass 主题插件，分类为社区目录中的「趣味换装」。它在 Harness Web UI 中增加半透明界面表面、可选壁纸、桌面透明、窗口模糊、自定义光标、点击涟漪，以及人机两侧对话区的独立对比度控制；设置界面支持英文与中文。

插件当前版本为 0.2.0（MIT 许可证），在 package.json 中声明为 DSH bundle，并通过 cordis.patch.yml 与客户端注入（client.js，平台 web）接入 Harness。

核心功能¶

以下能力均来自项目 README 与 package.json 说明，可按模块理解：

磨砂表面与视觉基调¶

• 可调 强度（strength）、模糊（blur）、色调（tint） 与 壁纸（wallpaper） 的磨砂表面。
• 提供四种色调预设，并覆盖浅色 / 深色场景；README 中展示了默认强度下侧边栏、面板、对话框、菜单与浮动面板的磨砂效果，以及与未启用主题时的对比图。

桌面透明与窗口材质（Windows，依赖补丁）¶

• 可选 桌面透明 与 Windows 窗口材质（window material） 相关控制。
• 桌面透明需要随插件附带的 client patch helper；若补丁不可用，设置项会给出说明。主题与其余视觉选项不依赖该补丁。
• 该特性面向 Windows 与 Harness 已安装构建所支持的合成器 API；README 注明屏幕截图难以完整呈现 alpha 透窗（例如 PrintWindow 会丢失 alpha 通道），文档图由 tools/docshots.mjs 在模拟壳层中渲染。

光标与点击反馈¶

• 自定义光标 与 点击涟漪（click ripples） 可分别配置；README 展示插件内置的五套光标样式与按住时的涟漪效果。

对话可读性¶

• 为人消息与助手消息提供 独立的对比度（contrast） 设置，以便在较高透明强度（例如 strength 2.0 且开启桌面透明）时仍保持正文可读。

权限与行为（安装前宜知晓）¶

插件会向 Harness Web UI 注入主题样式与自定义光标，通过本地宿主 API 读写自身 JSON 设置，并通过宿主 logger 记录诊断状态。可选工具 tools/asarpatch.py 仅在用户显式运行时修改已安装的 Harness app.asar，并保留备份、支持检查或回滚；插件不进行外网请求。

安装与启用¶

README 给出的安装与启用方式为：

1. 将 air-pixel-liquid-glass 作为 DeepSeek Harness bundle 安装。
2. 在 Harness 设置（Settings） 中启用 Liquid Glass。

桌面透明与窗口模糊相关控件需要宿主侧补丁；主题与其余视觉选项不需要该补丁。

兼容性（README 原文）： 面向 Windows 与 Web GUI 上的 DeepSeek Harness；桌面透明与窗口模糊取决于已安装的 Harness 构建与 Windows 合成器 API。本版本声明仅验证 Harness 核心 0.2.1-rc.2。0.2.x 起 slots 座位移入核心 client runner，0.1.x 核心不适用本插件，应继续使用插件 0.1.0。

插件以当前 DSH 进程权限运行；安装前请阅读仓库源码与 MIT 许可证，并知悉可选 asarpatch.py 对 app.asar 的修改范围。

典型用法¶

安装并启用 Liquid Glass 后，在设置界面中按需调整（README 与截图中的典型维度包括）：

1. 强度 / 模糊 / 色调 / 壁纸：从默认磨砂面板开始，再逐步提高强度或更换壁纸与 tint 预设。
2. 桌面透明：在 Windows 且补丁可用时开启「透出桌面」；若不可用，以设置中的提示为准，勿假定已生效。
3. 窗口模糊：在支持的构建上调节 Windows 窗口材质相关项。
4. 光标与涟漪：分别开关或调整自定义光标与点击涟漪。
5. 对话对比度：分别调节人类侧与助手侧对比度，避免高透明场景下正文发灰。

开发侧若需本地校验，README 要求在 Node.js 环境下执行（示例为 PowerShell）：

node tools/preflight.mjs
node tools/verify.mjs
node tools/patcheck.mjs
node tools/mutationaudit.mjs

文档截图可由 node tools/docshots.mjs 重新生成（写入 assets/）；部分视觉检查脚本需要 Python 与 Pillow，详见仓库 DEVELOPMENT.md。

适用场景与注意¶

适合谁： 希望在 DSH 日常使用中统一玻璃态视觉、并愿意在 Windows 上按需处理桌面透窗与窗口材质的用户；仅需 Web 层磨砂与壁纸时，可不使用 asar 补丁路径。

注意：

• 社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系；安装来源以目录页与 GitHub 仓库为准。
• 核心版本须与插件声明一致（当前插件 0.2.0 对应 0.2.1-rc.2 核心）；旧核心请使用插件 0.1.0。
• 星标与传播度不代表安全审计结论；启用前请自行审查 client.js、index.js 与可选 tools/asarpatch.py。

结尾¶

air-pixel-liquid-glass 把 Liquid Glass 主题做成可配置的 DSH bundle：Web 侧覆盖磨砂、壁纸、光标与对话对比度，Windows 上可选桌面透明与窗口模糊（补丁可用时）。查阅介绍与安装入口可使用社区目录页 skillhub.cn/plugins/AIR-pixel/air-pixel-liquid-glass，源码与完整说明见 GitHub：AIR-pixel/air-pixel-liquid-glass。