pi-win-notify 1.0.1 → 1.0.2

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.
Files changed (3) hide show
  1. package/README.md +33 -33
  2. package/README.zh.md +54 -0
  3. package/package.json +2 -1
package/README.md CHANGED
@@ -1,54 +1,54 @@
1
1
  # pi-win-notify
2
2
 
3
- pi coding agent 桌面通知扩展。pi 完成输出时右下角弹出通知窗口,切到其他程序时不会错过。
3
+ Desktop notification for [pi coding agent](https://pi.dev). Pops up a rich popup when pi finishes output — never miss a completed task.
4
4
 
5
- *Desktop notification for pi coding agent. Pops up when pi finishes output — never miss a completed task.*
5
+ > 中文说明见 [README.zh.md](./README.zh.md)
6
6
 
7
- ## 安装 / Install
7
+ ## Install
8
8
 
9
9
  ```bash
10
10
  pi install pi-win-notify
11
11
  ```
12
12
 
13
- 或从 GitHub / *or from GitHub*:
13
+ Or from GitHub:
14
14
 
15
15
  ```bash
16
16
  pi install git:https://github.com/ryanchan720/pi-desktop-notify.git
17
17
  ```
18
18
 
19
- ## 使用 / Usage
19
+ ## Usage
20
20
 
21
- | 命令 / Command | 说明 / Description |
21
+ | Command | Description |
22
22
  |---------|-------------|
23
- | `/notify` | 开关切换 / Toggle on/off |
24
- | `/notify on` / `off` | 强制开关 / Force state |
25
- | `/notify timeout 15` | 自动消失秒数 (5~60, 默认 15) / Auto-dismiss seconds |
26
- | `/notify opacity 1.0` | 窗口不透明度 (0.3~1.0) / Window opacity |
27
- | `/notify message fixed` | 固定完成文本 / Fixed completion text |
28
- | `/notify message response` | AI 回复前 50 字 (默认) / AI reply first 50 chars |
29
- | `/notify lang en` | 语言:`zh` `en` `ja` `ko` / Language |
30
- | `/notify status` | 守护进程状态 + 当前配置 / Daemon health + config |
31
-
32
- ## 特性 / Features
33
-
34
- - 🪟 暗色圆角弹窗,右下角,跟光标走 / *Dark rounded popup, bottom-right, cursor-aware*
35
- - 🔝 置顶、不抢焦点、可配不透明度、自动消失 / *Top-most, no focus steal, configurable opacity, auto-dismiss*
36
- - ⏱ 显示耗时 / *Elapsed time display*
37
- - 🔕 勿扰按钮:3 分钟 / 30 分钟 / 1 小时 / 关闭 / *Mute: 3min / 30min / 1h / off*
38
- - 持久化到磁盘,重启不丢 / *Persists to disk, survives restarts*
39
- - 多实例自动同步 / *Multi-instance auto-sync*
40
- - ⌨ **Alt+[** 关闭, **Alt+]** 切回终端 / *Alt+[ dismiss, Alt+] switch back*
41
- - 🤖 自动抑制重试和压缩期间的弹窗 / *Auto-suppress during retries & compaction*
42
- - 🏠 终端在前台时自动跳过 / *Skip when terminal is focused*
43
- - 📝 通知标题取用户 prompt 前 25 字 / *Title = first 25 chars of prompt*
44
- - 📚 多 pi 窗口堆叠 / *Multi-pi window stacking*
45
- - ⚡ 常驻守护进程:首次 ~3s,后续 <0.5s / *Persistent daemon: first ~3s, subsequent <0.5s*
46
- - 🌍 跨平台:Windows / macOS / Linux
47
-
48
- ## 测试 / Test
23
+ | `/notify` | Toggle on/off |
24
+ | `/notify on` / `off` | Force state |
25
+ | `/notify timeout 15` | Auto-dismiss seconds (5~60, default 15) |
26
+ | `/notify opacity 1.0` | Window opacity (0.3~1.0) |
27
+ | `/notify message fixed` | Fixed completion text |
28
+ | `/notify message response` | AI reply first 50 chars (default) |
29
+ | `/notify lang en` | Language: `zh` `en` `ja` `ko` |
30
+ | `/notify status` | Daemon health + current config |
31
+
32
+ ## Features
33
+
34
+ - 🪟 Dark rounded popup, bottom-right, follows cursor across monitors
35
+ - 🔝 Top-most, doesn't steal focus, configurable opacity, auto-dismiss
36
+ - ⏱ Elapsed time display
37
+ - 🔕 Mute button: 3 min / 30 min / 1 hour / off
38
+ - Persists to disk, survives restarts
39
+ - Multi-instance auto-sync via file check on each `agent_end`
40
+ - ⌨ **Alt+[** dismiss, **Alt+]** switch back to terminal
41
+ - 🤖 Auto-suppress during LLM retries & context compaction
42
+ - 🏠 Skip when terminal is already focused
43
+ - 📝 Title = first 25 chars of user prompt
44
+ - 📚 Multi-pi window stacking
45
+ - ⚡ Persistent daemon: first popup ~3s, subsequent <0.5s
46
+ - 🌍 Cross-platform: Windows / macOS / Linux
47
+
48
+ ## Test
49
49
 
50
50
  ```bash
51
51
  node --experimental-strip-types tests/tests.ts
52
52
  ```
53
53
 
54
- 42 个单元测试 / *42 unit tests.*
54
+ 42 unit tests covering content extraction, retry detection, and state machine.
package/README.zh.md ADDED
@@ -0,0 +1,54 @@
1
+ # pi-win-notify
2
+
3
+ [pi coding agent](https://pi.dev) 桌面通知扩展。pi 完成输出时右下角弹出通知窗口,切到其他程序时不会错过。
4
+
5
+ > For English, see [README.md](./README.md)
6
+
7
+ ## 安装
8
+
9
+ ```bash
10
+ pi install pi-win-notify
11
+ ```
12
+
13
+ 或从 GitHub:
14
+
15
+ ```bash
16
+ pi install git:https://github.com/ryanchan720/pi-desktop-notify.git
17
+ ```
18
+
19
+ ## 使用
20
+
21
+ | 命令 | 说明 |
22
+ |---------|-------------|
23
+ | `/notify` | 开关切换 |
24
+ | `/notify on` / `off` | 强制开关 |
25
+ | `/notify timeout 15` | 自动消失秒数 (5~60, 默认 15) |
26
+ | `/notify opacity 1.0` | 窗口不透明度 (0.3~1.0) |
27
+ | `/notify message fixed` | 固定完成文本 |
28
+ | `/notify message response` | AI 回复前 50 字(默认) |
29
+ | `/notify lang en` | 语言:`zh` `en` `ja` `ko` |
30
+ | `/notify status` | 守护进程状态 + 当前配置 |
31
+
32
+ ## 特性
33
+
34
+ - 🪟 暗色圆角弹窗,右下角,跟光标走
35
+ - 🔝 置顶、不抢焦点、可配不透明度、自动消失
36
+ - ⏱ 显示耗时
37
+ - 🔕 勿扰按钮:3 分钟 / 30 分钟 / 1 小时 / 关闭
38
+ - 持久化到磁盘,重启不丢
39
+ - 多实例自动同步:每次 `agent_end` 检查文件
40
+ - ⌨ **Alt+[** 关闭,**Alt+]** 切回终端
41
+ - 🤖 自动抑制 LLM 重试和上下文压缩期间的弹窗
42
+ - 🏠 终端在前台时自动跳过
43
+ - 📝 通知标题 = 用户 prompt 前 25 字
44
+ - 📚 多 pi 窗口堆叠
45
+ - ⚡ 常驻守护进程:首次弹窗 ~3s,后续 <0.5s
46
+ - 🌍 跨平台:Windows / macOS / Linux
47
+
48
+ ## 测试
49
+
50
+ ```bash
51
+ node --experimental-strip-types tests/tests.ts
52
+ ```
53
+
54
+ 42 个单元测试,覆盖内容提取、重试检测和状态机。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-win-notify",
3
- "version": "1.0.1",
3
+ "version": "1.0.2",
4
4
  "type": "module",
5
5
  "description": "WPF desktop notification for pi coding agent — rich popup with mute, multi-monitor, i18n",
6
6
  "keywords": [
@@ -25,6 +25,7 @@
25
25
  "extensions/desktop-notify.ts",
26
26
  "extensions/host.ps1",
27
27
  "README.md",
28
+ "README.zh.md",
28
29
  "package.json"
29
30
  ],
30
31
  "dependencies": {