dsh-notify 0.1.4 → 0.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +21 -0
- package/README.en.md +100 -0
- package/README.md +10 -7
- package/docs/notify-toast.png +0 -0
- package/package.json +11 -3
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## [0.1.6] - 2026-08-29
|
|
4
|
+
|
|
5
|
+
- 文档：删除与 FAQ 重复的「排障/触发时机」节；新增兼容性行（Windows 10/11 · Node ≥ 22.5 · DSH 0.1.1-rc.2 实测）；
|
|
6
|
+
- 元数据：npm description 重写（唯一托盘 + workspace·session 标注），keywords 10 → 15；
|
|
7
|
+
- 新增英文版 README.en.md 与双语切换行；CHANGELOG.md 纳入 npm files。
|
|
8
|
+
## [0.1.5] - 2026-08-25
|
|
9
|
+
|
|
10
|
+
- 相关插件段新增 dsh-plugin-windows-guard（Windows 环境防坑守则 skill 插件，互相引流）。
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
## [0.1.4] - 2026-08-21
|
|
14
|
+
|
|
15
|
+
- README 新增「相关插件」互相引用段（列出同系列已发布插件，npm / GitHub 链接 + 一句话说明），互相引流。
|
|
16
|
+
|
|
17
|
+
## [0.1.3] - 2026-08-19
|
|
18
|
+
|
|
19
|
+
- Windows 原生通知 + 系统托盘常驻图标（dsh 生态唯一带托盘）。
|
|
20
|
+
- 触发时机：完成 / 停止 / 出错 / 等你选择 / 会话关闭。
|
|
21
|
+
- 发布 npm、GitHub topics、dsh-market 收录（issue #37/#41）。
|
package/README.en.md
ADDED
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
[中文](./README.md) | **English**
|
|
2
|
+
|
|
3
|
+
# dsh-notify
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
**The only dsh plugin with a system tray icon**: when the agent stops running (finished / aborted / error / waiting for your choice / session closed), a native Windows Toast pops up automatically with the body labeled "workspace · session", and a whale icon stays resident in the taskbar tray — switch away from the window during long tasks and one glance at the tray tells you whether it's done.
|
|
10
|
+
|
|
11
|
+
Zero runtime dependencies, zero build; one `dsh plugin add` command and it's ready to use.
|
|
12
|
+
|
|
13
|
+
## Screenshot
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
> Real Windows Toast capture: the body is labeled "workspace · session", and the whale icon stays
|
|
18
|
+
> resident in the taskbar tray.
|
|
19
|
+
|
|
20
|
+
## Features
|
|
21
|
+
|
|
22
|
+
- **Native Windows Toast notifications**: when the agent stops running (finished / aborted / error / output limit reached / waiting for your choice / session closed), a system notification pops up automatically with the body labeled "workspace · session" — tell at a glance which session finished;
|
|
23
|
+
- **Permanent system tray icon**: a whale icon stays resident in the taskbar tray; the right-click menu opens the dsh web page / quits the background process (competitors explicitly ship no tray — this plugin is the only one in the dsh ecosystem);
|
|
24
|
+
- **Anti-spam**: `rootsOnly` defaults to notifying only root sessions, so subagents won't flood you; `cooldownMs` sets the minimum interval between two notifications of the same type in the same session;
|
|
25
|
+
- **Zero runtime dependencies, zero build**: one `dsh plugin add` command and it's ready to use.
|
|
26
|
+
|
|
27
|
+
## Use cases
|
|
28
|
+
|
|
29
|
+
- **Switch windows during long tasks**: while a long LLM generation / batch job runs, switch to another app; when it ends, a tray notification pops up and one glance tells you the result;
|
|
30
|
+
- **Unattended batch jobs**: run multiple rounds overnight and get a Toast when everything is done — no need to keep watching the page;
|
|
31
|
+
- **Multiple sessions at once**: run several workspace sessions simultaneously; each notification body carries the "workspace · session" label, so nothing gets mixed up;
|
|
32
|
+
- **Watching subagents**: keep the default `rootsOnly: true` when you only care about root-session results, and turn it off when you need to watch subagents.
|
|
33
|
+
|
|
34
|
+
## Installation
|
|
35
|
+
|
|
36
|
+
```powershell
|
|
37
|
+
dsh plugin --profile web add dsh-notify
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Install from GitHub: `dsh plugin --profile web add github:Pasumao/dsh-plugin-notify`
|
|
41
|
+
|
|
42
|
+
Install from source (local development / debugging):
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
git clone https://github.com/Pasumao/dsh-plugin-notify.git
|
|
46
|
+
cd dsh-plugin-notify
|
|
47
|
+
npm install
|
|
48
|
+
# Mount into the profile as a link: dependency (package name: dsh-notify)
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
After installing, restart `dsh web`; the plugin is active once the whale icon appears in the taskbar.
|
|
52
|
+
|
|
53
|
+
> Compatibility: Windows 10/11 · Node ≥ 22.5 · tested on DSH `0.1.1-rc.2`.
|
|
54
|
+
|
|
55
|
+
## Configuration
|
|
56
|
+
|
|
57
|
+
Override the config in the profile's `cordis.patch.yml` under the id `dsh-plugin-notify`. Common options:
|
|
58
|
+
|
|
59
|
+
| key | Default | Description |
|
|
60
|
+
|---|---|---|
|
|
61
|
+
| `cooldownMs` | `10000` | Minimum interval in milliseconds between two notifications of the same type in the same session |
|
|
62
|
+
| `rootsOnly` | `true` | Notify only root sessions; subagents won't flood you |
|
|
63
|
+
| `tray` | `true` | Enable/disable the tray icon |
|
|
64
|
+
| `titlePrefix` | `'dsh'` | Notification title prefix |
|
|
65
|
+
|
|
66
|
+
## Testing
|
|
67
|
+
|
|
68
|
+
```powershell
|
|
69
|
+
node scripts/test-harness.mjs # Fires three real Toast notifications as a self-test
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
## FAQ
|
|
73
|
+
|
|
74
|
+
- **Not receiving notifications?** Check that Windows "Settings → System → Notifications" allows PowerShell to show notifications, and that you are not in Focus Assist / Do Not Disturb mode;
|
|
75
|
+
- **Only root-session notifications?** Keep the default `rootsOnly: true`; change it to `false` when you need to watch subagents;
|
|
76
|
+
- **Notifications too frequent?** Just increase `cooldownMs` (default 10000ms);
|
|
77
|
+
- **Tray icon missing?** Restart dsh web; if it is still gone, check whether the `tray: true` config key was overridden.
|
|
78
|
+
|
|
79
|
+
## Related plugins
|
|
80
|
+
|
|
81
|
+
This plugin is part of the **Pasumao dsh plugin ecosystem**; the published plugins in the series work well together:
|
|
82
|
+
|
|
83
|
+
| Plugin (npm) | GitHub | Description |
|
|
84
|
+
|---|---|---|
|
|
85
|
+
| [dsh-plugin-choice-refresh](https://www.npmjs.com/package/dsh-plugin-choice-refresh) | [GitHub repo](https://github.com/Pasumao/dsh-plugin-choice-refresh) | Choice enhancements: regenerate options / more options |
|
|
86
|
+
| [dsh-plugin-dev-kb](https://www.npmjs.com/package/dsh-plugin-dev-kb) | [GitHub repo](https://github.com/Pasumao/dsh-plugin-dev-kb) | Plugin development knowledge base (full mirror of official docs + skills) |
|
|
87
|
+
| [dsh-plugin-image-tools](https://www.npmjs.com/package/dsh-plugin-image-tools) | [GitHub repo](https://github.com/Pasumao/dsh-plugin-image-tools) | Image choice cards + inline images in replies + image pickup for blind models |
|
|
88
|
+
| [dsh-plugin-table-zoom](https://www.npmjs.com/package/dsh-plugin-table-zoom) | [GitHub repo](https://github.com/Pasumao/dsh-plugin-table-zoom) | Floating window for long chat tables + one-click Markdown copy |
|
|
89
|
+
| [dsh-plugin-windows-guard](https://www.npmjs.com/package/dsh-plugin-windows-guard) | [GitHub repo](https://github.com/Pasumao/dsh-plugin-windows-guard) | Windows environment guard: rule skills + mojibake detection / dangerous-write interception / encoding diagnosis & repair |
|
|
90
|
+
| [dsh-plugin-workbench](https://www.npmjs.com/package/dsh-plugin-workbench) | [GitHub repo](https://github.com/Pasumao/dsh-plugin-workbench) | VS Code-style file explorer + editable preview |
|
|
91
|
+
|
|
92
|
+
> For the other plugins in the series, see [Pasumao · dsh plugins](https://github.com/Pasumao); if you find them useful, a ⭐ on GitHub is appreciated.
|
|
93
|
+
|
|
94
|
+
## AI-generated disclosure
|
|
95
|
+
|
|
96
|
+
The code and documentation were generated with AI assistance (DeepSeek Harness), all human-reviewed and verified on a live machine (`scripts/test-harness.mjs` fires real Toast notifications as a self-test).
|
|
97
|
+
|
|
98
|
+
## License
|
|
99
|
+
|
|
100
|
+
[MIT](./LICENSE)
|
package/README.md
CHANGED
|
@@ -4,10 +4,18 @@
|
|
|
4
4
|
|
|
5
5
|
|
|
6
6
|
|
|
7
|
+
[**中文**](./README.md) | [English](./README.en.md)
|
|
8
|
+
|
|
7
9
|
**唯一带系统托盘的 Windows 原生通知插件**：agent 不再运行时（完成 / 停止 / 出错 / 等你选择 / 会话关闭）自动弹原生 Toast，正文标注「工作区 · 会话」，任务栏托盘常驻鲸鱼图标——跑长任务时切走窗口，瞄一眼托盘就知道跑完了没。
|
|
8
10
|
|
|
9
11
|
零运行时依赖、零构建，`dsh plugin add` 一条命令装完即用。
|
|
10
12
|
|
|
13
|
+
## 效果图
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
> 真实 Windows Toast 实拍：正文标注「工作区 · 会话」，任务栏托盘鲸鱼图标常驻。
|
|
18
|
+
|
|
11
19
|
## 功能
|
|
12
20
|
|
|
13
21
|
- **Windows 原生 Toast 通知**：agent 不再运行时（完成 / 停止 / 出错 / 达到输出上限 / 等你选择 / 会话关闭）自动弹系统通知，正文标注「工作区 · 会话」，一眼知道哪个会话跑完了；
|
|
@@ -41,9 +49,7 @@ npm install
|
|
|
41
49
|
|
|
42
50
|
装完重启 `dsh web`，任务栏出现鲸鱼图标即生效。
|
|
43
51
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
任务完成、被中止、执行出错、达到输出上限、停下来等你选择、运行中的会话被关闭。
|
|
52
|
+
> 兼容性：Windows 10/11 · Node ≥ 22.5 · 实测于 DSH `0.1.1-rc.2`。
|
|
47
53
|
|
|
48
54
|
## 配置
|
|
49
55
|
|
|
@@ -70,10 +76,6 @@ node scripts/test-harness.mjs # 弹三条真实 Toast 自测
|
|
|
70
76
|
- **通知太频繁？** 调大 `cooldownMs`（默认 10000ms）即可；
|
|
71
77
|
- **托盘图标不见了？** 重启 dsh web；仍无则检查 `tray: true` 配置项是否被覆盖。
|
|
72
78
|
|
|
73
|
-
## 排障
|
|
74
|
-
|
|
75
|
-
Toast 不出现：检查 Windows「通知与操作」是否允许 PowerShell 显示通知。
|
|
76
|
-
|
|
77
79
|
## 相关插件
|
|
78
80
|
|
|
79
81
|
本插件属于 **Pasumao 的 dsh 插件生态**，同系列已发布插件可搭配使用：
|
|
@@ -84,6 +86,7 @@ Toast 不出现：检查 Windows「通知与操作」是否允许 PowerShell 显
|
|
|
84
86
|
| [dsh-plugin-dev-kb](https://www.npmjs.com/package/dsh-plugin-dev-kb) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-dev-kb) | 插件开发知识库（官方文档完整镜像 + 技能） |
|
|
85
87
|
| [dsh-plugin-image-tools](https://www.npmjs.com/package/dsh-plugin-image-tools) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-image-tools) | 图片选择卡 + 回复内嵌图片 + 盲模型收图 |
|
|
86
88
|
| [dsh-plugin-table-zoom](https://www.npmjs.com/package/dsh-plugin-table-zoom) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-table-zoom) | 聊天长表格浮窗查看 + 一键复制 Markdown |
|
|
89
|
+
| [dsh-plugin-windows-guard](https://www.npmjs.com/package/dsh-plugin-windows-guard) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-windows-guard) | Windows 环境防坑：守则技能 + 乱码检测 / 危险写拦截 / 编码诊断修复 |
|
|
87
90
|
| [dsh-plugin-workbench](https://www.npmjs.com/package/dsh-plugin-workbench) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-workbench) | VS Code 风格文件浏览器 + 可编辑预览 |
|
|
88
91
|
|
|
89
92
|
> 本系列其余插件见 [Pasumao · dsh 插件](https://github.com/Pasumao)；觉得好用欢迎到 GitHub 点 ⭐。
|
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-notify",
|
|
3
|
-
"description": "DeepSeek Harness (dsh)
|
|
4
|
-
"version": "0.1.
|
|
3
|
+
"description": "Native Windows toast + system tray for DeepSeek Harness (dsh): the only dsh plugin with a tray icon. Pops the moment the agent stops running — finished / aborted / error / output limit / waiting for your choice / session closed — body labeled with workspace · session, so you can switch windows during long tasks and glance at the tray instead of watching a spinner. Pure host-side, zero dependencies, zero build.",
|
|
4
|
+
"version": "0.1.6",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "lib/index.js",
|
|
7
7
|
"exports": {
|
|
@@ -12,8 +12,11 @@
|
|
|
12
12
|
"lib",
|
|
13
13
|
"assets",
|
|
14
14
|
"scripts",
|
|
15
|
+
"docs",
|
|
15
16
|
"cordis.patch.yml",
|
|
16
17
|
"README.md",
|
|
18
|
+
"README.en.md",
|
|
19
|
+
"CHANGELOG.md",
|
|
17
20
|
"设计文稿.md",
|
|
18
21
|
"LICENSE"
|
|
19
22
|
],
|
|
@@ -37,7 +40,12 @@
|
|
|
37
40
|
"notify",
|
|
38
41
|
"notification",
|
|
39
42
|
"toast",
|
|
40
|
-
"windows"
|
|
43
|
+
"windows-toast",
|
|
44
|
+
"tray",
|
|
45
|
+
"system-tray",
|
|
46
|
+
"windows",
|
|
47
|
+
"long-running",
|
|
48
|
+
"agent-monitor"
|
|
41
49
|
],
|
|
42
50
|
"repository": {
|
|
43
51
|
"type": "git",
|