DeepSeek Harness 桌面版:官方 Web UI vs 社区客户端 (2026)
下载安装前必读:官方 Web UI、社区桌面客户端,以及一份防止假安装包和盗号软件的安全清单。
最近更新: 2026-09-09
搜索 DeepSeek Harness 桌面版的人,通常带着两个问题:一是想把 dsh 装成带窗口的桌面程序,二是正准备下载某个安装包、想确认它安不安全。两个问题可以从同一个地方开始。
DeepSeek 官方目前没有发布 DeepSeek Harness 的桌面客户端。官方的图形界面是自带的 Web UI,社区项目则把这个 Web UI 包进桌面应用。任何第三方下载站、应用商店里的条目和安装包,都值得先验证再下手。
DeepSeek Harness 目前没有官方桌面客户端。官方支持的图形界面是 Web UI:运行 dsh --profile web,浏览器打开 http://127.0.0.1:3080。社区客户端(如 DSHDesktop)把同一个 Web UI 包成 Windows / macOS 原生应用——安装前请先过一遍本页的安全清单。
三种方式速览
官方 Web UI(推荐)
唯一官方图形界面。浏览器访问 http://127.0.0.1:3080,由 dsh 命令行管理,插件、Profile、预设和模型设置全部可用。
适合:所有刚入门的人
社区桌面客户端
把同一个 dsh Web UI 包进原生窗口。客户端内置 Node.js 和 @deepseek-ai/dsh,无需提前安装环境;部分还提供托盘图标、通知和会话管理。
适合:Windows / macOS 用户,想要一个真正的应用图标
目录里的桌面风格插件
改 UI、加面板、做系统集成的插件,全部跑在官方 dsh web 内部。
适合:不想装壳程序、只想定制界面的人
官方路径:Web UI
- 1
安装命令行工具
需要 Node.js 20 或更高版本,然后一条全局命令:npm install -g @deepseek-ai/dsh。Windows 上在 PowerShell 里执行同样命令。
$ node --version$ npm install -g @deepseek-ai/dsh - 2
启动 Web Profile
运行 dsh --profile web(dsh web 是同一个命令的简写),会启动 harness 并自动打开浏览器。没有自动打开就手动访问 http://127.0.0.1:3080。
$ dsh --profile web - 3
接入模型
在 platform.deepseek.com 创建 API Key,粘贴到初始化弹窗;也可以在设置里更换其他 Provider。harness 本身免费开源,只有 token 用量计费。
$ open http://127.0.0.1:3080
Web UI 就是官方的桌面体验:所有桌面客户端包的都是这套引擎,每次 dsh 发版都会同步更新。
值得关注的社区客户端
目前有两个社区桌面客户端值得了解。它们都是开源、与 DeepSeek 官方无关的独立项目,包的是同一套官方 dsh 运行时——但在成熟度、签名方式和平台支持上差异明显。
DSHDesktop(dataelement/dsh-desktop)是目前最大的社区客户端——MIT 协议,约 4,000 stars,v0.7.x(2026 年 9 月),官网 dshdesktop.com。它自动启动本地 Harness 运行时,并提供已签名、已公证的原生应用:macOS(Apple Silicon + Intel)和 Windows x64;不支持 Linux 和 Windows ARM。
DSH Desktop(myyangyunfan/dsh_desktop)是零配置的另一选择:内置 Node.js 运行时与 @deepseek-ai/dsh 及全部官方插件,离线可用。支持 Windows 10/11 x64 与 macOS 12+;安装包在 GitHub Releases(Windows NSIS .exe 约 87 MB,macOS .dmg)。macOS 版目前未签名——首次打开会提示「无法验证开发者」,右键→打开,或执行 xattr -dr com.apple.quarantine "/Applications/DSH Desktop.app"。
桌面便利功能:原生窗口、系统托盘、任务完成通知、会话归档/恢复/删除和实时余额小部件,都叠加在标准 dsh web 之上。会话数据存放在用户目录下(Windows 为 %APPDATA%\DSH Desktop\,macOS 为 ~/Library/Application Support/DSH Desktop/);可用 DSH_HOME 环境变量改位置。
小心「官方外观」的克隆项目:比如 sdkwork-ai/deepseek-harness-desktop 就复刻了 DeepSeek 品牌标识,实际与官方无关。下载前先核对仓库所有者与项目官网——“使用了 DeepSeek Harness” 不等于 “DeepSeek 官方发行版”。
下载安全清单
桌面软件会接触到你的文件系统和 API Key——这正是骗子盯上的组合。下载前先逐条核对:
官方软件只走官方渠道
DeepSeek 只通过 npm(@deepseek-ai/dsh)和 GitHub(deepseek-ai/deepseek-harness)分发 harness。商店里的条目是第三方:微软商店的「DeepSeek-Harness-Setup」是个人发布者(彭承家)的 ¥7 付费安装器,不是 DeepSeek 的产品——使用前先看发布者与评价。
只从项目自己的官网或 GitHub Releases 下载
认准 README 里写的那个仓库的 Releases 页面,或项目自己的官网。广告镜像站、网盘搬运、「秒下」按钮,绝大多数都指向假的或被篡改的文件。
不要向无法验证的软件粘贴 API Key
泄露的 DeepSeek API Key 等于敞开的钱包——任何人拿到都能花你的 token。如果软件在你还没看到源码、查不到口碑之前就要 Key,直接关掉。
看源码、许可证和活跃度
优先选开源的客户端:能读代码、有许可证、近期有提交和发布版本,维护者有历史记录。特别注意 GitHub 所有者名称——克隆站点常用相似仓库名、但挂着不同的所有者。
macOS 的 Gatekeeper 提示是正常的——但要核对下载地址
未签名的社区构建在 macOS 上会提示「来自身份不明的开发者」。小项目这样很正常;关键是你拿到的文件确实来自该项目自己的官网或 GitHub Releases 页面。
看到可疑的下载页或商店条目?去 /submit 提交反馈,或在项目仓库开 issue 提醒社区。
桌面版常见问题
选 DeepSeek Harness 桌面客户端时最常被问到的几个问题。
DeepSeek Harness 有官方桌面客户端吗?
还没有。官方图形界面是 Web UI:dsh --profile web 启动后访问 http://127.0.0.1:3080。DSHDesktop 这类桌面客户端是社区项目,把同一个 Web UI 包进原生应用。
怎么把 DeepSeek Harness 当桌面应用用?
安装 CLI(npm install -g @deepseek-ai/dsh)后运行 dsh --profile web,浏览器就会打开 Web UI。想要原生窗口,就再装一个 DSHDesktop 或 DSH Desktop 这样的社区客户端。
社区桌面客户端安全吗?
两个主流客户端都是开源的(MIT),代码可以自己审查。DSHDesktop(dataelement)在 dshdesktop.com 提供已签名、已公证的 macOS / Windows 构建;DSH Desktop(myyangyunfan)规模较小,macOS 版未签名。两者都不是 DeepSeek 官方产品——只从项目自己的官网或 GitHub Releases 下载。
微软商店里的「DeepSeek Harness」是官方的吗?
不是。那个列表是个人发布者(彭承家)的 ¥7 付费第三方安装器;DeepSeek 没有在微软商店发布桌面应用,harness 本身也不收费。在 Windows 上受支持的方式是 npm CLI——详见 Windows 安装教程。
桌面客户端比浏览器里的 Web UI 快吗?
两者跑的是同一个 dsh Web UI 引擎,性能基本一致。桌面客户端的优势在体验:真正的窗口、系统托盘、通知、会话管理,以及离线可用的内置运行时。
DeepSeek Harness 桌面客户端从哪里下载?
DSHDesktop 从 dshdesktop.com 或其 GitHub Releases 下载;DSH Desktop(myyangyunfan)从它的 GitHub Releases 页面下载。不要用来路不明的下载站——原因见上面的安全清单。
相关指南
桌面环境就绪后,继续深入。
DeepSeek Harness Windows 安装教程
10 步实机截图安装教程:Node.js、npm 全局安装、3080 端口的 Web UI、API key,Win10/11 免 WSL。
阅读指南安全地安装插件
dsh 里“安装插件”到底发生什么,附一套第三方代码审查清单。
阅读指南沙箱、审批与密钥
dsh 的安全模型:沙箱三档、审批策略、守卫,以及你的密钥去了哪里。
阅读指南故障排查与报错百科
症状 → 原因 → 修复:安装失败、pnpm workspace allowlist 报错、cordis.patch.yml 冲突、bundle 格式错误与 Profile 不生效。
阅读指南DeepSeek Harness 插件商店与目录 | dsh 插件市场
DSH 插件商店:浏览 15,774+ DeepSeek Harness 插件 —— UI 皮肤、工具、工作流、Agent,全部与 GitHub 同步,可按分类、星标与更新时间搜索。
阅读指南