🚀 DeepSeek Harness Web UI 一键启动器 / One-Click Launcher
August 13, 2026 · View on GitHub
中文：把 DeepSeek Harness 的 Web UI 变成"双击即用"的桌面体验 —— 启动服务、自动打开浏览器（Harness 界面 + Token 用量页）、控制台自动最小化，一条龙搞定。
English: Turn the DeepSeek Harness Web UI into a "double-click to use" desktop experience — start the server, auto-open the browser (Harness UI + token usage page), and auto-minimize the console, all in one go.
Works with any DeepSeek Harness installation (source checkout / npm global / npx). 适用于任何 DeepSeek Harness 安装方式。
中文
✨ 特性
- 一键启动：双击桌面快捷方式即可，无需记忆命令
- 自动开浏览器：先打开 Token 用量页（
https://platform.deepseek.com/usage），再打开 Harness 界面并置为前台 - 快速启动：有源码仓库时走预编译 CLI（约 2 秒），比
pnpm dsh web（30+ 秒）快得多 - 幂等：服务已在运行时只开浏览器，不重复启动
- 控制台自动最小化：启动成功后最小化到任务栏，点任务栏按钮随时调出；关闭窗口 = 停止服务
- 一键卸载：不留残余
🚀 快速开始
- 解压本包到任意目录
- 双击
install.cmd
高级用法：
install.cmd C:\Users\你的用户名\deepseek-harness rem 指定 dsh 源码仓库路径（推荐，启用快速启动）
install.cmd "" D:\temp\test-dir rem 指定安装目录（测试用）
安装程序会：
- 把启动脚本安装到
%DSH_HOME%（未设置则用%USERPROFILE%\.dsh） - 在桌面创建 DeepSeek Harness Web 快捷方式
🔧 两种运行模式
| 模式 | 触发条件 | 服务器命令 | 启动速度 |
|---|---|---|---|
| checkout 模式（推荐） | 安装时指定了源码仓库路径 | node apps\cli\lib\bin.js web（预编译 CLI），缺失时退回 pnpm dsh web | ~2 秒 |
| CLI 模式 | 未指定仓库路径，且 dsh 在 PATH 上 | dsh web | 取决于安装方式 |
不知道仓库路径？直接双击
install.cmd即可，安装程序会自动检测%USERPROFILE%\deepseek-harness。
📖 使用说明
- 启动：双击桌面 "DeepSeek Harness Web" 快捷方式
- 看日志 / 停止：点任务栏的 "DeepSeek Harness Web" 按钮恢复控制台；关闭窗口 = 停止服务
- 自定义页面：编辑
%INSTALL_DIR%\start-dsh-web.cmd顶部的GUI_URL/USAGE_URL - 重复双击：服务已运行时不重复启动，只重新打开浏览器
🗑️ 卸载
双击 uninstall.cmd —— 删除桌面快捷方式和本包安装的文件（不会动你的会话数据）。
❓ 常见问题
为什么启动这么快？
pnpm dsh web 每次用 tsx 即时编译 TypeScript 源码（30+ 秒）；本启动器优先用仓库里已编译好的 lib/bin.js（约 2 秒），两者功能完全等价 —— lib/bin.js 正是 npm 安装包运行的同一入口。
会被杀毒软件误报吗？
不会。快捷方式目标是 cmd.exe（而非 powershell.exe），窗口正常显示、无隐藏标志、无可疑组合；批处理只用系统自带的 curl / start / node 和一行窗口最小化 PowerShell。
改了源码后启动器还用旧代码吗？
checkout 模式下优先用 lib/bin.js（源码变动后需在仓库根目录跑一次 pnpm run build 刷新）；删除 lib 或改用 pnpm dsh web 可切回源码路径。
Usage 页面没数据？ 需要先在浏览器登录 DeepSeek 平台账号。
📦 文件清单
| 文件 | 作用 |
|---|---|
install.cmd | 一键安装（生成启动脚本 + 桌面快捷方式） |
uninstall.cmd | 一键卸载 |
start-dsh-web.tpl.cmd | 启动器模板（安装时生成 start-dsh-web.cmd） |
open-when-ready.tpl.cmd | 就绪看门狗模板（开浏览器 + 最小化控制台） |
minimize-console.ps1 | 控制台最小化辅助脚本 |
dsh-web.ico | 快捷方式图标（DeepSeek 蓝） |
README.md | 本文档 |
English
✨ Features
- One-click launch: double-click a desktop shortcut — no commands to remember
- Auto-open browser: opens the token usage page (
https://platform.deepseek.com/usage) first, then brings the Harness UI to the foreground - Fast startup: uses the prebuilt CLI (~2s) when a source checkout is available — much faster than
pnpm dsh web(30+ seconds) - Idempotent: if the server is already running, it only opens the browser — no duplicate server
- Auto-minimize console: minimized to the taskbar once ready; click the taskbar button to bring it back; closing the window stops the server
- One-click uninstall: leaves no residue
🚀 Quick Start
- Extract this package anywhere
- Double-click
install.cmd
Advanced usage:
install.cmd C:\Users\you\deepseek-harness rem specify the dsh source checkout path (recommended, enables fast boot)
install.cmd "" D:\temp\test-dir rem specify an install directory (for testing)
The installer will:
- Install the launcher scripts into
%DSH_HOME%(or%USERPROFILE%\.dshif unset) - Create a DeepSeek Harness Web shortcut on the desktop
🔧 Two Run Modes
| Mode | Trigger | Server command | Boot time |
|---|---|---|---|
| checkout mode (recommended) | checkout path given at install | node apps\cli\lib\bin.js web (prebuilt CLI), falls back to pnpm dsh web | ~2s |
| CLI mode | no checkout path, dsh on PATH | dsh web | depends on install |
Don't know your checkout path? Just double-click
install.cmd— it auto-detects%USERPROFILE%\deepseek-harness.
📖 Usage
- Start: double-click the "DeepSeek Harness Web" desktop shortcut
- See logs / stop: click the "DeepSeek Harness Web" taskbar button to restore the console; closing the window stops the server
- Customize pages: edit
GUI_URL/USAGE_URLat the top of%INSTALL_DIR%\start-dsh-web.cmd - Double-click again: if the server is running, it only re-opens the browser
🗑️ Uninstall
Double-click uninstall.cmd — removes the desktop shortcut and the launcher files (your session data is untouched).
❓ FAQ
Why is startup so fast?
pnpm dsh web transpiles TypeScript sources on every boot via tsx (30+ seconds). This launcher prefers the prebuilt lib/bin.js (~2s) — functionally identical, since lib/bin.js is the same entry the npm package runs.
Will antivirus flag it?
No. The shortcut targets cmd.exe (not powershell.exe), the window is normal, no hidden flags, no suspicious patterns; the batch files only use built-in curl / start / node and a one-line PowerShell window minimizer.
Stale code after editing sources?
In checkout mode the prebuilt lib/bin.js is preferred (run pnpm run build in the repo root to refresh it). Delete lib or use pnpm dsh web to go back to source mode.
Usage page shows nothing? Log in to the DeepSeek platform in your browser first.
📦 Files
| File | Purpose |
|---|---|
install.cmd | One-click installer (generates launcher + desktop shortcut) |
uninstall.cmd | One-click uninstaller |
start-dsh-web.tpl.cmd | Launcher template (generates start-dsh-web.cmd) |
open-when-ready.tpl.cmd | Readiness watcher template (opens browser + minimizes console) |
minimize-console.ps1 | Console minimizer helper |
dsh-web.ico | Shortcut icon (DeepSeek blue) |
README.md | This document |
License
MIT — free to use, modify, and redistribute.