--- title: "DSH 桌面端安装与使用：下载、更新、插件、数据与卸载" seo_title: "DeepSeek Harness 桌面端教程：下载安装、更新渠道、插件与卸载" description: "在 macOS 或 Windows 安装 DeepSeek Harness 桌面端，弄清它和 npx Web 版共用哪些数据，配置 API Key、更新、插件与 dsh 命令，并安全卸载、按需清理数据。" canonical: https://52dsh.com/tutorials/dsh-desktop-app-guide/ authors: ["52DSH 编辑部"] audience: [] outcomes: [] prerequisites: ["macOS（Apple Silicon）或 Windows x64","DeepSeek API Key 或其他模型提供方凭据","已有 CLI 用户：先备份 ~/.dsh"] difficulty: beginner estimated_action_time: null next_steps: null published_at: 2026-11-11 updated_at: 2026-11-12 verified_on: 2026-11-11 maintenance_status: community verification_level: source_reviewed risk_level: medium dsh_version: 0.2.2-rc.1 plugin_id: null tutorial_kind: null related_plugin_url: null --- # DSH 桌面端安装与使用：下载、更新、插件、数据与卸载 在 macOS 或 Windows 安装 DeepSeek Harness 桌面端，弄清它和 npx Web 版共用哪些数据，配置 API Key、更新、插件与 dsh 命令，并安全卸载、按需清理数据。 DeepSeek Harness 桌面端是官方提供的 macOS 和 Windows 应用，2026-09-29 随 v0.2 预览版发布。它是在完整的 DSH Web 应用外面套了一层 Electron 壳，自带运行环境，**不需要先装 Node.js**。下载入口在[官方产品页](https://www.deepseek.com/harness)。 和 `npx @deepseek-ai/dsh web` 相比，最需要注意的是：桌面端和命令行版**共用 `~/.dsh` 下的会话、设置、凭据和工作区**，但插件各装各的。已经在用命令行版的用户，先备份 `~/.dsh` 再装桌面端。 本文按 DSH `0.2.2-rc.1`（固定提交 `66491b05`）的官方源码与文档整理，`0.2.2-rc.2` 的差异单独标注。52DSH 没有下载、安装或运行桌面端，下文的行为描述都来自官方文档，不是实测结果。 ## 下载与系统要求 | 平台 | 官方产品页提供的下载 | 安装方式 | |---|---|---| | macOS（Apple Silicon） | `dsh-latest-macos-arm64.dmg` | 打开 DMG，把应用拖进“应用程序” | | Windows x64 | `dsh-latest-windows-x64.exe` | NSIS 安装程序，只为当前用户安装，可以改安装目录 | - **Intel Mac：** 官方源码支持打包 Intel 版，但截至 2026-11-11 官方产品页只列出了 Apple Silicon 和 Windows 两个下载。Intel Mac 用户请以官方产品页为准，或者改用 [Web 版](/tutorials/deepseek-harness-install-web-ui/)。 - **Linux：** 官方打包文档明确说 Linux 不是桌面端的发布目标。Linux 用户请使用 Web 版。 - **下载文件名带 `latest`，但不带版本号。** 截至 2026-11-11，两个安装包的服务器修改时间都是 2026-11-05，但官方没有在下载页标注版本号，本站不能确认它对应哪个 DSH 版本。安装后可以在应用菜单的“关于 DeepSeek Harness”里查看实际版本。 ## 桌面端和 npx Web 版是什么关系 | 方面 | 桌面端 | `npx @deepseek-ai/dsh web` | |---|---|---| | 运行环境 | 自带，不要求系统装 Node.js 或 pnpm | 需要 Node.js（0.2.2-rc.1 要求 ≥24.9.0） | | 版本 | 桌面壳与内置 DSH 始终是同一个精确版本，随应用更新 | 由你运行的 npm 版本决定 | | 会话、设置、凭据、工作区 | 与命令行版**共用** `$DSH_HOME`（默认 `~/.dsh`） | 同左 | | 插件 | 装在独占的 `profiles/desktop` 中，命令行版不能启动这个 Profile | 装在各自的 Profile 中 | | 访问地址 | 只在本机 `127.0.0.1` 上运行，使用系统分配的端口（不占 3080），界面在应用窗口里 | 默认 `http://127.0.0.1:3080`，在浏览器里打开 | 官方文档说明，两者的可执行文件、插件启用状态和锁文件相互隔离，但没有说明同时打开桌面端和 Web 版操作同一个会话是受支持的用法。稳妥的做法是同一时间只用一个入口操作同一份会话。桌面端不会和 Web 版争用 3080 端口；如果桌面端启动时报端口占用，按恢复对话框的提示先退出其他正在运行的 DSH。 ## 第一次启动 1. 打开应用后先看到欢迎窗口，DSH 在后台启动。 2. 如果还没有配置模型 API Key，会出现 API Key 页面： - **保存并继续：** 把密钥写入 DeepSeek 官方提供方的配置，然后进入工作区； - **稍后配置：** 先进入工作区，下次启动时会再次检查。 3. 进入后用系统的文件夹对话框选择工作区目录，建议先选一个[可以丢弃的测试目录](/tutorials/safe-agent-workspace/)。 0.2.2-rc.1 的官方文档在“已知限制”中写明**账号登录尚未接入，登录按钮处于禁用状态**，所以目前请用 API Key。使用其他模型提供方或调整模型，见 [Provider 与模型配置](/tutorials/deepseek-harness-model-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。 更新前的通用检查（备份、插件兼容、回退条件）见[更新与卸载指南](/tutorials/dsh-update-uninstall/)。 ## 在桌面端安装插件 - **在应用里装：** 打开“插件”页面。桌面端使用和 Web 版相同的插件管理器，插件装进 `profiles/desktop`。 - **用命令行装：** 先启动一次桌面端完成初始化，**完全退出应用**，再运行 `dsh plugin --profile desktop add <包名>`（`list`、`remove` 同理）。下一次打开桌面端时生效。通过 npm 单独安装的 dsh 不能修改这个 Profile。 - **注意：** 官方文档说明，桌面端遵循 pnpm 的构建权限，依赖包的安装脚本没有单独的审批对话框。安装第三方插件前，先在[插件中心](/plugins/)看清权限和风险标签。 ## 在终端使用 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）可以打开开发者工具查看页面错误。更多启动问题见[启动失败排查](/errors/web-ui-start-failed/)。 ## 卸载与数据清理 1. 如果安装过 `dsh` 命令，先在应用菜单选择“管理 dsh 命令… → 移除”，然后退出桌面端。 2. 卸载应用： - **macOS：** 在 Finder 的“应用程序”中删除应用； - **Windows：** 在“设置 → 应用 → 已安装的应用”或控制面板中卸载。Windows 卸载程序会删除应用自己的数据和更新缓存，但**不会删除 `~/.dsh`**。 3. 可选的数据清理：0.2.2-rc.2 的官方文档提供了[清理脚本](https://github.com/deepseek-ai/deepseek-harness/blob/ddac96760b6edf8fa0fe17cbdcf0b512f4c12b2c/docs/user/guide/desktop-uninstall-cleanup.zh.md)。它会**永久删除 `~/.dsh`**，其中包括与命令行版共用的会话、凭据、设置和插件。还在用命令行版或 Web 版的话不要运行；确实要清理，先备份需要保留的会话。 只想换个版本或修复问题时，不需要清理数据，直接覆盖安装即可，官方说明覆盖更新会保留数据。 ## 来源与核对 - 主要依据：0.2.2-rc.1 固定提交 `66491b05` 中的桌面端 README、打包文档与诊断文档；0.2.2-rc.2 固定提交 `ddac9676` 中的桌面端 README 与卸载清理指南；官方产品页；@DeepSeekHarness 2026-10-01 的[桌面端发布文章](https://x.com/DeepSeekHarness/status/2105330281389662575)。 - 核对日期：2026-11-11。官方产品页的下载链接只做了可访问性检查，没有下载安装。 - 部分内容只出现在官方的设计记录里，或者文档前后有出入（例如账号登录），本文都按较保守的说法处理。桌面端更新很快，以实际安装包的界面为准。 ## 原始来源 - https://www.deepseek.com/harness - https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/apps/desktop/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/apps/desktop/packaging/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/apps/desktop/docs/diagnostics/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/blob/ddac96760b6edf8fa0fe17cbdcf0b512f4c12b2c/apps/desktop/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/blob/ddac96760b6edf8fa0fe17cbdcf0b512f4c12b2c/docs/user/guide/desktop-uninstall-cleanup.zh.md - https://x.com/DeepSeekHarness/status/2105330281389662575