Anestis271 / dsh-desktop

DeepSeek Harness Desktop

简体中文 | English

让 DeepSeek Harness 官方 WebUI 自然地成为一个桌面应用。

这不是另一套客户端，也不需要单独下载安装桌面程序。它只是一个轻量的 dsh 插件：保留官方 WebUI 的全部能力，在外面加上一层干净、原生的桌面外壳。

预览

为什么选择本插件

• 无需单独安装应用：没有额外的 MSI、DMG 或 AppImage，只需安装一个 npm 插件。
• 官方 WebUI 是唯一真源：不复制、不分叉、不重新实现界面，dsh 更新后依然保持一致。
• 足够干净：不增加第二套业务状态、账号体系或后台服务，只负责窗口与系统集成。
• 像真正的桌面应用：提供系统托盘、原生窗口按钮、协调一致的标题栏和可选快捷入口。
• 重复启动更快：再次点击快捷方式时直接唤起现有窗口，不重复创建 dsh 和 WebUI 实例。

安装

安装前请确认：

• Node.js 版本满足 ^22.19.0 或 >=24.0.0
• 已安装 pnpm，且 pnpm --version 可以在终端中正常执行
• dsh 已安装，且可以在终端中正常运行

然后执行：

dsh plugin --profile desktop add @anestis271/dsh-desktop
dsh --profile desktop

首次启动时，插件会下载并解压当前平台所需的 Electron 运行环境。下载大小和耗时取决于平台与网络状况，下载进度到达 100% 后仍可能需要等待片刻完成解压，请不要中断进程。准备完成后，后续启动会直接复用 profile 中的 Electron 缓存，启动速度会恢复正常，无需额外配置。

桌面体验

• 关闭窗口时可收起到系统托盘
• 托盘菜单支持显示/隐藏、刷新、打开 profile 目录和退出
• 托盘菜单跟随 dsh 的中英文设置实时切换
• 保留各平台原生的最小化、最大化和关闭按钮
• 标题栏颜色与 WebUI 侧边栏协调，形成完整的 L 形视觉
• 同一 profile 始终只保留一个窗口和一个托盘实例
• 支持 Windows、macOS 和 Linux 的用户级快捷入口

快捷入口

启动 dsh Desktop 后，可在官方 WebUI 的 设置 → 通用设置 中按需创建桌面快捷方式和应用菜单入口；登录时启动默认关闭，可在同一位置开启。

这些入口仍然只启动 dsh --profile desktop，不会安装另一份 Electron，也不需要管理员权限。macOS 使用系统自带的 osacompile 生成本地 AppleScript 快捷应用，因此从桌面或 Applications 启动时不会额外打开 Terminal。登录启动关闭后，插件只会移除由它自己创建的入口。

macOS 的首次真机验收步骤见 docs/MACOS_SMOKE_TEST.md。

设计原则

dsh-desktop 只做桌面外壳应该做的事。会话、设置、模型、工具和所有业务界面继续由 DeepSeek Harness 官方 WebUI 提供；插件不会建立一套需要额外维护的平行客户端。

许可证

MIT