NaNExist/dsh-win-launchscript

DSH Windows 一键启动脚本

用于在 Windows 上一键启动 DeepSeek Harness（DSH） 的两个便携脚本。

本项目不负责安装 DSH。把两个脚本复制到已经通过 npm 安装了 @deepseek-ai/dsh 的目录（与 node_modules 同级），然后双击批处理文件即可。

文件说明

- StartDSH.bat：双击入口。优先使用 PowerShell 7（pwsh），未安装时使用 Windows PowerShell。
- start-dsh.ps1：启动 DSH Web 服务、打开浏览器并负责退出时清理服务。

使用方法

1. 准备 DSH 目录

请先安装 Node.js 和 npm，然后在准备存放 DSH 的目录中安装依赖：

npm install @deepseek-ai/dsh

安装完成后，目录中应存在：

你的 DSH 目录/
├─ node_modules/
│  └─ @deepseek-ai/
│     └─ dsh/
├─ StartDSH.bat
└─ start-dsh.ps1

2. 启动

双击 StartDSH.bat。

脚本会：

1. 在本机 127.0.0.1:3080 启动 DSH Web 服务；
2. 优先用 Chrome，其次用 Edge 打开独立浏览器窗口；
3. 将 DSH 的本地数据放在脚本目录下的 data 文件夹；
4. 在该浏览器窗口关闭后，停止本次脚本启动的服务。

如果 3080 端口上已经运行 DSH，脚本只会打开页面，不会接管或关闭已有服务。如果端口被其他程序占用，脚本会提示错误并退出。

常见问题

提示找不到 DSH

确认脚本与 node_modules 位于同一目录，并检查以下文件是否存在：

node_modules\@deepseek-ai\dsh\lib\bin.js

若不存在，请在该目录重新执行：

npm install @deepseek-ai/dsh

3080 端口被占用

关闭占用 3080 端口的程序后重试。脚本不会强行终止无法确认为 DSH 的进程。

浏览器关闭后服务没有停止

脚本依赖 Windows 进程信息来识别独立浏览器窗口。在权限受限的环境中，可能需要回到启动窗口并按提示结束服务。

数据与安全

- DSH 数据保存在本地 data/，不要将其中的账号、会话或配置提交到 Git。
- 不要把 .env、API Key、访问令牌或其他凭据加入仓库。
- 本项目的 .gitignore 已排除 node_modules/、data/、常见环境变量文件和日志。
- 脚本通过 -ExecutionPolicy Bypass 仅对本次 PowerShell 进程放宽执行策略，不会修改系统的永久策略。

适用环境

- Windows 10/11
- Node.js 与 npm
- PowerShell 7 或 Windows PowerShell 5.1
- Chrome、Edge，或系统默认浏览器

说明

本项目只是社区启动脚本，不隶属于 DeepSeek。DSH 本身的安装、配置请以其上游项目说明为准。