---

✨ 特点

• 单文件交付：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。