@qing3a/dsh-tray

dsh-tray

DeepSeek Harness Windows 系统托盘插件：托盘图标 + 菜单（打开界面 / 状态 / 退出）+ 气泡通知。

基于 trayicon@1.2.2（exe 宿主进程 + TCP + XML 协议，无 native 编译）。win32-only。 状态：✅ 已在本地 DSH 源码环境验证（web 单托盘进程 + headless 降级，2026-08-14）。

功能

• 系统托盘图标（默认 default.ico，可配置 iconPath）
• 菜单：打开界面（读 webServer.port 动态拼接 URL）/ 状态 / 退出
• 气泡通知（info 风格）
• headless 兼容：无 webServer 时自动降级（不崩、不阻塞加载）

安装

# 开发模式（需 Node >= 22 + pnpm）
git clone https://github.com/qing3a/dsh-tray.git
cd dsh-tray && pnpm install && pnpm build

cd <path-to-deepseek-harness>
pnpm dsh plugin --profile web add link:$(pwd)/dsh-tray
pnpm dsh --profile web
# Windows 任务栏应出现 DSH 托盘图标

卸载

pnpm dsh plugin --profile web remove @qing3a/dsh-tray

配置

键	默认	说明
enabled	true	总开关
title	DSH	托盘标题（决定 temp 命名）
iconPath	空	自定义图标路径（.ico/.png Buffer）；留空用 default.ico

已知实现要点

• 不用 trayicon 的 useTempDir：复制 exe 到 temp 后立即 spawn 在 Windows 会 spawn EBUSY（文件句柄未释放），直接 spawn 包内 exe 无此问题
• 并发去重：start() 幂等（pending promise 共享），避免 apply 与 inject 并发调用导致双托盘
• 非 win32 平台自动跳过（process.platform !== 'win32'）
• webServer 用 ctx.inject 动态注入（headless 无此服务不阻塞）

许可

MIT