
DeepSeek Harness 发布了有一段时间了
8 月 17 号 DSH 上线那天,GitHub Star 一天就破了 5 万。到 8 月 21 号,社区统计仓库 Star 已经逼近 17 万。插件生态也疯了,dsh-plugin 话题下挂了 8973 个仓库。DeepSeek 出的这个 Agent 框架,确实有点东西。
但想上手的人,第一步就容易被劝退。
你得先装 Node,再配 npm 镜像,然后跑 dsh web,最后再点击命令行的链接才能在浏览器中使用(虽然官方有npx临时运行的方式,终归是要使用命令行,没有开发经验的用户,需要折腾半天才能用上。
dsh宣称,一切皆插件,所以我顺手做了一个东西:iyam-dsh-desktop。一个 DSH 的桌面客户端,双击就能用,不用你自己装 Node。
#一、简单介绍一下
iyam-dsh-desktop 是 DeepSeek Harness 的跨平台原生桌面客户端。
它的核心就一件事——把 DSH 整个装进一个 App 里。你第一次打开它,它会自动把 Node 运行时和 DSH 内核下载部署到本地的 ~/.dsh 目录,然后直接把 Web UI 加载出来。整个过程你不需要手动装 Node,也不需要碰命令行。
它是用 Tauri v2 做的。Rust 管底层进程,React 管界面,最后壳里嵌的是 DSH 自己的 Web UI。体积很小,安装包本身才 10MB 出头,因为真正重的东西(Node 加 DSH 内核)是首次启动时按需下载的,部署完一共大概 600 到 800MB。
对比官方原版,差别在哪?原版是一行命令跑起来的命令行工具。它是双击就能开的桌面应用,装好之后每次秒级启动。
#二、为什么你需要它
先说官方 DSH 的门槛到底卡在哪。
第一,要装 Node.js,版本还得够新。第二,国内网络下 npm 装 @deepseek-ai/dsh 经常卡,得自己换镜像。第三,跑起来是个本地 Web 服务,端口要自己记。第四,想装社区插件市场 dshmarket,还得再敲一条命令。
对纯开发者来说这些不算难。但如果你只是想赶紧体验一下 DSH 能干嘛,这几步下来,热情就消了一半。
iyam-dsh-desktop 是把这些门槛一个个抹平的:
开箱即用。 首次启动自动下载 Node 运行时和 DSH 内核,镜像按 npmmirror → 腾讯云 → 华为云 → 官方源回退,基本一两分钟搞定,之后直接复用,秒级启动。
跨平台。 macOS(Intel 和 Apple Silicon 都支持)、Windows 10/11、主流 Linux 发行版,一个客户端全包了。
完整生态兼容。dsh plugin add / remove、Agent Presets、Cordis 插件系统,原版能用的它都能用。
系统通知点击唤起。 DSH 跑完一轮对话,系统弹通知,你点一下应用窗口就到前台了。
内置插件市场。 启动后会问你要不要装 dshmarket,装好就能在应用里浏览、搜索、一键安装社区插件。
以前你要自己配环境、记端口、敲命令。现在双击一下,剩下的它替你办了。
谁适合用? 想快速试 DSH 能干什么、不想碰命令行的人;已经在用 DSH、想要个图形壳加系统通知的人;想一键装社区插件的人。如果你本来就是终端党、享受自己配环境,那原版命令行也挺好,这个客户端不是给你准备的。
#三、怎么用
第一步,下安装包。 去 GitHub 的 Releases 页面,按你的系统选对应的包。macOS 是 .dmg,Windows 是 .exe 安装包,Linux 是 .deb 或 .AppImage。地址是 github.com/iyam-x/iyam-dsh-desktop/releases。装完之后如果你习惯终端,也可以直接用 ~/.dsh/bin/dsh(Windows 是 dsh.cmd)在命令行里调起同一套环境。
第二步,看系统要求。 macOS 10.15 以上,Windows 10 1803 以上,或者主流 Linux。磁盘留至少 1GB 空间。不需要提前装 Node,但首次启动必须联网,因为要下载运行时和内核。
第三步,双击启动。 第一次打开会看到「正在安装 DeepSeek Harness…」的提示。它在后台做三件事:从镜像源下载 Node 24 归档,用托管 Node 的 npm 把 @deepseek-ai/dsh 装到 ~/.dsh,然后自动启动 DSH 并加载 Web UI。这一步大概一两分钟,之后日常打开就是秒级,不再下载。
几个常见问题,先给你备着。
macOS 提示「无法验证开发者」?这是未签名版本,右键点图标选「打开」就行,正式版之后会补签名公证。
Windows 弹出 SmartScreen?点「更多信息」再点「仍要运行」。
首次启动卡在「正在安装」?先查网络能不能访问 npmmirror 或 npm 官方源,安装日志在 ~/.dsh/.iyam-dsh-stderr.log。
如果想彻底卸载,点击删掉应用,再删掉 ~/.dsh/ 目录,就清干净了,包括下过的 Node 和 DSH。
#四、几个避坑提示
老实说几个目前的限制,免得你踩了骂我。
代码签名还没做。 macOS 和 Windows 发布前建议做平台签名公证,否则第一次打开会有系统安全警告。现在的解法是右键打开或点仍要运行。
Windows 需要 WebView2。 大部分 Win10/11 默认已经装了,但老系统可能没有,得先装 Runtime。
首次启动必须联网。 内核和 Node 是首次启动时下载的,保证能访问那几个镜像源。安装包本身才 10MB,不含运行时。
Node 版本跟着发版走。 Node 版本由源码里的常量控制,升级 Node 要重新发版。DSH 版本可以应用内「检查更新」独立升,不用重装整个应用。
#五、项目已开源
这个项目已经开源,代码全在 GitHub 上:github.com/iyam-x/iyam-dsh-desktop。它解决的是一件小事:让想试 DSH 的人,别卡在装环境这一步。
夜雨聆风