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

1. 浏览器打开 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

命令行用法

命令	说明
deepseek	前台启动（默认）：窗口显示日志，关闭窗口或 Ctrl+C 即停止
deepseek -b / -d / --background / --bg / --daemon	后台启动：提交后立即返回，服务继续运行并在就绪后自动打开浏览器
deepseek --status	查看服务状态（RUNNING (ready) / RUNNING (starting) / NOT RUNNING）
deepseek --stop	停止服务（按端口 3080 定位进程，仅停止 DeepSeek Harness 相关进程），并提示重新启动命令
deepseek --logs [N]	显示后台日志末尾 N 行（默认 20），如 deepseek --logs 50
deepseek --version	显示启动器版本与本地 DeepSeek Harness 版本
deepseek --update	对比本地与 npm 上的最新版本，提示更新方法
deepseek --upgrade	一键升级：停止服务 → 清理 npx 缓存 → 重新后台启动（自动下载最新版）
deepseek --uninstall	从用户 PATH 移除 deepseek 命令（卸载注册）
deepseek --uninstall --full	完整卸载：移除 PATH + 桌面快捷方式 + 日志目录 + 安装目录（带确认）
deepseek --check	环境自检（脚本路径 / npx / 端口）
deepseek --help	查看帮助

其他启动方式

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

文件说明

文件	说明
deepseek.cmd	命令行入口：前台 / 后台 / 停止 / 状态 / 自检 / 帮助
start-deepseek-harness.bat	前台启动脚本（启动服务 + 自动打开浏览器）
start-background.cmd / .ps1	后台启动协调器：支持立即返回或等待就绪，日志写入 %USERPROFILE%\dsh-launch\dsh-background.log
stop-dsh.cmd / .ps1	停止服务（按端口 3080 定位进程）
open-when-ready.ps1	轮询 HTTP 服务，确认就绪后自动打开浏览器（900 秒超时保护）
background-run.cmd	后台模式的实际执行体：日志合并写入并带时间戳头
update-check.ps1	版本对比：本地 npx 缓存 vs npm 最新版
upgrade-dsh.ps1	一键升级：停止服务、清理 npx 缓存、重新后台启动
set-shortcut.ps1	创建或迁移桌面快捷方式，配置可见启动进度窗口
uninstall.ps1	卸载：移除 PATH 注册（-Full 时同时删除快捷方式 / 日志 / 安装目录）
install-command.cmd	把脚本目录加入用户 PATH，注册 deepseek 命令
VERSION	启动器版本号（deepseek --version 读取）
deepseek.ico	DeepSeek Harness 黑色鲸鱼图标（16~256px 多尺寸，桌面快捷方式使用）
deepseek.svg	图标矢量源文件（取自 DSH web 前端 favicon，可用它重新生成 .ico）

常见问题

• 输入 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