DSHTray — DeepSeek Harness 托盘助手

一个 Windows 托盘小工具,用来方便地管理 DeepSeek Harness: 启动 / 停止 / 更新 / 重启 / 一键安装,全程无需打开命令行。

运行后没有任何窗口,只在任务栏右下角显示一个图标,右键即可操作。

✨ 功能特性

• 一键启动 / 停止:菜单实时显示状态「已停止 / 启动中... / 运行中...」,通过 HTTP 探测判断网页真正就绪,就绪时弹通知横幅
• 两种运行方式自由切换:
  • 本地仓库模式(开发者):设置里选 harness 源码目录,内部执行「pnpm dsh web」
  • npx 模式(无需仓库):支持官方 / 阿里 / 腾讯 / 自定义镜像源,执行「npx --registry=[源] @deepseek-ai/dsh web」自动安装并运行,源会被记住
• 智能启动:点「启动」优先用本地仓库;未配置仓库时自动改用 npx
• 更新:一键「git pull」,失败(如冲突)弹窗显示原因
• 重启:「仅重启」/「编译并启动」(自动「pnpm build」)
• 日志查看:实时查看启动输出、npx 安装进度、构建日志(自动刷新)
• 帮助:内置安装教程与全部菜单说明
• 双击托盘图标 → 用默认浏览器打开「http://localhost:3080」
• 单文件、自包含 exe:目标机器无需安装 .NET,只需 PATH 里有「pnpm」(仓库模式)/「git」(更新)/「node」(npx 模式)

🚀 快速开始

1. 从 Releases 下载最新「DSHTray.exe」(Windows 10/11)
2. 双击运行,右键托盘图标
3. 两种方式任选其一:
   • 「更多 → 设置」选择本地 harness 仓库目录(留空则使用 npx 方式)
   • 「更多 → npx安装」选择镜像源(国内推荐阿里/腾讯),自动安装并运行
4. 菜单显示「运行中...」并弹出就绪通知后,浏览器访问「http://localhost:3080」

📋 右键菜单

菜单	说明
「启动」/「停止(...)」	括号内为实时状态;无仓库时自动改用 npx
「打开」	默认浏览器打开「http://localhost:3080」
「更多」→「设置」	harness 目录(可留空)、启动/构建命令、Web 端口
「更多」→「重启」	仅重启 / 编译并启动(编译需要本地仓库)
「更多」→「更新」	git pull(需要本地仓库)
「更多」→「npx安装」	选镜像源后自动安装并运行,源会被记住
「更多」→「日志」	查看启动/安装/构建输出,自动刷新
「更多」→「帮助」	安装教程与菜单说明
「退出」	等待进行中的操作完成后退出

⚙️ 配置与日志

• 配置:「~.DSHTray\settings.xml」(harness 目录、命令、端口、npx 镜像源)
• 日志:「~.DSHTray\logs\」(启动输出、npx 安装进度、构建日志)
• 崩溃记录:「~.DSHTray\error.log」

🔨 从源码构建

需要 .NET 10 SDK:

cd DSHTray
.\build.ps1                        # 自包含单文件 exe → publish\DSHTray.exe
.\build.ps1 -FrameworkDependent    # 依赖 .NET 10 桌面运行时的精简版

托盘图标由「tools\png-to-ico.ps1」从「Icon.png」生成「icon.ico」。

🗂️ 项目结构

文件	职责
DSHTray\TrayApplication.cs	托盘图标、菜单、操作编排与退出等待
DSHTray\HarnessController.cs	启动/停止/检测/git pull/build/npx、进程树清理
DSHTray\SettingsForm.cs	设置对话框(目录浏览、命令、端口)
DSHTray\NpxInstallForm.cs	一键安装镜像源选择
DSHTray\LogViewerForm.cs	日志查看(自动刷新)
DSHTray\HelpForm.cs	帮助说明
DSHTray\AppConfig.cs	配置读写(「~.DSHTray\settings.xml」)
DSHTray\tools\	图标生成脚本

详见 DSHTray\README.md。

📄 License

MIT