双击安装包 codeAnqiang-ma/dsh-installers

dsh-installers

DeepSeek Harness（dsh）双击即装的安装包——不用装 Node.js、不用 npm、不用配环境。

Release
Downloads
Build
License: MIT

English · 简体中文

DeepSeek Harness 以 npm 包发布：想体验必须先装 Node.js ≥ 22.19，再跑 npx @deepseek-ai/dsh web，首次还要等几分钟拉依赖。很多人只想点一下安装就用——社区一直在呼吁独立客户端。

这个项目就是那个安装包。 每个 Release 把官方 Node.js 运行时和官方原版 @deepseek-ai/dsh npm 包打进各平台的原生安装器：

下载 → 安装 → dsh web

非官方社区项目，与 DeepSeek 无隶属或背书关系。包内全部是官方上游产物的原样打包——见包里有什么。

下载

到 最新 Release 下载对应平台文件：

| 平台 | 客户端（推荐） | CLI 安装包 | 便携版 |
| macOS Apple Silicon（M1 及之后） | dsh--macos-arm64.dmg | dsh--macos-arm64.pkg | .tar.gz |
| macOS Intel | dsh--macos-x64.dmg | dsh--macos-x64.pkg | .tar.gz |
| Windows 10/11 x64 | — | dsh-setup--win-x64.exe | .zip |

每个 Release 都附 SHA256SUMS.txt 供校验。

安装

macOS — DSH.app（DMG）

打开 .dmg，把 DSH.app 拖进「应用程序」，双击。这个 App 会：

1. 启动本地 dsh web 服务（3080 端口已有服务在跑就直接复用，不重复启动）；
2. 等服务就绪后，
3. 用无地址栏、无标签页的应用窗口打开界面——装了 Chrome 或 Edge 时走 --app= 模式，否则退回默认浏览器普通打开。

未签名 App 首次启动：右键 → 打开 → 打开。

DSH.app 的真实构成，说在前面： 上游 DeepSeek Harness 只提供 Web UI，没有原生桌面客户端。DSH.app 是一个启动器：拉起本地服务，再把这个 Web UI 装进应用样式的窗口（渲染本质仍是浏览器内核）。服务日志在 ~/Library/Logs/dsh-web.log。

macOS — 命令行（.pkg）

1. 打开 .pkg。安装包未签名（社区构建，没有 Apple 开发者证书），如被 Gatekeeper 拦截：右键 → 打开 → 打开，或用终端安装：

sudo installer -pkg dsh--macos-arm64.pkg -target /

2. 完成。打开终端：

dsh --version
dsh web # Web UI 在 http://127.0.0.1:3080

不想用 sudo？用便携 .tar.gz：解压到任意目录，运行 /bin/dsh。

卸载（macOS）

sudo rm -rf /usr/local/dsh /usr/local/bin/dsh
sudo pkgutil --forget com.github.codeanqiang-ma.dsh

Windows

1. 运行 dsh-setup--win-x64.exe。SmartScreen 若提示（未签名）：更多信息 → 仍要运行。
2. 按用户安装，不需要管理员权限。装到 %LOCALAPPDATA%\Programs\dsh 并自动把 dsh 加入 PATH。
3. 开一个新终端：

dsh --version
dsh web

卸载（Windows）

设置 → 应用 → dsh (DeepSeek Harness) → 卸载。PATH 会自动清理。

包里有什么？可以信吗

每个安装包只含两样上游产物（构建时从官方源拉取并做 SHA-256 校验）加一个 5 行启动脚本：

dsh/
├── node/ 官方 Node.js 运行时，来自 nodejs.org（SHA-256 校验） ├── app/ npm install @deepseek-ai/dsh@，来自 registry.npmjs.org（原样） └── bin/ 启动脚本：exec node .../dsh/lib/bin.js "$@"

- 没有打补丁、没有重编译、没有注入。
- 全部产物由 GitHub Actions 公开构建——打开任意构建日志能看到每条命令。
- CI 不只构建：发布前会在干净的 runner 上真实安装每个包并跑 dsh --version。
- 不信二进制？一条命令自己构建（见下）——脚本总共约 100 行 shell/PowerShell。

因依赖树含原生模块（node-pty、koffi、ripgrep），各平台需分别构建。

自己构建

macOS（需对应硬件） bash scripts/build-macos.sh arm64 # 或 x64

Windows
pwsh scripts/build-windows.ps1

产物在 dist/。版本钉在 versions.env。

常见问题

为什么不签名？
代码签名证书要花钱（Apple 每年 $99）。校验和、公开构建日志、一条命令自建，是当前的透明度替代。项目有起色后第一件事就是上签名。

这会取代官方安装方式吗？
不会——只是包了一层。npx @deepseek-ai/dsh 照常可用；这是给没有（或不想装）Node.js 的人准备的。

DSH.app 是原生 Mac 客户端吗？
不是。上游只有 Web UI。DSH.app 负责启动本地服务，再用无边框浏览器应用窗口（Chrome/Edge --app= 模式）打开它。看起来、用起来像客户端，但渲染是浏览器内核——明说，不误导任何人。

上游发新版后多久跟进？
打包新版本只需改一行版本号 + 打个 tag，CI 全自动。缺版本欢迎提 issue。

Web UI 端口被占？
dsh web --port 。

跟进上游

DeepSeek Harness 处于快速迭代的开发者预览期。打包新版本：改 versions.env 的 DSH_VERSION，提交，打 v- tag，推送——CI 构建全部 6 个产物并发布 Release。

许可

本仓库：MIT。捆绑软件保留各自许可——见 NOTICE.md。DeepSeek Harness 为 MIT © DeepSeek；Node.js 遵循 Node.js license。

如果这个项目帮你省了一下午，点个 ⭐ 能让更多人找到它。