# 🐳 dsh-tray
**DeepSeek Harness — 一键托盘启动器（自包含 EXE）**
双击启动 DeepSeek Harness Web GUI 并最小化到系统托盘。托盘图标与 exe 文件图标均为 **DeepSeek 小鲸鱼**，图标已内嵌进 exe 资源——**单文件、自包含、免安装**。
[](https://raw.githubusercontent.com/helays/dsh-tray/main/LICENSE)
[](https://raw.githubusercontent.com/helays/dsh-tray/main/#前置条件)
[](https://raw.githubusercontent.com/helays/dsh-tray/main/#)
✨ 特点
- 单文件交付：
bin/DshTray.exe内嵌鲸鱼图标（托盘 + exe 文件图标），不依赖任何外部图标文件。 - 一键启动：双击
.bat（或直接双击 exe）即启动 Harness Web GUI 并进入系统托盘。 - 随启随停：托盘"退出"自动停止它自己启动的 Harness 实例（含子进程）。
- 自动打开浏览器：自启服务成功、页面就绪后自动打开默认浏览器（可用
--no-open关闭）。 - 不误伤现有会话：启动时若目标端口已有服务，则不重复自启，只挂托盘指向现有服务。
- 零依赖运行时：仅需 Node.js + 已安装的
@deepseek-ai/dsh；编译 exe 仅需 Windows 自带 .NET Framework。
📦 前置条件
- Node.js（
DshTray.exe通过它调用@deepseek-ai/dsh运行服务）。 @deepseek-ai/dsh已安装在该用户的 npx 缓存中（工具自动在其中查找lib/bin.js）。- 首次编译 exe 需要 Windows 自带的 .NET Framework 4.x；使用现成 exe 则仅需运行。
🚀 快速开始
cd dsh-tray
start-harness.bat :: 每次从源码重新构建(图标+exe)并启动托盘或直接运行已构建产物（无参即可）:
bin\DshTray.exe启动后：鲸鱼图标出现在系统托盘（任务栏右侧），并在页面就绪后自动打开默认浏览器，指向 http://127.0.0.1:3080。
🖱️ 托盘操作
| 操作 | 行为 |
|---|---|
| 单击 / 双击图标 | 打开浏览器（注：单击与双击左键都会触发打开） |
| 右键 → 打开浏览器 | 同上 |
| 右键 → 重启 Harness | 停止旧实例并强起新实例 |
| 右键 → 检测更新 | 对比本机已装与 npm 最新 @deepseek-ai/dsh 版本，发现有新版本时提示更新命令 |
| 右键 → 退出 | 停止它自己启动的实例（含子进程）并退出托盘 |
启动时会先探测目标端口：
- 端口空闲 → 自启一个 Harness 实例并接管，"退出"会连同子进程一并终止。
- 端口被占用 → 只挂托盘指向现有服务，"退出"不会误杀该外来实例。
- 若托盘仅是「接管」状态，"重启"会尝试自启新实例，可能争用端口——此时建议直接访问既有服务地址。
⚙️ 自定义参数
开箱即用（默认端口 3080、浏览器地址 http://127.0.0.1:3080）。可选参数：
DshTray.exe --help
--port <int> Web 服务端口，并用于探测是否已被占用 (默认 3080)
--bin <path> 显式指定 dsh 的 lib/bin.js(默认自动在 npx 缓存查找)
--icon <path> 覆盖托盘图标 .ico(默认用内嵌鲸鱼图标)
--url <url> 浏览器打开的地址(默认 http://127.0.0.1:3080)
--no-open 启动后不自动打开浏览器⚠️ 一致性提醒：
--port（服务端口/探测）与--url（浏览器地址）互不联动——建议成对修改，
例如DshTray.exe --port 8080 --url http://127.0.0.1:8080。
🏗️ 从源码构建
只需双击 start-harness.bat —— 它会自动从源码完成全部构建（渲染鲸鱼图标 → csc 编译 → 输出 bin/DshTray.exe），无需手动运行任何脚本。
等效的手工命令（等价于 bat 内部做的事）:
cd dsh-tray
start-harness.bat产物：bin/DshTray.exe（自包含，含鲸鱼图标资源 + exe 文件图标）。
start-harness.bat已将构建逻辑完全内联（通过 base64 内嵌一段 PowerShell，使用后自动清理临时文件），仓库不再依赖/包含任何.ps1构建脚本。
📁 目录结构
dsh-tray/
├─ bin/DshTray.exe # 交付物：自包含托盘宿主
├─ src/DshTray.cs # 托盘宿主 C# 源码
├─ assets/DeepSeekWhale.ico
├─ dsh-whale-path.txt # 从官方 favicon 提取的鲸鱼 SVG path
├─ start-harness.bat # 双击入口：一键从源码构建 + 启动
├─ docs/CHANGELOG.md
├─ LICENSE # MIT
└─ README.md🛠️ 技术栈
- C# / WinForms（
.NET Framework 4.x，Windows 自带 csc 编译） - PowerShell 脚本（图标渲染 + 一键构建）
- 图标：DeepSeek Harness 官方
favicon.svg中提取的小鲸鱼路径，经 WPF 渲染为多尺寸.ico
📄 许可证
MIT © 2026 dsh-tray contributors
本项目为独立工具，与
@deepseek-ai/dsh官方无关联；鲸鱼图标取自 Harness 官方 favicon。