前言¶

在 Windows 上使用 DeepSeek Harness 桌面版时，主窗口通常是纯色或固定背景，和桌面、动态壁纸是割裂的。有人会用 Wallpaper Engine 做桌面动效，但 Harness 本身仍挡在前面。若希望聊天界面能模糊或清晰透出窗口后方画面（包括 Wallpaper Engine），又不想让文字和图标发虚，就需要改窗口合成方式，而不只是换 CSS 主题。

下面介绍社区插件 dsh-desktop-glass（维护者 inMessionante19），它在 DSH 社区目录中归类为「趣味换装」。插件为 Windows 桌面版提供可切换的原生毛玻璃与完全透明背景，文字保持清晰，背景随窗口位置实时变化。项目采用 MIT 许可证，当前发布版本为 v0.3.0；与 DeepSeek 官方无关联。

这是什么¶

dsh-desktop-glass 由界面插件与一次性的原生适配组成：普通 DSH 插件跑在 Host/页面里，而毛玻璃/透明需要主进程改 Electron 窗口合成。市场安装只添加界面部分；未完成原生适配时，界面会保持原样并在设置里提示。

一句话定位：在已验证的 Harness 桌面归档上，通过受控补丁暴露布尔开关和 glass / transparent 模式，配合设置页控制遮罩与恢复。

核心功能¶

两种背景模式¶

行为与体验¶

• 实时背景：移动或缩放窗口时，显示后方对应位置；可透出 Wallpaper Engine 动态画面（是否暂停取决于 Wallpaper Engine 自身规则）。
• 清晰文字：文字、图标保持不透明；设置弹窗和菜单保留可读底色。
• 记住选择：模式与遮罩自动保存；切回毛玻璃时保留之前的遮罩数值。
• 随时恢复：设置中可恢复原界面；快捷键 Ctrl + Alt + G 开关当前效果。

透出的是窗口后方的实际画面；若有其他应用位于 Harness 与桌面之间，也会被透出或模糊。

环境与限制¶

安装前请确认：

• Windows 11 22H2 或更新，并开启系统「辅助功能 → 视觉效果 → 透明效果」。
• 已验证 DeepSeek Harness 0.2.1-rc.2 / Electron 44.7.0；其他版本可能需要重新适配。
• Node.js 20 或更新，用于运行原生适配安装器。

插件以当前 Harness 进程权限运行；原生安装器会修改 resources/app.asar 中的 lib/main.js 与 lib/preload-app.cjs（安装器会备份并校验其余打包文件）。安装前应阅读仓库源码与 MIT 许可证，并理解这是社区自行补丁，非官方支持。

安装与启用¶

官方流程分四步：下载解压、原生适配、添加界面插件、在设置里选模式。从插件市场安装过界面插件后，仍须完成原生适配。

1. 下载并完全退出 Harness¶

下载并解压 v0.3.0 ZIP。从系统托盘右键 → 退出完全退出 Harness（右上角 × 通常只隐藏窗口）。

2. 安装原生适配¶

在解压目录的上一级打开 PowerShell，设置应用目录与插件目录后执行安装器：

$appDir = 'C:\path\to\DeepSeek Harness'
$pluginDir = (Resolve-Path '.\dsh-desktop-glass').Path
node (Join-Path $pluginDir 'native\install.mjs') --app-dir $appDir

$appDir 为包含 DeepSeek Harness.exe 的目录。安装器会备份并校验程序归档；不支持的结构或归档保护会导致安装器停止。

3. 添加界面插件¶

若已从插件市场安装，可跳过。手动安装时：

$dshCli = Join-Path $appDir 'resources\runtime\cli\bin\dsh.cmd'
$pluginLink = 'link:' + ($pluginDir -replace '\\', '/')
& $dshCli plugin --profile desktop add $pluginLink

链接安装直接读取本地插件目录，请保留该文件夹。若启动器自定义了 DSH_HOME，需在当前 PowerShell 中设置相同的 $env:DSH_HOME。若出现 ERR_PNPM_UNEXPECTED_STORE，在命令末尾按错误信息追加 --store-dir。

4. 启动并选择模式¶

用原有入口启动 Harness，打开 设置 → 通用 → 桌面背景效果。

典型用法¶

设置项与作用如下：

日常可用 Ctrl + Alt + G 快速开关效果并保留所选模式。

适用场景与注意¶

适合谁：在 Windows 11 上长期使用 Harness 桌面版、希望窗口与桌面/Wallpaper Engine 视觉统一、且接受一次性原生补丁的用户。

常见问题：

• 安装后仍是纯色：看设置中的状态提示，确认原生适配已完成，并从托盘完全退出后重开。仅市场安装不够。
• Harness 桌面更新后效果消失：更新可能覆盖补丁；完全退出后重新运行安装器。新版不兼容时安装器会停止。
• 失焦变灰：当前版本在已验证环境中普通焦点切换后仍保持毛玻璃；节能、远程桌面或关闭系统透明效果可能限制合成。

卸载与恢复：

• 仅关效果：设置里点 恢复原界面。
• 恢复桌面归档：完全退出后，用安装时的 $appDir、$pluginDir 执行：

node (Join-Path $pluginDir 'native\install.mjs') --app-dir $appDir --restore

备份在插件目录 backups 下。界面插件可通过插件管理器卸载。

结尾¶

dsh-desktop-glass 把 Harness 主窗口变成可切换的毛玻璃或全透明层，后方动态壁纸与桌面内容随窗口实时变化，同时尽量保住文字可读性。安装涉及原生适配，升级 Harness 后可能需要重跑安装器。

• 社区目录：inMessionante19/dsh-desktop-glass
• 源码与说明：GitHub — inMessionante19/dsh-desktop-glass