deepseek — DeepSeek Harness 后台启动器

项目官网 · English · 中文

一条命令启动 DeepSeek Harness 的 Web 界面：

• 服务在后台运行，关闭启动它的终端也不会中断；
• Windows 下常驻系统托盘（鲸鱼图标），右键可「打开界面 / 退出」。

安装

Windows（推荐：下载安装包）

下载最新版 Windows 一键安装包

下载 deepseek-launcher-windows-setup.exe 后双击安装即可。安装器会：

• 检查 Node.js 18 或更高版本，缺失时通过 winget 自动安装当前 LTS 版；
• 把 DeepSeek Launcher 安装到当前用户目录并加入 PATH；
• 创建开始菜单入口和标准卸载程序。

安装完成后，请重开一个终端并运行 deepseek。Windows 可能会对尚未签名的新程序显示 SmartScreen 提示；请核对发布者仓库和 SHA-256 校验文件后再运行。

GitHub Release 页面会显示安装包文件的累计下载次数。该数字代表下载量，并不等于安装成功数或独立用户数。

其他安装方式

前置：Node.js >= 18。手动安装方式需要先装好。

💡 没装 Node.js？ Windows 安装包、irm 或一键脚本都会尝试自动安装。

方式一：irm 一行命令

irm https://raw.githubusercontent.com/wyf-777/deepseek-launcher/master/install-remote.ps1 | iex

从 GitHub 直接下载并装好（自动装 Node.js、复制运行文件、加 PATH），然后重开终端即可。请确认来源可信。

方式二：PowerShell 一键脚本

powershell -ExecutionPolicy Bypass -File .\install.ps1

脚本会自动检测并安装 Node.js（没有的话用 winget 装），再把运行文件复制到 %USERPROFILE%\bin 并加入用户 PATH，然后重开终端即可。

方式三：手动安装

把本目录里的 deepseek.js、deepseek.cmd、tray.ps1、start-server.ps1、start-tray.ps1、autostart.ps1、deepseek.ico、deepseek-off.ico 放到一个已在 PATH 中的目录 （Windows 建议 %USERPROFILE%\bin，并把该目录加入用户 PATH），然后重开终端即可。

[Environment]::SetEnvironmentVariable('Path', "$env:USERPROFILE\bin;" + [Environment]::GetEnvironmentVariable('Path','User'), 'User')

用法

托盘图标蓝色=运行、灰色=停止，双击可直接打开界面；右键菜单：

• 打开 DeepSeek Harness — 浏览器打开界面
• 查看日志 — 用记事本打开一份去颜色码、带运行状态说明的服务日志
• 开机自启动 — 勾选即开启开机自启（写入注册表 Run 键），取消勾选即关闭
• 退出 — 停止服务（后台进程被杀、界面关闭）+ 图标消失

说明

• 服务通过 Windows Start-Process -WindowStyle Hidden 在隐藏窗口中后台运行，关闭终端不影响它，也没有可见的终端框；macOS / Linux 用 detached 方式。
• 系统托盘目前仅 Windows（PowerShell + WinForms 实现，无需额外依赖）；macOS / Linux 上 deepseek 仍可后台启动并打开浏览器，只是没有托盘图标。
• 端口默认 3080，可用环境变量 DSH_PORT 覆盖（需与 harness 实际端口一致）；托盘「打开界面」会读取同一端口。
• 服务输出追加写入 %USERPROFILE%\.dsh\server.log，用 deepseek logs [行数] 查看末尾（默认 30 行）。
• 开机自启：deepseek autostart on 写入注册表 Run 键（静默启动服务 + 托盘，不打开浏览器），off 关闭，无参数查看状态；也可直接在托盘右键菜单勾选「开机自启动」。仅 Windows。
• 更新 harness：deepseek update 停止服务后用 npx @deepseek-ai/dsh@latest 拉最新版并重启（会短暂中断服务）。
• 托盘图标使用 deepseek.ico（蓝鲸=运行中）/ deepseek-off.ico（灰鲸=已停止），缺失时自动回退到系统默认图标。

配置 harness 模型

deepseek 只是启动器，模型/配额在 harness 自己的配置里（~/.dsh）。参考本目录的 harness-settings.example.yaml 和 HANDOVER.md。