桌面客户端 bruc3van/dsh-desktop

DSH Desktop

第三方 DSH 桌面客户端。使用官方 Web UI，支持后台运行、系统通知、运行时切换和内置安全市场。

DSH Desktop 是独立的 DeepSeek Harness（dsh）Electron 客户端。窗口直接加载官方 Web UI；桌面端负责运行时启动与连接、托盘、通知、更新和安全控制。

[!IMPORTANT]
这是社区维护的非官方项目。 本项目不是 DeepSeek 官方产品，也不代表 DeepSeek。DeepSeek、DeepSeek Harness、dsh 及相关名称和标识归各自权利人所有。

安装包内置固定版本的官方 @deepseek-ai/dsh 运行时，启动客户端和使用内置运行时无需另行安装 Node.js、pnpm 或 dsh 命令行。具体任务或插件仍可能需要额外工具。桌面客户端和官方运行时使用不同版本号，连接设置会同时显示这两个版本。

DSH Desktop 首页

主要功能

- 关闭窗口后继续在后台运行，可从托盘或菜单栏重新打开；Linux 无托盘时可再次从应用菜单启动或打开同一 AppImage 恢复窗口。
- 直接使用官方 Web UI，不维护另一套界面。
- 安装包内置官方运行时，可直接启动。
- 可复用正在运行的 dsh，也可使用 PATH、npx 缓存或内置运行时。
- 可选择与命令行共享 ~/.dsh，或使用桌面端独立数据环境。
- 内置安全市场。插件目录默认关闭，用户启用后才联网读取；通过官方插件管理器安装，安装后可选择 AI 审查。
- 更新包安装前校验 SHA-256。
- Electron 窗口启用沙箱和上下文隔离，并限制导航与权限。

快速开始

下载安装

从 GitHub Releases 下载对应系统的安装包。发布版已经包含官方 dsh 运行时，首次启动不会执行 npm 安装。

| 你的设备 | 选择的安装包 |
| macOS，Apple Silicon（Apple M 系列） | mac-arm64.dmg |
| macOS，Intel | mac-x64.dmg |
| Windows，Intel/AMD 64 位 | win-x64.exe |
| Linux，Intel/AMD 64 位 | linux-x86_64.AppImage |
| Ubuntu 24.04，Intel/AMD 64 位安装版 | linux-amd64.deb |

表中列出文件名后缀，实际文件名还包含客户端版本号。各版本覆盖的平台以该 Release 的下载资产为准。Linux 构建目标包括 x64 AppImage 和 DEB；DEB 以 Ubuntu 24.04 为支持基线，暂不提供 ARM64 或 RPM 包。

macOS/Windows 安装包尚未完成正式开发者签名认证，首次打开时系统可能拦截。

首次打开被系统拦截时

- macOS：将应用拖入“应用程序”并打开。然后前往“系统设置 → 隐私与安全性”，点击“仍要打开”。

如果系统提示“已损坏，无法打开”，并且没有“仍要打开”按钮，可在终端执行：

xattr -dr com.apple.quarantine "/Applications/DSH Desktop.app"

- Windows：在 Microsoft Defender SmartScreen 中点击“更多信息”，再点击“仍要运行”。

Linux x64 安装

Ubuntu 24.04 安装版（DEB）：下载 linux-amd64.deb 结尾的包，在下载目录执行 sudo apt install ./实际文件名.deb，然后从应用菜单打开 DSH Desktop，或运行 dsh-desktop。安装会设置菜单、图标及限定应用路径的 AppArmor 策略，不需要 FUSE。升级前请使用“退出”结束客户端，再执行同一安装命令；sudo apt remove dsh-desktop 卸载应用并保留用户设置及会话数据。

AppImage 便携版：

1. 下载文件名以 linux-x86_64.AppImage 结尾的包。
2. 将文件放到 ~/Applications/（目录不存在时先创建），保留原文件名。
3. 在文件属性中允许执行，然后双击打开。也可用以下命令赋予执行权限：

chmod +x ~/Applications/dsh-desktop-*-linux-x86_64.AppImage

缺少 FUSE 2 时，Ubuntu 24.04 可安装 libfuse2t64；也可在启动 AppImage 时加上 --appimage-extract-and-run 解压运行。若双击后没有窗口，请从终端运行该文件查看错误；遇到用户命名空间或 Chromium 沙箱限制时，按Linux 安装与系统要求配置 AppArmor。客户端要求保留渲染器沙箱。

当前验证环境为 WSL 中的 Ubuntu 24.04，已检查 X11 和 WSLg Wayland。其他发行版及完整原生 GNOME/KDE 桌面仍需独立验证；AppImage 格式不代表所有 Linux 系统均已验证兼容。托盘、系统通知和中文输入法的实际表现取决于桌面环境。

开始对话

1. 首次启动时输入 API Key，或选择“稍后配置”。
2. 没有 Key 时，可打开 <https://platform.deepseek.com/api_keys> 创建。账户、余额和费用由 DeepSeek 开放平台管理。
3. 根据需要选择智能体预设或模型。
4. 添加并选择项目文件夹，作为会话的工作区。
5. 新建会话并发送任务。

[!TIP]
全新数据目录可能默认显示英文。可在 Settings → General → Language 中切换语言。

连接方式

| 模式 | 行为 |
| 智能模式（默认） | 按顺序尝试：正在运行的官方实例 → PATH 上的 dsh → npx 缓存 → 内置运行时。 |
| 自定义 | 连接指定的 Web UI 地址，不启动本地运行时。 |
智能模式只使用本机已有的运行时，不下载或安装 Node.js。连接设置可关闭任一来源，但至少保留一种。独立数据环境不复用共享环境中已运行的实例，需保留本机已安装、npx 缓存或内置运行时之一。来源选择先暂存，点击「应用并重新连接」后生效；也可撤销未应用的更改。

客户端启动本地服务时，自动尝试 3080、13080，再使用系统分配的端口。也可以设置固定端口。固定端口被占用时不会自动换端口。

共享数据环境下，如果客户端检测到官方实例仍在运行，但当前设置不允许复用，会拒绝另起进程，也不会结束用户启动的进程。请先在终端停止该实例，或切换到独立数据环境。

可从托盘菜单、macOS/Linux 应用菜单或主窗口快捷键打开「桌面设置」：macOS 使用 Cmd+,，Windows/Linux 使用 Ctrl+,。

桌面设置：连接方式、运行时来源、安全市场和版本信息

连接状态说明：

| 状态 | 含义 |
| 本机已运行 | 复用用户启动的实例 |
| 客户端启动·客户端内置 | 使用安装包内置运行时 |
| 客户端启动·npx 缓存 | 使用 npx 缓存运行时 |
| 客户端启动·本机已安装 | 使用 PATH 上的 dsh |
| 自定义地址 | 连接指定地址，不启动运行时 |

客户端启动的 Web UI 使用本机回环地址。自定义地址可连接自行维护的 Web UI，认证和网络可达性需由该部署保证；地址按协议、主机和端口保存，不保留路径、查询参数或片段。跨机器连接的部署方式请参照所用版本的官方文档。

运行时选择、端口和认证细节见开发指南。

数据与安全

| 数据 | 默认位置 | 管理方 |
| 共享环境的会话、凭据、模型配置和插件 | ~/.dsh | 官方 dsh |
| 桌面端设置、命令 shim 和更新下载 | ~/.bruc3van-dsh-desktop | 桌面客户端 |
| 独立环境的会话、凭据、模型配置和插件 | ~/.bruc3van-dsh-desktop/dsh | 官方 dsh |

设置中的「数据环境」可以在共享环境和桌面端独立环境之间切换，重启后生效。切换不会复制原环境中的会话或插件。

旧版 ~/.dsh-desktop 会在新目录不存在时迁移到 ~/.bruc3van-dsh-desktop。移动失败时会复制数据并保留旧目录。

主要安全措施：

- 通过官方 dsh web 命令行启动服务，通过 Web UI 的 /api 接口交互；内置市场接入还会调用运行时的配置加载模块并调整插件配置。
- Electron 启用沙箱和上下文隔离，关闭 Node 集成。
- 页面导航限制在当前 Web UI 源站，外部链接使用系统浏览器打开。
- 打包版本默认忽略覆盖更新源、数据目录或连接探测设置的环境变量；显式启用不安全调试模式时例外。
- 更新清单和安装包文件名会进行校验，安装包会校验 SHA-256。
- 客户端管理的本机 Web UI 可使用文件选择、语音输入等权限；复用的实例和自定义地址采用更受限的权限策略。跨域子框架、USB/HID/串口、定位、屏幕捕获和存储权限升级默认拒绝。
- 安全市场的插件目录默认关闭，用户启用后才联网读取。

Windows 安装版支持系统通知。Linux 使用 Chromium 通知。当前 macOS 包没有正式签名，因此系统通知会降级为 Dock 角标、Dock 弹跳和应用内提醒。

使用本客户端仍需遵守 DeepSeek、模型服务商和所连接服务的条款与隐私政策。API Key、模型请求、费用、生成内容以及智能体对本机文件和命令的操作由用户和对应服务负责。

桌面端行为

- 关闭主窗口后继续后台运行；从托盘或菜单栏可重新打开。Linux 无托盘时，再次从应用菜单启动或打开同一 AppImage 可恢复窗口；使用窗口菜单「DSH Desktop → 退出」或 Ctrl+Q 结束客户端。
- 「重启客户端」会重启客户端管理的本地运行时，不会结束用户在终端启动的 dsh web。
- 本地 Web UI 意外退出时会进行有限次数的重启。
- 系统唤醒或长时间后台运行后，页面异常时会在服务可用后重新加载。
- 智能模式复用的实例失联时，可回退到其他已启用来源。自定义地址失败时不会自动切换。
- 客户端通过运行时锁和本机服务探测，避免为同一 DSH_HOME 重复启动运行时。无法安全接管或停止旧进程时，会拒绝启动新进程；这些检查不能阻止用户从其他终端或工具启动额外实例。
- 共享环境因插件失败而无法启动时，可卸载确认存在的问题插件后重试，或保留插件并切换到独立环境。

发布版启动后会检查 GitHub Releases，12 小时内不重复自动检查。也可从设置、托盘菜单或 macOS/Linux 应用菜单手动检查。更新窗口显示下载、校验和后续操作；下载失败可重试，关闭窗口后下载可以继续。

macOS 可在应用目录可写时自动替换并重启应用。更新失败时会尝试恢复旧应用。更新会中断客户端管理的本地任务，请选择合适的时间执行。

Linux 更新会按当前安装格式下载并校验 DEB 或 AppImage，然后打开文件位置；DEB 请在退出客户端后用 sudo apt install ./实际文件名.deb 安装新版，AppImage 则手动替换原文件；下载期间任务继续运行。请通过「DSH Desktop → 退出」或 Ctrl+Q 退出客户端，再按安装格式完成更新并重新打开。关闭主窗口仅隐藏窗口，不能代替退出。已校验的下载在客户端重启后仍可复用。

内置运行环境

- 发布版在启动本地运行时时，于 ~/.bruc3van-dsh-desktop/bin 生成 node、dsh 和 pnpm 命令入口，并将该目录追加到运行时及其智能体命令的 PATH。已有 PATH 中的用户工具优先；客户端不修改系统 PATH。
- node 使用 Electron 自带的 Node.js 执行能力，pnpm 随安装包提供；客户端未内置 npm 和 npx。如需使用这两个命令，请另行安装包含 npm/npx 的完整 Node.js 发行版，并确保命令在客户端启动的运行时 PATH 中可用。
- 内置 dsh 入口支持插件管理、版本查询和配置导出，会拒绝再次启动 dsh web 等运行时实例。
- 客户端启动运行时时会清理内部的 ELECTRON_RUN_AS_NODE 设置，避免普通智能体 shell 命令误用 Electron 的 Node 模式。
- 应用未启用 macOS App Sandbox。Electron 窗口沙箱不等同于 Agent 命令沙箱；Agent 操作还受所用运行时的权限策略、沙箱配置和操作系统授权约束。
- 内置运行时随客户端发布，不能单独升级。

实现细节见桌面客户端架构和开发指南。

内置安全市场

旧包名为 dsh-desktop-safe-market。客户端管理的旧副本会自动迁移；用户自行安装的旧包保留，需要先停用旧包再安装新包。旧版目录开关不会自动迁入，升级后请在市场页面重新启用。以下截图来自较早版本，功能以文字说明为准。

safer-dsh-market 0.10.1 随安装包离线发布，内置 DSH 为 0.2.1-rc.3。桌面设置中的“启动时接入内置安全市场”默认开启，在客户端启动且依赖兼容的运行时中接入插件，无需在线安装。复用已经运行的本机实例或连接自定义地址时，不改动其插件配置。

市场页面内的“启用安全市场”控制联网读取插件目录，默认关闭，与桌面设置中的接入开关相互独立。用户启用后会保存该选择，并缓存上一次成功获取的数据。关闭桌面设置中的接入开关后，下次由客户端启动运行时时会移除客户端拥有的市场副本及登记；尚未转为客户端管理的用户安装不受该开关管理。

客户端启动本地运行时时，若内置市场版本高于 Web 配置中已启用的普通安装版或官方仓库的 GitHub release tag 安装版，会离线升级并转为客户端管理，同时移除旧的依赖固定和 pnpm 锁文件入口。相同或更高版本、其他自定义来源（如 file/link/git）、无法识别的版本或锁文件会保留；连接已有服务时不会替换。迁移后的市场随客户端更新，也受客户端的内置市场开关管理。

依赖预检以本次启动的运行时为准：旧共享目录中自动链接的可选依赖，如果本次运行时不提供，不会阻止内置市场加载。必需依赖和用户显式安装的依赖仍会检查兼容性。

客户端设置中的“启动时接入内置安全市场”控制下次启动的行为，旁边单独显示本地安装和登记状态，不代表当前会话已加载。市场自卸载后，当前会话可能仍保留界面；开关开启时，下次客户端启动本地服务会尝试恢复内置副本，关闭时不会恢复。未清理的用户安装会显示提示，不会被当作已恢复。

从开始页打开「安全市场」，可在右侧浏览插件目录，按名称或分类筛选，并查看已安装插件。

从开始页打开内置安全市场并浏览插件

安全市场

市场目录来自 awesome-dsh-plugin：

- 每日采集带 dsh-plugin 标签的仓库。
- 排除已归档、停用或不符合收录条件的项目。
- 使用人工维护的排除名单，并在展示前再次校验数据。

点击“安装”后，市场通过宿主官方插件管理器直接安装。安装后可选择 AI 审查已安装版本；审查不构成安全保证。

收录不代表安全背书。安装前仍需查看审查结果。

已安装插件可以查看版本、启用、停用或卸载。已安装但未加载的插件也会显示。

已安装插件管理

市场与当前运行时不兼容时，客户端会停止接入市场，不影响其他插件。更完整的配置、目录协议和限制见安全市场仓库。

常见问题

Q：这是浏览器套壳吗？

窗口加载官方 Web UI，但客户端还负责运行时管理、连接、托盘、通知、权限控制和更新。项目不维护另一套产品界面。设计说明见架构文档。

Q：与直接在浏览器访问 Web UI 有什么区别？

浏览器方式通常需要用户安装 Node.js、启动 dsh web 并保持终端运行。桌面客户端内置运行时，可在后台管理服务，并提供托盘、通知、连接设置和应用内更新。

Q：如何使用最新的官方 dsh？

可更新 PATH 上的官方 dsh 或 npx 缓存运行时，并在智能模式中启用对应来源；也可复用已更新的本机实例，或通过自定义地址连接自行维护的 Web UI。智能模式按来源顺序选择，不会比较所有来源后自动选最新版。内置运行时固定为客户端发布时的版本，通过客户端更新升级。

Q：安全市场会自动安装插件吗？

市场通过官方插件管理器执行用户选择的安装操作，AI 审查是安装后的可选操作。

微信交流群

欢迎扫码加入项目微信交流群，一起讨论 DSH Desktop 的使用与改进。二维码有效期以图片中的提示为准。

相关项目

- awesome-dsh-plugin：安全市场的目录数据来源。每日采集插件仓库并维护排除记录。
- safer-dsh-market：本客户端内置安全市场的实现。
- deepseek-harness：官方 dsh 和 Web UI 的上游项目。

许可证

MIT

MIT 许可证只适用于本仓库维护的代码和素材。官方 @deepseek-ai/dsh 及其他第三方依赖使用各自许可证。“DSH”仅用于说明兼容对象，不表示官方关系。