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

🇬🇧 English · 🇨🇳 中文

🚀 DeepSeek Harness Launcher

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

双击 start-dsh.bat，它会自动装好一切，然后打开 DeepSeek Harness 的 Web UI。
没有第三方桌面套壳——它直接安装并运行官方 npm 包：安全、稳定、始终最新。

✨ 特性

- 🪄 零门槛：缺少 Node.js 时用 winget 自动安装，再装官方包；之后每次启动只要约 1 秒
- 🔄 更新从不偷偷来：菜单里会显示你的版本和 npm 上的最新版，绝不背着你安装；更新失败或 Node.js 升级后会自动重建
- 🚄 国内友好：默认走 npmmirror 源，失败自动回退到官方源
- 💾 可选备份：只要存在 dsh-backup 辅助程序，菜单第 3 项就能备份会话和插件
- 🛡️ 安全通用：只从官方源安装 @deepseek-ai/dsh，没有第三方二进制，不收集数据；纯 ASCII 脚本，任何 Windows 10/11 版本都能跑

🚀 快速开始

1. 下载 start-dsh.bat
2. 双击运行，按 1——不用按回车
3. 首次运行会自动装好一切（需要联网，约 1-3 分钟），然后打开 http://127.0.0.1:13080

📖 用法

双击 start-dsh.bat 会弹出菜单——按数字键即可，不用按回车。

第一次用备份时，它会问你把备份存到哪里，并记住你的选择。

| 菜单 | 操作 | 命令行 |
| 1 | 启动 DSH（默认） | start-dsh.bat start |
| 2 | 更新 dsh 和它的插件 | start-dsh.bat update |
| 3 | 备份会话和插件 | start-dsh.bat backup |
| 4 | 诊断，可选修复 | start-dsh.bat diagnose |
| 5 | 卸载 | start-dsh.bat uninstall |

🧩 推荐插件

社区推荐的插件（非官方维护——一次只装一个，依赖之前先看看各仓库的 issues）：

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

🔒 安全

这个脚本存在的意义，就是让你运行官方程序，而不是来路不明的重打包版本：

- ✅ 唯一来源：官方 npm registry 上的 @deepseek-ai/dsh，没有第三方二进制文件
- ✅ 只有一个 .bat 文件，你可以逐行审计，没有混淆
- ✅ 不收集数据；唯一的网络活动就是安装或更新那个包

⚠️ 免责声明

这是社区工具，不是 DeepSeek 官方产品。它只负责下载并运行官方 @deepseek-ai/dsh npm 包；与 DeepSeek 没有隶属关系，也未获其背书。

🧠 工作原理

double-click
├─ already running? → just open the browser (no duplicate)
├─ locally installed? → start directly (fastest, ~1 s)
├─ globally installed? → use the global dsh
└─ none of the above?
├─ no Node.js → winget installs Node.js LTS
└─ first-time install of dsh into %LOCALAPPDATA%\DeepSeek-Harness → start

❓ 常见问题

为什么第一次启动很慢？
它会下载官方 dsh 包（大约几十 MB）。之后启动只要约 1 秒，而且不需要联网。

端口 13080 已被占用，怎么办？
关掉占用该端口的程序，或者改 start-dsh.bat 顶部的 PORT。

卸载到底会删掉什么？
只删本地安装目录（%LOCALAPPDATA%\DeepSeek-Harness）。你在 %USERPROFILE%\.dsh 里的聊天、会话和设置绝不会被动，而且菜单会先让你确认。

我的数据 / 配置存在哪里？
由官方 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），失败时回退到官方 registry。想强制用官方 registry，就带上 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 会显示当前代理设置并提醒你。

📄 License

MIT © 2026 Jett-Wu

🚀 DeepSeek Harness 一键启动器

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

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

✨ 特性

- 🪄 零门槛：缺 Node.js 时自动用 winget 安装，并装好官方包；之后启动约 1 秒
- 🔄 更新只提醒、绝不擅自安装：菜单里并列显示你的版本与官方最新版；更新失败或 Node.js 升级后会自动重建
- 🚄 国内友好：默认使用 npmmirror 国内镜像，失败自动回退官方源
- 💾 可选备份：脚本旁有 dsh-backup 工具时，菜单选项 3 可备份聊天记录与插件
- 🛡️ 安全通用：只从官方源安装 @deepseek-ai/dsh，无第三方二进制、无数据收集；纯 ASCII 脚本，任何 Windows 10/11 语言版本可用

🚀 快速开始

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

📖 使用方法

双击 start-dsh.bat 会出现菜单，按数字键即可（无需回车）。

第一次使用 Backup 时会询问备份文件夹，并记住你的选择。

| 菜单 | 操作 | 命令行 |
| 1 | 启动 DSH（默认） | start-dsh.bat start |
| 2 | 更新 dsh 与已装插件 | start-dsh.bat update |
| 3 | 备份聊天记录与插件 | start-dsh.bat backup |
| 4 | 环境诊断（可顺带修复） | start-dsh.bat diagnose |
| 5 | 卸载 | start-dsh.bat uninstall |

🧩 推荐插件

以下插件来自社区推荐（非官方维护，建议逐个安装试用，并留意各自仓库的 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 秒，且无需联网。

端口 13080 被占用怎么办？
关闭占用该端口的程序，或改 start-dsh.bat 顶部的 PORT。

卸载到底会删掉什么？
只删除本地安装目录 %LOCALAPPDATA%\DeepSeek-Harness。你的聊天记录、会话与设置都在 %USERPROFILE%\.dsh，完全不会被碰；删除前还会先让你确认。

数据和配置存在哪里？
由官方 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 会显示当前代理配置并给出提醒。

📄 License

MIT © 2026 Jett-Wu