DeepSeek Harness 启动器开源：一键安装、后台运行、托盘管理、开机自启和自动更新

最近我在使用 DeepSeek Harness 的时候，发现官方命令本身已经够用：

npx @deepseek-ai/dsh web

但如果每天都要用，它更像一个临时开发服务，而不是一个可以长期常驻的本地工具。

我实际遇到的问题主要有几个：

• 每次启动都要手动输入命令
• 终端窗口关掉后，服务可能跟着退出
• 想停止或重启服务时，需要自己找进程
• Windows 下没有系统托盘，不方便看运行状态
• 想开机自启，需要自己写脚本或注册表
• Harness 更新也要自己手动处理

于是我写了一个小工具：deepseek-launcher。

项目地址：

https://github.com/wyf-777/deepseek-launcher

一句话介绍：它把 DeepSeek Harness 封装成一个更顺手的本地启动器，让你用一条 deepseek 命令完成启动、后台运行、托盘管理、日志查看、开机自启和更新。

功能亮点

deepseek-launcher 目前主要做了这些事：

• 一键傻瓜式安装：通过 npm 全局安装，安装后直接得到 deepseek 命令
• 一键启动：执行 deepseek 后自动后台启动 Harness，并打开浏览器
• 后台隐藏运行：Windows 下不会一直占着一个命令行窗口
• 系统托盘管理：可以从托盘打开页面、查看日志、退出服务
• 开机自启动：支持注册为 Windows 当前用户开机启动项
• 自动更新 Harness：一条命令拉取新版 DeepSeek Harness 并重启
• 日志查看：可以直接查看最近运行日志，方便排查问题
• 状态检测：支持检查当前服务是否在运行

它不是要替代 DeepSeek Harness，而是给 Harness 补一层更接近桌面软件的启动和管理体验。

一键安装

前置要求：Node.js >= 18。

使用 npm 全局安装：

npm install -g deepseek-launcher

安装完成后，直接运行：

deepseek

默认情况下，它会：

• 在后台启动 DeepSeek Harness
• 自动打开浏览器
• 访问默认地址 http://127.0.0.1:3080
• 在 Windows 下启动系统托盘

也就是说，日常使用时不用再每次手动输入：

npx @deepseek-ai/dsh web

常用命令

命令	说明
deepseek	启动服务、启动托盘并打开 Web 界面
deepseek start	后台启动服务
deepseek stop	停止服务并退出托盘
deepseek restart	重启服务
deepseek open	在浏览器打开 DeepSeek Harness
deepseek status	查看服务运行状态
deepseek logs [n]	查看最近 n 行日志，默认 30 行
deepseek autostart on	开启 Windows 开机自启
deepseek autostart off	关闭 Windows 开机自启
deepseek update	更新 DeepSeek Harness 并重启

日常最常用的其实就三个：

deepseek
deepseek status
deepseek stop

需要更新 Harness 时：

deepseek update

开机自启动

如果你希望电脑开机后 DeepSeek Harness 自动在后台运行，可以执行：

deepseek autostart on

关闭开机自启：

deepseek autostart off

Windows 下的实现方式是写入当前用户的注册表 Run 键。开机启动时会静默拉起服务和托盘，但不会自动打开浏览器，这样不会每次开机都弹出页面。

这个设计比较适合把 DeepSeek Harness 当成常驻本地服务使用。

自动更新 Harness

如果你想更新 DeepSeek Harness，可以直接执行：

deepseek update

它会处理 Harness 更新，并在需要时重启服务。这样就不用每次自己手动去记 npx 或包更新命令。

对普通用户来说，这个命令更接近“一键更新”。

Windows 系统托盘

在 Windows 下，deepseek-launcher 会启动一个系统托盘图标。

托盘图标状态：

• 蓝色：服务运行中
• 灰色：服务已停止

右键菜单提供常用操作：

• 打开 DeepSeek Harness
• 查看日志
• 退出

这里的“退出”会停止后台服务并关闭托盘，不只是隐藏图标。

后台隐藏运行

Windows 下如果直接用 Node.js 子进程启动服务，体验并不总是稳定，尤其是终端窗口生命周期和后台隐藏运行的问题。

所以这个项目里专门用 PowerShell 做隐藏启动：

Start-Process -WindowStyle Hidden

服务启动后会写入 PID 文件，后续 stop、status、restart 等命令都可以根据 PID 和端口状态判断服务是否还在。

日志会追加写入：

%USERPROFILE%\.dsh\server.log

查看日志：

deepseek logs
deepseek logs 100

端口和配置

默认端口是：

3080

如果需要修改，可以使用环境变量：

$env:DSH_PORT=3080

模型、Key、provider 等配置仍然交给 DeepSeek Harness 自己管理，通常在：

~/.dsh

deepseek-launcher 只负责更舒服地启动和管理 Harness，不接管模型配置本身。

技术栈

项目整体比较轻：

• Node.js：实现 CLI、命令分发、端口检测、进程管理
• PowerShell：实现 Windows 隐藏启动、开机自启、托盘脚本
• WinForms NotifyIcon：实现 Windows 系统托盘图标和右键菜单
• npm bin：全局安装后暴露 deepseek 命令

代码不复杂，主要目标是把一个开发命令包装成更顺手的本地工具。

适合谁用

如果你：

• 正在使用 DeepSeek Harness
• 希望它可以后台常驻运行
• 不想每次都手动输入 npx @deepseek-ai/dsh web
• 想要 Windows 系统托盘和开机自启
• 希望一条命令更新 Harness

可以试试这个项目。

开源地址

GitHub：

https://github.com/wyf-777/deepseek-launcher

欢迎 star、issue，也欢迎反馈不同 Windows 环境下的兼容性问题。

后续我会继续补充安装脚本、文档和跨平台体验。