前言¶

DSH 的理念是「一切皆插件」；社区目录是独立站点，不是官方应用商店，与 DeepSeek / 幻方没有官方从属关系。如果你已经有可运行的 DSH Web，又不想为桌面端新建 profile、重装插件和配置，可以看一下 Icather 维护的 dsh-clean-desktop-shell。下面介绍它的定位、能力、安装方式和注意事项。

这是什么¶

dsh-clean-desktop-shell 是 DeepSeek Harness（DSH）的一个 DSH 插件。它给已经配置好的 DSH Web 套一层原生桌面窗口，提供系统托盘和单实例行为。它不做视觉改造：不加毛玻璃、不改界面，也不在主窗口添加控件。

它默认连接本地地址：

127.0.0.1:3080

也可以配置远程 DSH 地址。许可证为 MIT。当前 package.json 版本为 0.1.7；0.1.7 修复了插件形态在 macOS 上无法定位 Electron.app 路径的问题。

核心功能¶

• DSH 插件形态：可挂载进现有 web profile，复用现有 profile，零迁移。
• 原生桌面窗口壳：提供系统托盘和单实例；双击启动立即出窗，不等后端就绪；重复双击只聚焦已有窗口。
• 后端活性监测：后端被关闭、崩溃或手动停止时立即切到离线页；后端恢复后自动重连。
• 托盘后端管理：一键启动、重启、关闭后端，带进度弹窗；关闭后端会真正停掉 3080 端口上的服务，包括外部启动的实例。
• 托盘辅助操作：自动探测后端、设置后端安装文件夹、刷新窗口、创建桌面快捷方式、检查更新、打开仓库主页。
• 桌面快捷方式：安装包自动创建；插件形态首次运行可询问创建，并支持托盘一键补建。
• 两种分发形态：安装包版与 DSH 插件版，共用 Electron 壳代码。
• 平台状态：Windows 已发布 NSIS 安装包，支持 electron-updater 自动更新；macOS 已发布 Intel 与 Apple Silicon DMG，为手动下载；Linux 不做；手机 / 平板由内核 headless / PWA 远程访问支持。

安装与启用¶

DSH 插件形态¶

先确认本机已有可用的 dsh web 服务，或准备配置远程 DSH 地址。插件安装命令为：

dsh plugin --profile web add dsh-clean-desktop-shell

重启 dsh web 后，桌面壳窗口会自动弹出。插件形态首次运行需要联网准备 Electron 运行时，约 1-2 分钟。

安装包形态¶

从 Release 下载对应安装包：

Windows: DSH-Clean-Desktop-Shell-Setup-<版本>.exe
macOS Intel: DSH-Clean-Desktop-Shell-<版本>.dmg
macOS Apple Silicon: DSH-Clean-Desktop-Shell-<版本>-arm64.dmg

安装包会自动创建桌面快捷方式。Windows 安装包支持自动更新；macOS 需要手动下载。

典型用法¶

1. 安装插件后，在命令行启动 dsh，桌面窗口自动弹出；也可以双击插件或安装包创建的桌面快捷方式启动。
2. 在窗口中使用 DSH Web 原有功能。主窗口保持纯壳，不添加控件。
3. 后端相关操作放在托盘右键：启动 / 重启 / 关闭后端、自动探测后端、设置后端安装文件夹、刷新窗口、创建桌面快捷方式、检查更新、打开仓库主页。
4. 后端未连接时，窗口会显示离线页。可以在离线页中执行重新加载、启动后端、自动探测后端、设置后端安装文件夹。

适用场景与注意¶

适合已经配置好 DSH Web、希望以桌面窗口方式使用，并需要托盘管理本地后端的场景。它只是 DSH Web 之外的桌面壳，不替代 dsh web 服务本身。

使用与安装前需要注意：

• 插件会以当前 dsh 进程权限运行。安装前建议先检查源码、许可证和依赖；本项目许可证为 MIT。
• 安装包未代码签名。Windows 可能触发 SmartScreen：Edge 下载时选择「保留 / 仍要保留」；双击安装时选择「更多信息 / 仍要运行」；也可以右键安装包属性并选择「解除锁定」。
• macOS .dmg 未签名、未公证，首次打开可能触发 Gatekeeper，提示已损坏或无法验证开发者。可执行：

xattr -cr "/Applications/DSH Clean Desktop Shell.app"

然后右键应用 → 打开。

• 当前开发者没有 Mac 实机；macOS 安装验证、签名 / 公证、Electron.app 可执行位和 quarantine 扩展属性等行为，仍依赖 Mac 用户验证或贡献。
• 代码签名证书需要付费，个人开源维护者暂未购买。
• 托盘中的「关闭后端」会真正停掉 3080 端口上的服务，包括外部启动的实例。

结尾¶

dsh-clean-desktop-shell 做的事情比较集中：把 DSH Web 包进一个干净的桌面窗口，复用现有 profile，并把托盘、单实例、后端启停和离线重连放到桌面侧。如果要继续评估，可以先看目录页和代码仓库：

• 目录页：https://www.skillhub.cn/plugins/Icather/dsh-clean-desktop-shell
• GitHub：https://github.com/Icather/dsh-clean-desktop-shell