DSH 桌面端安装与使用：下载、更新、插件、数据与卸载

DeepSeek Harness 桌面端是官方提供的 macOS 和 Windows 应用，2026-09-29 随 v0.2 预览版发布。它是在完整的 DSH Web 应用外面套了一层 Electron 壳，自带运行环境，不需要先装 Node.js。下载入口在官方产品页 ↗（外部链接，在新标签页打开）。

和 npx @deepseek-ai/dsh web 相比，最需要注意的是：桌面端和命令行版共用 ~/.dsh 下的会话、设置、凭据和工作区，但插件各装各的。已经在用命令行版的用户，先备份 ~/.dsh 再装桌面端。

本文按 DSH 0.2.2-rc.1（固定提交 66491b05）的官方源码与文档整理，0.2.2-rc.2 的差异单独标注。52DSH 没有下载、安装或运行桌面端，下文的行为描述都来自官方文档，不是实测结果。

下载与系统要求

• Intel Mac： 官方源码支持打包 Intel 版，但截至 2026-11-11 官方产品页只列出了 Apple Silicon 和 Windows 两个下载。Intel Mac 用户请以官方产品页为准，或者改用 Web 版。
• Linux： 官方打包文档明确说 Linux 不是桌面端的发布目标。Linux 用户请使用 Web 版。
• 下载文件名带 latest，但不带版本号。 截至 2026-11-11，两个安装包的服务器修改时间都是 2026-11-05，但官方没有在下载页标注版本号，本站不能确认它对应哪个 DSH 版本。安装后可以在应用菜单的“关于 DeepSeek Harness”里查看实际版本。

桌面端和 npx Web 版是什么关系

官方文档说明，两者的可执行文件、插件启用状态和锁文件相互隔离，但没有说明同时打开桌面端和 Web 版操作同一个会话是受支持的用法。稳妥的做法是同一时间只用一个入口操作同一份会话。桌面端不会和 Web 版争用 3080 端口；如果桌面端启动时报端口占用，按恢复对话框的提示先退出其他正在运行的 DSH。

第一次启动

1. 打开应用后先看到欢迎窗口，DSH 在后台启动。
2. 如果还没有配置模型 API Key，会出现 API Key 页面：
   • 保存并继续： 把密钥写入 DeepSeek 官方提供方的配置，然后进入工作区；
   • 稍后配置： 先进入工作区，下次启动时会再次检查。
3. 进入后用系统的文件夹对话框选择工作区目录，建议先选一个可以丢弃的测试目录。

0.2.2-rc.1 的官方文档在“已知限制”中写明账号登录尚未接入，登录按钮处于禁用状态，所以目前请用 API Key。使用其他模型提供方或调整模型，见 Provider 与模型配置。

关闭窗口不等于退出

点关闭按钮只会隐藏窗口，页面和正在运行的任务会继续在后台执行：Windows 留在系统托盘，macOS 留在 Dock。要真正退出，请使用 ⌘Q、应用菜单或托盘菜单里的“退出”。如果还有任务在跑，退出前会提示是否中断。

更新

• 自动检查： 应用启动后会检查更新，之后大约每 10 分钟检查一次。自动检查不会弹窗，也不会自动下载安装包。
• 手动检查： 应用菜单中的“检查更新…”（Windows 在标题栏的“应用”菜单中）。界面左下角会显示更新状态，点击即可下载。安装需要重启应用，重启前会确认；有任务在运行时会提示中断。
• 强制更新： 服务端要求强制更新时，应用会弹出无法关闭的提示窗口。已经在运行的任务不会被停止，但在更新前不能再修改插件。
• 更新渠道： 在 0.2.2-rc.1 的源码中，渠道在打包时写死，默认是开发渠道 nightly，只有手动安装另一个渠道的安装包才能切换。官方下载包用的是哪个渠道，源码里无法确认。
• 0.2.2-rc.2 的变化： 新增“设置 → 通用设置 → 更新渠道”，可以在“正式版”和“开发版”之间切换。切换后立即生效，但不会降级，也不会自动安装。截至 2026-11-11，rc.2 只在 GitHub 预发布，尚未发布到 npm。

更新前的通用检查（备份、插件兼容、回退条件）见更新与卸载指南。

在桌面端安装插件

• 在应用里装： 打开“插件”页面。桌面端使用和 Web 版相同的插件管理器，插件装进 profiles/desktop。
• 用命令行装： 先启动一次桌面端完成初始化，完全退出应用，再运行 dsh plugin --profile desktop add <包名>（list、remove 同理）。下一次打开桌面端时生效。通过 npm 单独安装的 dsh 不能修改这个 Profile。
• 注意： 官方文档说明，桌面端遵循 pnpm 的构建权限，依赖包的安装脚本没有单独的审批对话框。安装第三方插件前，先在插件中心看清权限和风险标签。

在终端使用 dsh 命令

应用菜单里的“管理 dsh 命令…”（在“检查更新…”下方）可以安装、修复或移除终端里的 dsh 命令：

• macOS 会创建 /usr/local/bin/dsh，需要时系统会要求输入管理员密码，不修改 shell 启动文件；
• Windows 会把命令加到当前用户的 PATH；
• 这个命令使用桌面端自带的运行环境，版本跟着桌面端更新；
• 卸载桌面端不会自动移除这个命令，卸载前请先在同一菜单里选择“移除”。

PATH 等环境变量

macOS 从图形界面启动的程序默认读不到 ~/.zshrc、~/.zprofile 中设置的变量。桌面端在启动时会用你的登录 shell 读取一次环境变量，所以在这些文件里配置的 PATH（例如 git、Homebrew 工具）对 Agent 和终端都有效。修改启动文件后，要完全退出并重新打开桌面端才会生效。csh、tcsh、nushell 不兼容这个机制。Windows 不需要这一步。

出错时怎么办

桌面端遇到严重错误时会弹出恢复对话框，可以选择：

• 退出；
• 重启；
• 禁用第三方插件并重启：会把插件配置备份成带时间戳的文件，适合怀疑是插件导致的问题；
• 获取诊断报告：在文件管理器中定位崩溃报告。

崩溃报告的位置：macOS 在 ~/Library/Logs/DeepSeek Harness，Windows 在应用数据目录的 logs 下，只保留最近 10 份。报告里可能包含插件的输出内容，分享给他人前先检查有没有密钥或隐私信息。

另外，按 F12（macOS 也可以用 ⌘⌥I，Windows 用 Ctrl+Shift+I）可以打开开发者工具查看页面错误。更多启动问题见启动失败排查。

卸载与数据清理

1. 如果安装过 dsh 命令，先在应用菜单选择“管理 dsh 命令… → 移除”，然后退出桌面端。
2. 卸载应用：
   • macOS： 在 Finder 的“应用程序”中删除应用；
   • Windows： 在“设置 → 应用 → 已安装的应用”或控制面板中卸载。Windows 卸载程序会删除应用自己的数据和更新缓存，但不会删除 ~/.dsh。
3. 可选的数据清理：0.2.2-rc.2 的官方文档提供了清理脚本 ↗（外部链接，在新标签页打开）。它会永久删除 ~/.dsh，其中包括与命令行版共用的会话、凭据、设置和插件。还在用命令行版或 Web 版的话不要运行；确实要清理，先备份需要保留的会话。

只想换个版本或修复问题时，不需要清理数据，直接覆盖安装即可，官方说明覆盖更新会保留数据。

来源与核对

• 主要依据：0.2.2-rc.1 固定提交 66491b05 中的桌面端 README、打包文档与诊断文档；0.2.2-rc.2 固定提交 ddac9676 中的桌面端 README 与卸载清理指南；官方产品页；@DeepSeekHarness 2026-10-01 的桌面端发布文章 ↗（外部链接，在新标签页打开）。
• 核对日期：2026-11-11。官方产品页的下载链接只做了可访问性检查，没有下载安装。
• 部分内容只出现在官方的设计记录里，或者文档前后有出入（例如账号登录），本文都按较保守的说法处理。桌面端更新很快，以实际安装包的界面为准。