dsh-launcher

中文 | English

Windows 下 DeepSeek Harness Web 的启动与管理工具： 在 cmd / PowerShell 中输入 deepseek 即可一键启动（前台 / 后台双模式）、自动打开浏览器、 查询状态、停止服务，支持一键注册 deepseek 命令。

功能特性

• 命令行启动：在 cmd / PowerShell 中输入 deepseek 即可启动
• 前台 / 后台双模式：前台显示运行日志（关窗即停）；deepseek -b 提交后台启动后立即返回
• 自动打开浏览器：服务就绪后自动打开 http://127.0.0.1:3080，无需手动输入地址
• 快捷方式启动反馈：显示启动进度，成功打开浏览器后自动关窗；失败时保留窗口与日志提示
• 状态查询与停止：deepseek --status 查看运行状态，deepseek --stop 一键停止并提示重启命令
• 跨系统通用：Win10 / Win11 均可使用

安装

前置条件：安装 DeepSeek Harness

dsh-launcher 是 DeepSeek Harness 的启动器， 需先安装 DSH 本体（安装命令参考官方仓库）：

1. 安装 Node.js LTS
2. 运行：

npx @deepseek-ai/dsh web

3. 浏览器打开 http://127.0.0.1:3080 看到界面即安装成功（Ctrl+C 退出）

说明：dsh-launcher 每次启动也会通过 npx --yes @deepseek-ai/dsh web 自动下载 / 复用 DSH； 提前执行上面的命令可以验证环境并预先缓存组件。

方式一：PowerShell 一行命令（推荐）

irm https://raw.githubusercontent.com/RYun601/dsh-launcher/main/install.ps1 | iex

自动完成：下载最新 Release → 解压到 %USERPROFILE%\dsh-launcher → 注册 deepseek 命令。

可选：先下载到本地再运行，可带参数，例如 .\install.ps1 -Shortcut 会在桌面创建「DeepSeek Harness」快捷方式。快捷方式显示启动进度，成功后自动关窗；重新运行安装器会自动迁移旧版快捷方式。

方式二：手动安装

1. 从 Releases 下载 dsh-launcher.zip 并解压
2. 双击运行 install-command.cmd（注册 deepseek 命令）
3. 新开终端，输入 deepseek

方式三：从源码运行

git clone https://github.com/RYun601/dsh-launcher.git
cd dsh-launcher

快速开始

完成上方「安装」（任选一种方式）并新开一个终端窗口（使新 PATH 生效）后：

1. 输入 deepseek -b 提交后台启动并立即返回（或输入 deepseek 前台启动）
2. 首次运行会自动通过 npx 下载 DeepSeek Harness（需联网，约 1-2 分钟）
3. 服务就绪后浏览器自动打开 http://127.0.0.1:3080
4. 首次使用需要在 DeepSeek Harness 界面登录 / 填入 API Key

命令行用法

其他启动方式

• 直接运行脚本：双击 start-deepseek-harness.bat（前台）或 start-background.cmd（后台进度窗；成功自动关闭、失败保留）

文件说明

常见问题

• 输入 deepseek 提示"不是内部或外部命令"：先运行 install-command.cmd，然后新开终端窗口
• 启动时卡在下载 / 报网络错误：换国内镜像后重试 npm config set registry https://registry.npmmirror.com
• 提示端口 3080 被占用（EADDRINUSE）：说明已有一个实例在运行，用 deepseek --status 确认，或先 deepseek --stop 再启动
• 关闭前台窗口后服务就停了：设计行为（进程寄宿在控制台窗口）；需要常驻请用 deepseek -b
• 想迁移已配置好的 DSH 设置（含 API Key）：复制 %USERPROFILE%\.dsh 整个文件夹到新电脑的 C:\Users\<用户名>\.dsh（含敏感凭据，请勿公开）

许可证

MIT