把 DeepSeek Harness 装进桌面窗口（DSH Desktop）

DeepSeek Harness（DSH）跑在本地，通过浏览器打开它的 Web UI 来操作，插件、工作配置、版本升级各自处理各自的。DSH Desktop 给这套东西套了一层原生桌面外壳，应用自己启动并管理本地 Harness 服务，把窗口、托盘、终端、更新和工作配置一并接管，用户不需要安装 Node.js，也不用执行命令。

桌面壳本身也按插件的方式接进运行时。上游 DeepSeek Harness 以固定版本原样运行，桌面外壳作为 DSH 插件，与第三方插件走同一套组合机制，README 把它概括为「万物皆插件」。当前正式安装包覆盖 Windows x64 与 macOS Universal，仓库主语言是 TypeScript。

DSH Desktop 是基于 DeepSeek Harness 的开源桌面客户端，用 TypeScript 写成，把 DSH 的 Web UI、Host 服务与插件系统装进 Windows 和 macOS 原生窗口，下载安装后即可使用。

项目由 anywhere-labs 维护，采用 MIT 许可证，仓库地址是 https://github.com/anywhere-labs/dsh-desktop，截至 2026 年 10 月 3 日有 29849 个 Star、1422 个 Fork 与 338 个开放 Issue。仓库声明它是社区独立项目，与深度求索不存在隶属、合作、授权或背书关系。

它解决的是什么问题

上游 DSH 以本地服务加 Web UI 的形式工作。要用起来，先得把运行环境准备好，把 Host 服务起起来，再用浏览器连上去，插件、工作配置、版本升级分散在不同环节，版本兼容也要自己盯。README 对桌面端的描述是「无需安装 Node.js 或执行命令」，反过来就是之前这些事都得自己动手。

把这些收进一个安装包之后，流程变成装应用、由应用接管本地服务的启停，托盘常驻，更新在应用内下载安装。对天天写代码的人，原来那套方式不算门槛；对把 DSH 当日常工具用的人，少一层环境配置就少一类出错的地方。

典型使用场景

• 在 Windows 或 macOS 上想用图形界面跑 DSH 的用户。装上安装包后，首次启动会先进入 Desktop 自己提供的原生 Setup Wizard，可以设置窗口模式与系统材质、插件市场、通知、是否用系统默认浏览器自动打开，以及 Web 访问范围，也可以直接跳过。
• 需要离开电脑继续跟进任务的人。2.0.9 及以上版本内置了手机远程控制，用 iOS 或 Android 连上 Desktop，可以在手机上发起任务、查看 Agent 进度并继续跟进。
• 想给 DSH 加能力的用户。内置的 DSH Community Market 提供插件的发现、详情、安装与管理，市场以开放方式连接插件数据源，任何符合公开 Schema 的来源都可以被接入使用。
• 插件开发者。Desktop 自己就是一个 DSH 插件，桌面服务允许插件查看和切换工作配置，或在当前配置中安装、更新和移除插件。

几个常见疑问

用之前需要先装 Node.js 吗？

不需要。README 写的是「无需额外环境，下载安装，一键使用」。Windows 平台运行 NSIS 安装程序并按提示完成安装，macOS 打开 DMG 后把 DSH Desktop 拖进 Applications。当前正式安装包覆盖 Windows x64 和 macOS Universal。

同一局域网里的其他设备能访问吗？

默认不能。Web 服务默认只监听本机回环地址。开启「用浏览器打开」只是让 Desktop 在 Web 服务实际就绪时交给系统默认浏览器打开，不改变网络暴露范围。局域网访问是一个独立的可选设置，开启后会显示当前可用的局域网 URL。README 对这一点给了明确警告：向局域网开放不提供鉴权，所有处于同一局域网的人都能直接打开 DSH 并操作你的电脑。

Linux 上有正式安装包吗？

没有。正式安装包只覆盖 Windows x64 与 macOS Universal。Issue 里有用户提过 Linux 平台的打包、图标与托盘问题，实测可以直接打包，希望随后续版本发布，该讨论状态为已解决。v2.0.17 的发布说明里也提到修复 Linux AppImage 在应用内重启后无法重新启动的问题。Linux 构建在推进，但没有出现在下载列表里。

主要功能

• 原生桌面外壳：把上游 DSH 的本地 Web UI 带到原生窗口，应用自动启动和管理本地 Harness 服务，集成系统托盘与桌面窗口。窗口、托盘、终端、更新、工作配置都作为 DSH 插件接入同一个运行时。
• 手机远程控制：2.0.9 及以上版本内置，通过 iOS 和 Android 远程连接 Desktop，在手机上发起任务、查看 Agent 进度。
• 插件市场：DSH Community Market 已内置，提供插件发现、详情、安装与管理。市场以开放方式连接插件数据源，已有 API 可以通过受审 adapter 加入合作数据源。
• Setup Wizard：每个尚未初始化的 profile 首次启动时显示，可设置窗口模式与系统材质、插件市场、通知、是否用系统默认浏览器自动打开、Web 访问范围，也可跳过。向导完成或跳过以前，Host 和主 DSH 窗口都不会启动。
• 内置终端与 CLI：v2.0.17 适配了新版内置终端和 Desktop Profile 插件管理流程，支持通过应用提供的 CLI 安装、移除插件及管理版本兼容例外。
• 自动化任务通知：v2.0.16 加入，任务完成和失败会发桌面通知，提供独立开关，默认开启。
• 更新与通道：应用内更新，固定版本检查请求会带上当前安装版本与通道标识。

安装与最短示例

从官网 dshdesktop.cn 或仓库 Release 页下载对应平台的安装包，Windows 运行 NSIS 安装程序，macOS 打开 DMG 拖入 Applications。两个下载入口分别是：

Windows x64: https://www.dshdesktop.cn/api/downloads/windows
macOS Universal: https://www.dshdesktop.cn/api/downloads/mac

装完直接启动即可。插件的安装与移除有两条路：应用内的插件市场，或者应用提供的 CLI。CLI 的具体命令写法在 README 节选里没有给出，官方把它放在用户指南 docs/user-guide.md 里。

关键参数

• Web 访问范围：默认只监听本机回环地址；「用浏览器打开」只影响是否自动唤起系统浏览器，不改变暴露范围；局域网访问是独立开关。
• profile：Setup Wizard 的完成或跳过状态按 profile 分别记录，显式恢复启动会优先进入恢复助手。
• 更新请求头：固定版本检查请求在 X-DSH-Desktop-Version 里携带当前安装版本，在 X-DSH-Desktop-Channel 里携带 stable 或 beta，在 X-DSH-Desktop-Installation-Id 里携带一个本机生成并持久保存的随机 UUID。这个 UUID 不是从硬件信息推导出来的。
• 安装包下载：下载请求携带通道和 X-DSH-Desktop-Target-Version，但下载请求及其重定向不会携带安装标识或当前版本。
• 通知开关：自动化任务通知默认开启，可以单独关闭。

结果在哪里看

日常使用的结果都在桌面应用里。会话与 Agent 进度在主 DSH 窗口，托盘常驻提供快速入口，本机 URL 显示在「桌面设置」的对应选项下。任务完成或失败会弹桌面通知。会话日志的下载和 /export 在 v2.0.17 里修过一次无响应的问题，这两个入口就是导出结果的地方。插件装了哪些、有没有可用更新，在插件市场里看。

实际使用中的坑

• macOS 版本最小化后会自动打开到前台并占据焦点，这条 Issue 目前是待解决状态。
• 2.0.10 里交付卡片的「在文件资源管理器中显示」点击后没有反应。排查结果是 Explorer 窗口以隐藏状态创建（windowsHide:true），非 ASCII 文件名也无法被选中。这条同样待解决。
• Linux 在 2.0 打包后的图标与托盘问题：打包后桌面软件没有图标，deb 的 icon 处理有问题；软件 close 后托盘不渲染，后台线程还在。另有用户希望加一个限制，防止同时启动桌面端和 dsh web 导致会话加载失败、会话存储损坏。这条讨论已解决。
• Windows 上 pwsh 子进程以 0xC0000142 崩溃是一类反复出现的问题，仓库用一条汇总 Issue 收敛了多份报告，根因已坐实，状态为已解决。
• 有用户反馈安装过程很慢，这条还没有关闭。

和同类的差别在哪

下表里的两个项目都是 DSH 生态里的同类桌面端，选它们是因为解决的确实是同一件事。

本项目在 DSH 之外的能力集成上不如 See-Sol-Lab/DeepSeekGUI：后者仓库描述写明集成了 Git、内置浏览器与记忆功能，这几项没有出现在 DSH Desktop 的 README 功能列表里。日常工作流依赖内置 Git 面板、或者不想再开一个外部浏览器的话，先去那一边看清楚再决定。反过来，需要托盘、原生 Setup Wizard、插件市场和手机远控这些桌面层能力时，本项目的说明更完整。

焚评：这个项目的量化评分

本项目的选题来自 焚.com（一个按公开公式给 GitHub 项目打分的站）。焚评当前总分 9.8 分（满分 10）。下表是各维度的得分：

评分口径、权重与计算方式见焚.com 的评分方法页；数据随 GitHub 指标刷新，具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写，评分数据由焚.com 授权引用。