一键启动器Jett-Wu/deepseek-harness-launcher

🇬🇧 English · 🇨🇳 中文

🚀 DeepSeek Harness 启动器

下载即运行 · 仅用官方包 · 零配置 · 无第三方代码

双击 start-dsh.bat，它会自动完成所有设置，然后打开 DeepSeek Harness 网页界面。
没有第三方桌面封装——它直接安装并运行官方 npm 包：安全、稳定，且始终保持最新。

✨ 功能特性

- 🪄 零门槛：没有 Node.js？它会通过 winget 自动安装；首次运行会安装官方包，之后几秒内即可启动
- ⚡ 快速：首次安装后约 1 秒即可启动；若已在运行，绝不会启动第二个实例
- 🔄 自动更新：每天在后台检查一次更新（零启动延迟）并自动升级
- 🛡️ 干净安全：仅从官方 npm 源安装 @deepseek-ai/dsh——无第三方二进制文件，无数据收集
- 🌍 通用：纯 ASCII 脚本，可在任何语言版本的 Windows 10/11 上运行
- 🚄 国内镜像：将 npm 切换到 npmmirror 源，以便在中国快速安装，并自动回退到官方源
- 🛠️ 自愈：如果更新失败或 Node.js 升级，下次启动会自动重建本地安装

🚀 快速开始

1. 下载 start-dsh.bat
2. 双击运行
3. 首次运行会自动安装所有内容（需要联网，约 1–3 分钟），然后打开 http://127.0.0.1:3080

就这样——之后每次启动只需一键。

提示：将 start-dsh.bat 固定到任务栏，或发送桌面快捷方式以便日常使用。

📖 使用方法

| 操作 | 方法 |
|---|---|
| 启动 | 双击 start-dsh.bat |
| 更新到最新版 | 在终端中运行 start-dsh.bat update |
| 检查环境 | 在终端中运行 start-dsh.bat check |

🧩 推荐插件

社区推荐的插件（非官方维护——请逐个安装，并在依赖前查看各仓库的 issues）：

| 插件 | 功能 |
|---|---|
| @linxin666/dsh-web-all | 一体化 Web UI 套件：任务看板、git 图谱、右侧面板（文件/终端/浏览器）、皮肤中心 |
| @liustack/modsearch | 为没有联网能力的模型添加网页搜索、X 搜索和页面抓取——免费、无需 API 密钥、自动引擎故障转移 |
| dsh-ego-browser | 为智能体提供内置浏览器：语义点击、表单填写、截图 |
| @kingOfSoySauce/dsh-liang-skin | 一款滑变电阻风格的 Web UI 皮肤 |
| dsh-approval-gate（GitHub 仓库） | 自动审批门：预判有风险的操作，自动批准安全的操作，将危险操作转交人工处理（故障安全） |

🔒 安全性

此脚本的存在是为了让你运行官方程序，而非不可信的重新打包版本：

- ✅ 唯一来源：来自官方 npm 注册表的 @deepseek-ai/dsh
- ✅ 绝不下载或运行任何第三方可执行文件
- ✅ 全部逻辑就是一个 .bat 文件，你可以逐行审计
- ✅ 不收集数据——唯一的网络活动是安装/更新官方包

⚠️ 免责声明

这是一个社区工具，并非 DeepSeek 官方产品。它仅下载并运行官方 @deepseek-ai/dsh npm 包；与 DeepSeek 无关联，也未获其认可。

🧠 工作原理

双击
├─ 已在运行？      → 直接打开浏览器（不重复启动）
├─ 已本地安装？    → 直接启动（最快，约 1 秒）
├─ 已全局安装？    → 使用全局 dsh
└─ 以上都没有？
├─ 没有 Node.js → winget 安装 Node.js LTS
└─ 首次将 dsh 安装到 %LOCALAPPDATA%\DeepSeek-Harness → 启动

❓ 常见问题

为什么首次启动很慢？
它会下载官方 dsh 包（约几十 MB）。之后的启动只需约 1 秒，且无需联网。

端口 3080 已被占用——怎么办？
关闭占用端口 3080 的程序，或运行 start-dsh.bat check 进行检查。

如何彻底卸载？
删除脚本，然后删除 %LOCALAPPDATA%\DeepSeek-Harness（按 Win+R 并粘贴该路径）。

我的数据/配置存储在哪里？
由官方 dsh 程序自身管理；脚本不会读取或上传它们。

更新失败且应用无法再启动——怎么办？
再次启动即可：脚本会检测到损坏的安装并自动重建。日志保存在 %LOCALAPPDATA%\DeepSeek-Harness\logs。运行 start-dsh.bat check 可检查 Node.js/npm 版本以及 npm 代理设置。

我需要哪个 Node.js 版本？
Node.js 22.19.0 或更高版本——某些 dsh 依赖项需要它。脚本会在每次启动时检查，如果你的版本过旧会发出警告。

在中国安装缓慢或卡住——我能做什么？
脚本会自动将 npm 切换到中国镜像（registry.npmmirror.com），如果失败则回退到官方注册表。要强制使用官方注册表，请以 DSH_OFFICIAL_REGISTRY=1 运行。

我应该移除 npm 的代理设置吗？
如果你的 .npmrc 将 npm 走本地代理（例如 proxy=http://127.0.0.1:7890），那么只要该代理没有运行，每次更新都会失败。由于脚本已经使用了国内镜像，直连更快也更可靠——可以考虑移除它：
npm config delete proxy
npm config delete https-proxy
如果你确实需要代理，那就保持它一直运行——start-dsh.bat check 会显示当前代理设置并提醒你。

📄 许可证

MIT © 2026 Jett-Wu

🚀 DeepSeek Harness 一键启动器

即下即用 · 只装官方包 · 零配置 · 无第三方代码

双击 start-dsh.bat，自动装好一切并打开 DeepSeek Harness 网页版。
不依赖任何第三方二次开发的桌面端 —— 直接使用官方 npm 包，安全、稳定、随官方更新。

✨ 特性

- 🪄 零门槛：没有 Node.js？自动用 winget 安装；首次运行自动装官方包，之后双击秒开
- ⚡ 快：首次安装后启动约 1 秒；重复双击不会启动第二个实例，直接打开浏览器
- 🔄 自动更新：每天后台检查一次更新（完全不拖慢启动），发现新版自动升级
- 🛡️ 纯净安全：只从官方 npm registry 安装 @deepseek-ai/dsh，无任何第三方二进制、无数据收集
- 🌍 通用：脚本为纯 ASCII，任何语言版本的 Windows 10/11 都能直接运行
- 🚄 国内加速：默认把 npm 切到 npmmirror 国内镜像，国内安装飞快；失败自动回退官方源
- 🛠️ 自动修复：更新失败或 Node.js 升级后，下次启动会自动重建本地安装

🚀 快速开始

1. 下载 start-dsh.bat
2. 双击运行
3. 首次运行会自动安装（需要联网，约 1~3 分钟），完成后自动打开 http://127.0.0.1:3080

就这么简单，之后的每次启动都是一键。

提示：把 start-dsh.bat 发送到桌面快捷方式或固定到任务栏，日常使用更顺手。

📖 使用方法

| 操作 | 方法 |
|---|---|
| 启动 | 双击 start-dsh.bat |
| 更新到最新版 | 命令行运行 start-dsh.bat update |
| 检查环境 | 命令行运行 start-dsh.bat check |

🧩 推荐插件

以下插件来自社区推荐（非官方维护，建议逐个安装试用，并留意各自仓库的 issues 了解已知问题）：

| 插件 | 简介 |
|---|---|
| @linxin666/dsh-web-all | Web UI 全家桶：任务板、Git 图、右侧面板（文件/终端/浏览器）、皮肤中心等一次装齐 |
| @liustack/modsearch | 给没有联网能力的模型补上网页搜索 / X 搜索 / 页面抓取，免注册免 key，多引擎自动切换 |
| dsh-ego-browser | 给 AI 内置一个浏览器：语义定位点击、填表单、截图 |
| @kingOfSoySauce/dsh-liang-skin | 滑动变阻器风格的界面皮肤 |
| dsh-approval-gate（GitHub 仓库） | 自动审批门控：预判风险操作，安全的自动批准、危险的转人工确认（fail-safe） |

🔒 安全说明

这个脚本的意义，就是让你用官方程序，而不是来历不明的二次封装：

- ✅ 唯一安装来源：npm 官方 registry 的 @deepseek-ai/dsh 包
- ✅ 不下载、不执行任何第三方可执行文件
- ✅ 全部逻辑就是一个 .bat 文件，可逐行审计
- ✅ 不收集任何数据，唯一联网行为是安装/更新官方包本身

⚠️ 免责声明

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

🧠 工作原理

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

❓ 常见问题

首次启动为什么比较久？
正在下载官方 dsh 包（约几十 MB）。之后的启动只需约 1 秒，且无需联网。

端口 3080 被占用怎么办？
关闭占用 3080 端口的程序，或先运行 start-dsh.bat check 查看状态。

怎么完全卸载？
删除脚本文件，再删除目录 %LOCALAPPDATA%\DeepSeek-Harness（按 Win+R 输入该路径回车即可找到）。

数据和配置存在哪里？
由官方 dsh 程序自行管理，脚本不参与、不读取、不上传。

更新失败后用不了了怎么办？
再启动一次即可：脚本会检测到安装损坏并自动重建。日志保存在 %LOCALAPPDATA%\DeepSeek-Harness\logs；运行 start-dsh.bat check 可以查看 Node.js / npm 版本和 npm 代理设置。

需要什么版本的 Node.js？
需要 Node.js 22.19.0 或更新（dsh 的部分依赖有此要求）。脚本每次启动都会检查，版本过低时会给出提示。

国内安装很慢或卡住怎么办？
脚本会自动把 npm 切到国内镜像 registry.npmmirror.com，失败时自动回退官方源。想强制使用官方源，可设置环境变量 DSH_OFFICIAL_REGISTRY=1 后运行。

npm 的代理配置要不要去掉？
如果你的 .npmrc 让 npm 走了本地代理（例如 proxy=http://127.0.0.1:7890），一旦代理没启动，每次更新都会失败。既然脚本已默认使用国内镜像，直连更快也更稳，建议去掉：
npm config delete proxy
npm config delete https-proxy
如果确实需要代理，保持它常开即可 —— start-dsh.bat check 会显示当前代理配置并给出提醒。

📄 许可证

MIT © 2026 Jett-Wu