DSHTray — DeepSeek Harness 托盘助手

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

Windows(任务栏右下角托盘)与 macOS(屏幕右上角菜单栏)双平台支持, 同一份 Avalonia 代码构建。运行后没有任何窗口,只在系统托盘/菜单栏显示一个图标,点开即可操作。

✨ 功能特性

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

🚀 快速开始

Windows(10/11)

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

macOS(12+)

1. 下载「DSHTray.app」,拖入「应用程序」文件夹
2. 双击运行(首次打开若被拦截:右键/Control+点击 → 「打开」)
3. 点屏幕右上角菜单栏的图标(注意:不在 Dock):
   • 「更多 → 设置」选择本地 harness 仓库目录(留空则使用 npx 方式)
   • 「更多 → npx安装」选择镜像源,自动安装并运行
4. 菜单显示「运行中...」并弹出就绪通知后,浏览器访问「http://localhost:3080」

macOS 提示:本程序会通过 login shell(bash/zsh)自动解析 PATH,支持 nvm / Homebrew 安装的 node、pnpm、git;如果提示找不到工具,先执行 brew install node git。

📋 菜单

⚙️ 配置与日志

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

🔨 从源码构建

需要 .NET 10 SDK。

Windows

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

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

也可以在 macOS/Linux 上交叉发布 Windows 版(无需 Windows 机器):

cd DSHTray
./build-win.sh                    # win-x64 单文件 exe(含图标)
./build-win.sh win-arm64          # ARM 版
./build-win.sh win-x64 fd         # 框架依赖版

macOS

cd DSHTray
./build.sh                         # 按当前架构(osx-arm64 / osx-x64)
./build.sh osx-arm64               # 指定 Apple Silicon
./build.sh osx-x64 fd              # 框架依赖版(目标机器需装 .NET 10 运行时)

产物:publish/DSHTray(单文件自包含二进制)与 DSHTray.app(已 ad-hoc 签名,含 icns 图标)。 应用图标由「tools/make-icns.sh」从「Icon.png」生成。分发他人使用需额外做 notarization。

📦 发布到 GitHub Release

方式 A:GitHub Actions 自动构建(推荐) —— 仓库已带 .github/workflows/release.yml, 推送 v* 标签后自动构建 win-x64 / win-arm64 exe 与 macOS 两种架构的 .app(构建前先跑自检/冒烟测试), 并附到对应 Release:

git tag v1.1.0
git push origin v1.1.0

也可以在 GitHub 仓库 Actions 页面手动触发(workflow_dispatch),产物从该次运行的 Artifacts 下载。

方式 B:本机构建后手动上传 —— 在 GitHub 仓库页面「Releases → Draft a new release」, 用下方命令产出的文件上传:

cd DSHTray
./build-win.sh            # → publish-win-x64\DSHTray.exe(Windows)
./build.sh osx-x64        # → DSHTray.app(Intel Mac)
./build.sh osx-arm64      # → DSHTray.app(Apple Silicon)
zip -r -y DSHTray-macos-arm64.zip DSHTray.app   # macOS 的 .app 需打包成 zip 再上传

注意:.app 是目录,Release 附件必须用 zip;本地产物为 ad-hoc 签名,他人首次打开需 右键(Control+点击)→「打开」;正式分发建议 Apple notarization。

🗂️ 项目结构

详见 DSHTray\README.md。

🧪 自检与冒烟测试(两个平台通用)

DSHTray --selftest result.txt    # 配置读写 / 端口检测 / 进程枚举 / PATH 解析
DSHTray --smoketest result.txt   # 端到端:启动测试服务 → 就绪探测 → 停止并确认清理

📄 License

MIT