deepseek — DeepSeek Harness 后台启动器

English · 中文

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

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

安装

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

💡 没装 Node.js？ 用【方式一：irm】或【方式二：一键脚本】，都会自动帮你装好。

方式一：irm 一行命令（最快）

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

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

方式二：一键脚本

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	后台启动服务 + 系统托盘 + 打开界面
deepseek stop	停止服务并退出托盘
deepseek open	在浏览器打开界面
deepseek status	查看运行状态（退出码 0=运行中）
deepseek restart	重启服务
deepseek logs [n]	查看服务日志末尾 n 行（默认 30）
deepseek autostart on/off	开启/关闭开机自启（Windows）
deepseek update	更新 harness 到最新版并重启
deepseek help	帮助

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

• 打开 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。