dsh-wsl-notify: 在 WSL 中通过 Windows 弹窗通知任务状态

前言¶

在 Windows 环境下开发 DeepSeek Harness (DSH) 智能体时，经常需要将长任务在 WSL 中后台运行。任务结束后，通过浏览器标签页去确认状态不够直观。dsh-wsl-notify 插件可以解决这个问题，它允许智能体在 WSL 中执行完任务后，直接在 Windows 端弹出提示框。

插件简介¶

dsh-wsl-notify 是 DeepSeek Harness 的一个工具插件，名为 win_notify。它属于 dsh-wsl-kit 套件的一部分。插件版本为 0.1.1，主要功能是从 WSL 代理中向 Windows 系统发送通知。

核心功能¶

Windows MessageBox 通知：默认通过 Windows 原生消息框提示。
Toast 回退机制：如果 MessageBox 失败，会自动降级使用系统托盘气球提示。
可配置参数：支持自定义标题、正文内容、通知模式以及超时时间。

安装与启用¶

通过 DSH 命令行安装该插件：

dsh plugin --profile web add github:173787247/dsh-wsl-notify

配置与用法¶

安装后，可以在配置文件中设置以下参数：

- id: dsh-wsl-notify
  name: dsh-wsl-notify
  config:
    timeoutMs: 30000
    maxLen: 500

默认行为：
- 标题：DSH
- 正文：Task finished.

通知模式：
- messagebox：阻塞式弹窗，直到用户关闭。
- toast：非阻塞式气球提示。

适用场景与注意¶

适用场景：适合需要在后台运行任务，且希望任务完成后立即获知结果的场景。
阻塞行为：messagebox 模式会阻塞当前进程，直到弹窗被用户手动关闭。请勿在需要长时间后台处理的任务中使用。
内容安全：消息内容不应包含敏感信息或密钥。
模型依赖：该插件不负责模型配置，使用时需确保在 ~/.dsh/settings.yaml 中正确配置 deepseek-flash 模型 ID。

总结¶

dsh-wsl-notify 是连接 WSL 任务执行与 Windows 桌面反馈的轻量级工具。对于习惯在 Windows 上开发但需要调用 WSL 环境的开发者，它能有效减少查看终端的频率。更多细节和源码，请参考 GitHub 仓库。