99galaxy/dsh-turn-notify

DSH 的 Windows 系统通知插件，在会话结束一轮运行时提醒你。

作者的碎碎念

dsh为啥还没有后台消息通知啊……后台跑任务的时候根本不知道任务跑完没。所以就vibe coding了一个插件。

功能

• 会话本轮运行结束后发送系统通知，标题显示会话名称。
• 正文默认显示“本轮已完成”；观察到本轮开始时间时，同时显示耗时。
• 点击通知可将 DSH 窗口拉回前台。
• 默认前台、后台均提醒，可设置为正在查看该会话时不打扰。
• 默认跳过子代理会话，避免重复打扰。
• 结合状态订阅、完成标记和两秒轮询检测回合结束，并对同一完成周期去重。

通知依赖 DSH 客户端保持运行及系统通知权限。DSH 完全退出后无法提醒。 “本轮已完成”表示运行已结束，不区分成功、失败或取消；仅靠轮询且没有完成标记时， 两次采样之间结束的短回合仍可能漏报。

安装

需要 Windows、DSH 桌面客户端，以及客户端提供的 dsh 命令。

1. 安装 npm 包，桌面版使用 desktop profile：

   dsh plugin --profile desktop add @99galaxy/dsh-turn-notify
   

   也可直接从 GitHub 安装：

   dsh plugin --profile desktop add github:99galaxy/dsh-turn-notify
   

2. 重启 DSH，并确保 Windows 允许 DSH 发送系统通知。安装器通过包内的 dsh.bundle 自动注册插件，无需手动追加 insert。

   如需修改默认设置，在该 profile 的 cordis.patch.yml 顶层数组末尾添加配置覆盖：

   - id: dsh-turn-notify
     config:
       enabled: true
       notifyWhenFocused: true
       skipSubagents: true
       maskTitle: false
       message: 本轮已完成
   

配置说明：

配置项	默认值	作用
enabled	true	是否启用通知
notifyWhenFocused	true	设为 false 时，窗口在前台且正在查看该会话则不提醒
skipSubagents	true	是否跳过子代理会话
maskTitle	false	设为 true 时，系统通知标题固定为“会话已完成”，避免显示会话名称
message	本轮已完成	通知正文前缀

配置需要 profile 提供 webServer 服务。修改配置后重启 DSH，使客户端重新读取。

项目目录

.
├── lib/
│   ├── index.js       # Host 入口及客户端配置接口
│   └── client.js      # 会话状态检测和系统通知
├── test/
│   └── smoke.mjs      # 回归测试
├── .github/
│   └── workflows/
│       └── test.yml   # GitHub Actions 测试
├── .gitignore         # 本地配置、凭据及构建产物忽略规则
├── LICENSE            # MIT 许可证
├── cordis.patch.yml   # DSH bundle 安装入口
├── package.json       # 包信息与 DSH 客户端声明
└── README.md

从源码构建

需要 Node.js 22 或更新版本、Git；本地安装到 DSH 时还需要 pnpm。 项目以原生 JavaScript 编写，无第三方运行依赖，也不需要转译或打包器；lib/ 中的代码就是发布入口。

git clone https://github.com/99galaxy/dsh-turn-notify.git
cd dsh-turn-notify

node --check lib/index.js
node --check lib/client.js
node test/smoke.mjs

npm pack --dry-run
npm pack

最后一条命令在项目目录生成 99galaxy-dsh-turn-notify-<version>.tgz。执行 dsh plugin --profile desktop add <插件压缩包的路径>，再重启 DSH。 每次修改源码后，需重新打包、安装，再重启客户端。

开源许可

本项目采用 MIT License。允许使用、修改和分发，须保留版权声明与许可证文本。