YiMlT/DeepSeek-Harness-Launcher

DeepSeek Harness 启动器

简体中文
/
English

一个美观、易用的 Windows 桌面启动器，用于一键启动/停止 DeepSeek Harness（浏览器界面，默认端口 3080），并提供系统托盘、主题切换、浏览器选择等增强功能。

PS：本项目仅为启动器，本体DeepSeek Harness仍需自行安装

✨ 功能特性

| 功能 | 说明 |
|---|---|
| 🟢 运行状态实时显示 | 每 2 秒自动检测端口 3080，绿色圆点 = 运行中，灰色 = 未运行 |
| ▶ 一键启动 / 停止 | 启动时隐藏窗口运行 dsh web，停止时连子进程一起结束（taskkill /T） |
| ⏳ 加载状态动画 | 启停过程中显示中心旋转的加载指示器，按钮自动禁用防重复点击 |
| 🌐 一键打开网页 | 打开 http://127.0.0.1:3080，未运行时按钮自动置灰 |
| 📌 系统托盘 | 左键单击/双击恢复窗口；右键菜单：打开 / 启动或停止（跟随状态）/ 关闭启动器（先停止 Harness 再退出） |
| 🎨 主题切换 | 跟随系统 / 深色 / 浅色 三档分段控制器，实时生效并持久化 |
| 🌍 浏览器选择 | 自动枚举系统已安装浏览器（注册表），可指定用哪个浏览器打开网页，默认使用系统默认浏览器 |
| 🚪 关闭行为 | 最小化到托盘（Harness 继续运行）/ 直接关闭（退出并停止 Harness），首次使用引导选择，可随时修改 |
| 🚀 开机自启动 | 勾选后写入注册表 Run 键，登录 Windows 自动启动 |
| 🪟 圆角设计 | 全元素统一 12px 圆角，无边框窗口可拖动（Win32 原生拖动，流畅跟手） |
| 🖱 按钮反馈 | 图标按钮无边框，悬停/焦点/按下均有颜色变化 |

📁 文件说明

├── DeepSeekHarnessLauncher.exe   ← 主程序（原生 WPF，双击即用）
├── DeepSeekHarnessLauncher-Setup.exe ← Inno Setup 安装包（中文向导）
├── LauncherNative.cs             ← 主程序 C# 源码
├── DeepSeekHarnessLauncher.iss   ← Inno Setup 安装脚本
├── app.ico                       ← 应用图标
├── settings.json                 ← 用户设置（自动生成）
├── error.log                     ← 错误日志（出现问题时生成）
└── README.md / README.en.md      ← 本文档（中/英）

说明：DeepSeekHarnessLauncher.ps1、Launcher.cs、Launcher.vbs 为早期版本的遗留文件，可删除，不影响使用。

🚀 使用方法

方式一：直接运行（推荐）
双击 DeepSeekHarnessLauncher.exe（或桌面快捷方式「DeepSeek Harness 启动器」）。

方式二：安装使用
双击 DeepSeekHarnessLauncher-Setup.exe，按中文向导安装到 Program Files，自动创建开始菜单与桌面快捷方式，并可通过「控制面板 → 程序」卸载。

首次使用
1. 窗口显示「未运行」+ 灰色圆点
2. 点击 ▶ 启动 Harness → 变为「运行中」+ 绿色圆点
3. 点击 🌐 打开网页 进入 DeepSeek Harness 界面
4. 首次点击关闭按钮 ✕ 时，会询问关闭行为（最小化到托盘 / 直接关闭），之后可在设置中修改

⚙️ 设置说明

点击窗口右上角 ⚙ 打开设置面板：

| 设置项 | 说明 |
|---|---|
| 主题 | 跟随系统（默认）/ 深色 / 浅色，切换立即生效并保存 |
| 打开网页使用 | 默认浏览器（显示当前系统默认浏览器名称）/ 指定已安装浏览器 |
| 关闭按钮行为 | 最小化到托盘（Harness 继续运行）/ 直接关闭（退出并停止 Harness） |
| 开机自启动 | 登录 Windows 时自动启动本启动器（注册表 Run 键） |

所有设置切换即保存，无需确认按钮；主题、关闭行为、浏览器、自启动均持久化到 settings.json。

📌 托盘使用

- 左键单击 / 双击：显示主窗口
- 右键菜单（自上而下）：
- 打开：显示主窗口
- 启动 Harness / 停止 Harness：跟随运行状态动态显示
- 关闭启动器：先停止 Harness，再退出启动器

❓ 常见问题

Q1：启动后提示「未运行」，但 Harness 实际在跑？
检查是否修改过 Harness 的监听端口。默认检测 3080，如已改端口请同步修改 Port 常量。

Q2：开机自启动勾选了，但任务管理器启动列表没有？
自启动使用当前用户注册表 Run 键（免管理员权限）。可在 任务管理器 → 启动 查看，或在注册表编辑器检查 HKCU\Software\Microsoft\Windows\CurrentVersion\Run 下的 DeepSeekHarnessLauncher 项。

Q3：出现异常/窗口打不开？
查看同目录 error.log，将内容反馈给开发者。

Q4：任务栏图标不对？
主程序为原生 WPF 应用，任务栏、快捷方式、托盘均使用 app.ico 图标。若快捷方式图标异常，右键 → 属性 → 更改图标，选择 DeepSeekHarnessLauncher.exe。

📄 许可证

MIT License — 基于 DeepSeek Harness 生态的社区工具。

版本 v3.0 · 最后更新：2026-08-14