DeepSeek Harness Plugin Hub

发布与管理完整 Harness Profiles，发现适合你的插件。

探索

插件目录环境预设文档中心动态

社区

发布插件联系我们报告问题

相关链接

Plugin Hub GitHubDeepSeek Harness 官方项目系统状态隐私说明
© 2026 DeepSeek Harness Plugin HubPowered byPaxTech

独立、非官方社区项目，与 DeepSeek 官方无隶属、授权或背书关系。

Wsl Tray — DeepSeek Harness 插件（DSH Plugin）
DeepSeek Harness Plugin Hub
ProfilesPlugins分类动态文档登录管理 Profiles
ProfilesPlugins分类动态文档登录
← Plugins
W

dsh-wsl-tray

Wsl Tray

DSH 插件：用于在 WSL 中运行 DSH 的 Windows 桌面快捷方式和系统托盘启动器

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:liyu34/dsh-wsl-tray#90e7cfbb6f2ece2ff1cdbe7cdd12ef21df14c428
README兼容性版本

兼容性与来源证明

Wsl Tray 以 dsh-wsl-tray 发布，当前版本为 0.1.5。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围
*
运行环境
web
发布来源
github
Registry 更新时间
2026/8/30

版本

0.1.5stable
2026/8/30
0.1.4stable
2026/8/23
0.1.3stable
2026/8/22

相关插件

正在加载相关插件…

最新版
0.1.5
DSH
*
HMR
重启进程
Tree shaking
未声明可安全裁剪
解包体积
未提供
文件数
未提供
Surface
web
许可证
MIT
发布源
github
GitHub
★ 2
周下载
0
最近提交
2026/8/30
查看源码 ↗
README Badge

点击下方 Badge 复制 Markdown，粘贴到 README 即可。

这是你的 Plugin？认领权益 · 优先安全扫描

验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。

认领这个 Plugin →
报告问题

相关插件

继续浏览 ui-customization 分类下经过校验的插件。

Remote Web Ui@linxin666/dsh-remote-web-ui通过扫码配对访问 dsh Web GUI，共享一个官方界面：设置按钮旁的二维码可将手机和 PC 配对到同一个 Web GUI（手机采用竖屏触控适配层，PC 使用完整桌面界面），通过一次性令牌和 rClient Ui Task Board@linxin666/dsh-client-ui-task-board面向 DSH Web GUI 的主机权威任务面板，支持实际会话执行、主机 cron 调度以及可选的跨平台空闲睡眠保护；以挂载方式提供，无需修改 DSH 源代码。Client Ui Git Graph@linxin666/dsh-client-ui-git-graph外部 dsh Web GUI 插件：空会话 Git 分支选择器和 Git 图，包含实际的主机端 Git 操作与防护，作为 dsh 配置文件包Pet@linxin666/dsh-pet适用于 dsh Web GUI 的多宠物伴侣插件：由注册表驱动的浮动宠物，可响应模型活动，支持为每只宠物命名、抚摸/喂食互动以及亲密度评分

README

dsh-wsl-tray

中文 | English

A DeepSeek Harness plugin for WSL deployments: it puts a Windows desktop shortcut and a system-tray launcher in front of the DSH web server running inside WSL.

Features

  • Double-click the DeepSeek Harness desktop shortcut to start DSH in the background (or reuse an already-running instance). The default browser opens exactly once when DSH is ready (the built-in DSH browser-open is disabled by --no-open; only the tray opens it).
  • A DSH fish tray icon appears. Right-click menu:
    • 打开 DeepSeek Harness / open the DSH web page
    • 重新生成桌面快捷方式 / recreate the desktop shortcut
    • 重启 DSH 服务 / restart the DSH service
    • 暂停守护进程 / 恢复守护进程 / pause or resume the watchdog
    • 退出 / exit the tray icon
  • Double-clicking the tray icon also opens the DSH web page.
  • A watchdog daemon runs inside the tray: it probes the DSH URL on a timer, restarts DSH when the probes fail, gives up after a bounded number of consecutive failed restarts, and writes a full audit trail to watchdog.log (see Watchdog below).
  • The plugin-configuration card shows live status (tray files + watchdog state) and a button that recreates the desktop shortcut without touching WSL by hand. The card can also show the tail of the watchdog log.
  • No console window is shown: the shortcut goes through wscript.exe + VBS and the entire chain is launched with window style 0.

Requirements

  • DSH itself must be running inside WSL (WSL_DISTRO_NAME set, /mnt/c accessible).
  • Windows must be able to run wscript.exe, powershell.exe, and wsl.exe.
  • DSH web 0.1.0-rc.7 or newer (settings cards + client bundle machinery).

Install

Once published to npm:

dsh plugin --profile web add dsh-wsl-tray

Or add it manually to a DSH web profile:

cd ~/.dsh/profiles/web
pnpm add dsh-wsl-tray

and add "dsh-wsl-tray" to package.json:

"dsh": {
  "profile": {
    "bundles": [
      "@deepseek-ai/dsh-base",
      "@deepseek-ai/dsh-web-app",
      "dsh-wsl-tray"
    ]
  }
}

Restart dsh web and open Settings → Plugins → Plugin configuration to see the WSL 桌面与托盘 card.

Generated files

The plugin writes five generated files:

FileLocation
dsh.ico%USERPROFILE%\.dsh\dsh-wsl-tray\dsh.ico
dsh-tray.ps1%USERPROFILE%\.dsh\dsh-wsl-tray\dsh-tray.ps1
dsh-tray.vbs%USERPROFILE%\.dsh\dsh-wsl-tray\dsh-tray.vbs
start.sh~/.dsh/dsh-wsl-tray/start.sh
stop.sh~/.dsh/dsh-wsl-tray/stop.sh

and creates:

%USERPROFILE%\Desktop\DeepSeek Harness.lnk

While the tray runs, the watchdog maintains two runtime files (both are shown on the config card):

FileLocation
watchdog.log%USERPROFILE%\.dsh\dsh-wsl-tray\watchdog.log (rotated at 512 KB)
watchdog-status.json%USERPROFILE%\.dsh\dsh-wsl-tray\watchdog-status.json (latest tick)

The shortcut points at wscript.exe, which runs dsh-tray.vbs; the VBS starts the tray PowerShell hidden, and the tray starts start.sh inside WSL through WScript.Shell.Run(..., 0, false).

Watchdog

The watchdog lives inside the tray helper (the one process that is deliberately independent of DSH), and answers the three questions a restart daemon has to:

  1. How liveness is judged — an HTTP Invoke-WebRequest probe of the DSH web URL every probeIntervalSec (default 10 s, probe timeout 3 s). Each probe records its status code or error text, so a refused connection (nothing listening), a timeout (hung server) and a bad status stay distinguishable in the log. DSH is only considered DOWN after downThreshold (3) consecutive failed probes.
  2. Restart success & giving up — a restart is triggered (stop + start via wsl.exe) and the watchdog waits up to restartWaitSec (180 s) for the URL to answer again: an answer = success, which resets the failure counter; an unanswered window = one failed restart. After maxRestartFailures (3) consecutive failures the watchdog pauses instead of looping forever. It resumes from the tray menu (恢复守护进程), or automatically as soon as DSH answers again.
  3. Logging — every probe transition, restart trigger, success/failure and pause/resume is appended to watchdog.log with a timestamp, level and the probe detail; the current state machine snapshot goes to watchdog-status.json every tick. The plugin card exposes both through /dsh-wsl-tray/watchdog and /dsh-wsl-tray/watchdog-log.

Phases: starting (initial boot grace) → probing (steady state) → restarting (waiting after a restart) → backoff (cooldown) or paused (give-up / manual pause). The tuning values above are baked into dsh-tray.ps1; change them in src/artifacts.ts (DEFAULT_WATCHDOG_CONFIG) and regenerate.

Install without npm publishing

If npm publishing is not an option, install the prebuilt tarball that is included in this repository:

cd ~/.dsh/profiles/web
pnpm add /path/to/dsh-wsl-tray-github/dist/dsh-wsl-tray-0.1.4.tgz

Then add "dsh-wsl-tray" to the profile bundle list as above.

How it works

  1. Hidden launch: shortcut → wscript.exe → VBS → hidden PowerShell tray.
  2. DSH stays alive: start.sh runs DSH in the foreground of the hidden wsl.exe session, so WSL does not recycle the process after the one-shot launcher exits.
  3. Automatic browser open: a Windows-side timer in the tray polls the DSH URL every 2 seconds and calls Start-Process $webUrl once DSH answers.
  4. Watchdog: a second tray timer probes the URL every 10 seconds and runs the state machine described above.
  5. Regeneration: the config card and the tray menu both run dsh-tray.ps1 -Regenerate.

Development

npm install
npm run typecheck
npm test
npm run build
npm pack --dry-run

Known limitations

  • Only enabled inside WSL; on non-WSL hosts the card reports that the feature is unavailable.
  • The watchdog runs only while the tray icon is up: choosing 退出 stops the watchdog and the DSH instance (via the generated stop.sh: a PID file tracks the instance start.sh launched, then a pattern fallback covers bin.js web launches from source checkouts, npm global installs and npx). Add the shortcut to the Windows Startup folder if you want the watchdog to follow Windows boot.
  • A DSH web instance started any other way (different flags, another tool) is not tracked by the PID file; stop it by hand (Windows Task Manager or wsl --shutdown) if the pattern fallback does not reach it.