只要把 start-dsh.bat 放到 Windows 桌面当快捷方式,双击一下,浏览器里就能用上 DeepSeek Harness 网页版——自动装好 Node.js 和官方 npm 包,完全不懂命令行也能秒开;只装官方包,不碰任何第三方二次封装。


一、写这个脚本的原因

DeepSeek Harness 目前官方只发布了 npm 包,想用它得先会这一套:

npx @deepseek-ai/dsh web

对程序员来说稀松平常,但对普通用户,门槛全在"Node.js 是什么、npm 怎么用、命令在哪敲"上。更麻烦的是,网上已经出现一些二次开发的"桌面端",你不知道它有没有夹带私货、会不会偷数据、更新及不及时。

所以就有了这个项目:一个即下即用、只用官方包的一键启动脚本。

二、它能帮你做什么

你期望的事 脚本自动做的事
双击就能用 自动检测环境,缺什么装什么
不想装 Node.js 检测到没有,自动用 winget 装 Node.js LTS
不想敲命令装 dsh 首次运行自动从官方源装好,存到本地
以后要秒开 首次装好后,之后双击 1 秒左右就启动
怕忘记更新 每天后台自动检查一次更新,发现新版自动升级
怕装到假货 只从 npm 官方 registry 下载 @deepseek-ai/dsh
国内下载慢/卡 默认用 npmmirror 国内镜像,安装更快

三、快速开始(只要 3 步)

  1. 打开 GitHub 仓库,下载 start-dsh.bat
  2. 双击运行
  3. 首次运行自动安装(需联网,约 1~3 分钟),完成后自动打开 http://127.0.0.1:3080

之后的每次启动都是一键,约 1 秒,且无需联网。

四、进阶用法

命令 作用
start-dsh.bat 启动(双击即可)
start-dsh.bat update 手动更新到最新版
start-dsh.bat check 检查环境(Node / npm / dsh / 版本号 / 服务状态)
start-dsh.bat uninstall 一键卸载

check 输出长这样,排查问题一目了然:

==========================================
  DeepSeek Harness environment
==========================================
  [v] Node.js   : installed
  [v] npm       : installed
  [x] global dsh: not found
  [v] local dsh : ready (0.1.0-rc.6)
  [v] server    : running at http://127.0.0.1:3080

五、为什么说它安全

这是它区别于网上"桌面端"的核心,坚持三条原则:

  • ✅ 唯一来源:只从 npm 官方 registry 安装 @deepseek-ai/dsh,不下载、不执行任何第三方可执行文件
  • ✅ 完全透明:全部逻辑就一个 .bat 纯文本文件,可逐行审计,没有任何混淆
  • ✅ 零收集:不收集任何数据,唯一联网行为就是安装/更新官方包本身

六、工作原理

复制

双击
 ├─ 服务已在运行?        → 直接开浏览器(不重复启动)
 ├─ 本地已装 dsh?        → 直接启动(最快,约 1 秒)
 ├─ 全局装了 dsh?        → 直接用全局版本
 └─ 都没有?
     ├─ 没 Node.js        → winget 自动安装 Node.js LTS
     └─ 首次安装 dsh 到 %LOCALAPPDATA%\DeepSeek-Harness → 启动

七、常见问题

Q:首次启动为什么比较久?

A:正在下载官方 dsh 包(约几十 MB)。之后启动只需约 1 秒,无需联网。

Q:端口 3080 被占用怎么办?

A:关闭占用 3080 端口的程序,或先运行 start-dsh.bat check 查看状态。

Q:怎么完全卸载?

A:运行 start-dsh.bat uninstall,或手动删除 %LOCALAPPDATA%\DeepSeek-Harness 目录。

Q:支持什么系统?

A:Windows 10 / 11,任何语言版本均可。

Q:国内安装很慢或卡住怎么办? 

A:脚本已默认使用 npmmirror 国内镜像;镜像失败会自动回退官方源。

八、仓库地址

如果帮到了你,欢迎点个 Star ⭐,有问题或建议可以提 Issue。


免责声明

本项目是社区工具,不是 DeepSeek 官方产品;它只负责下载并运行官方 @deepseek-ai/dsh npm 包,与 DeepSeek 官方无隶属或背书关系。

Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐