GHYHC/dsh-starter

dsh-starter 🚀

DeepSeek Harness 轻量级 Windows 启动器 —— 双击即用，一键启动服务 + 打开应用窗口/浏览器。

dsh-starter 为 DeepSeek Harness 提供一个极简的 Windows 桌面启动器：双击快捷方式，自动完成「启动服务（含自动更新）→ 打开独立应用窗口（或浏览器兜底）」，无需命令行操作。

✨ 特性

- 一键启动：桌面快捷方式双击即用，自动检测/启动 dsh 服务
- 自动更新：基于官方 npx @deepseek-ai/dsh，每次启动自动获取最新版
- 国内镜像加速：默认使用 npmmirror.com 镜像源，下载提速（海外用户可关闭）
- 智能等待：等服务真正就绪才打开页面，下载慢也不会"提前打开"
- 独立应用窗口：装了 PWA 就用黑色鲸鱼独立窗口（无标签栏、不与主浏览器混在一起）；没装则浏览器兜底
- 防重复开窗：窗口已开时只聚焦，不重复
- 单文件安装器：一个 .cmd 自包含（内嵌全部脚本和图标），分享/分发极其方便

📦 快速开始

环境要求
- Node.js（LTS 版，需 ≥ 18）：DeepSeek Harness 是 Node 程序。没装时启动器会自动打开 Node 官网下载页
- Edge 或 Chrome（可选，用于打开界面/应用窗口）

安装
1. 下载 Install-DeepSeek-Harness.cmd
2. 双击运行 → 自动生成启动文件到 文档\DeepSeek Harness\ 并创建桌面快捷方式
3. 双击桌面「DeepSeek Harness」快捷方式即可使用

想用独立应用窗口（可选）
在 Edge 打开 http://127.0.0.1:3080 → 地址栏安装图标 → 装成应用。之后启动器会自动用独立窗口（黑色鲸鱼图标）打开；不装也能用（浏览器打开）。

🔧 工作原理

桌面快捷方式
└─ Start-DeepSeek-Harness.cmd   (入口)
├─ 检测 3080 端口服务是否在跑 → 没跑就 npx 启动（自动更新）
├─ 等服务就绪（最多10分钟，就绪才继续）
└─ Open-PwaApp.ps1          (打开界面)
├─ 已有应用窗口 → 聚焦
├─ 已装 PWA → 启动独立窗口
└─ 没装 → 默认浏览器打开

⚙️ 配置

启动器 Start-DeepSeek-Harness.cmd 顶部可调：
set "NPX_REGISTRY=https://registry.npmmirror.com"   rem 国内镜像源; 海外用户清空此行用官方源
set "PORT=3080"                                      rem 服务端口

启动器以 dsh web --no-open 启动服务：关闭 dsh 自带的"启动后自动打开默认浏览器"行为，界面统一由启动器打开（已装 PWA 用独立应用窗口，未装则浏览器兜底），避免同时弹出浏览器和 PWA 两个窗口。

❓ 常见问题

- 没装 Node 能启动吗？ 不能启动服务（服务是 Node 程序），但启动器会引导安装 Node。
- 下载很久？ 首次安装或更新会下载，已默认走国内镜像加速；且启动器会等服务就绪才打开页面。
- 怎么卸载？ 删除桌面快捷方式和 文档\DeepSeek Harness\ 目录即可（不碰你的数据）。

📄 License

MIT

本项目为社区工具，与 DeepSeek AI 官方无关联。