xiaoso-pi-plugin-windows-notify

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

[简体中文](https://github.com/xiaoso456/pi-plugin-windows-notify/blob/HEAD/README.zh-CN.md) | English
# pi-windows-tip

A [pi](https://github.com/earendil-works/pi) extension that sends Windows desktop notifications when tasks complete, fail, or need your confirmation — so you can step away and come back when Pi needs you.

> ⚠️ **Windows only** — this extension uses Windows-specific APIs and will not work on other platforms.
>
> Compatible with both [Pi](https://github.com/earendil-works/pi) and [OMP (Oh My Pi)](https://github.com/can1357/oh-my-pi).

## Features

- Task completion / failure / confirmation-request notifications
- AFK mode — only notify when you're away from the Pi window
- Minimum task duration filter (skip trivially short tasks)
- 7 languages (en, zh-CN, ja, ko, es, fr, ru) — auto-detected from system locale
- Persistent settings across sessions

## Install

**Pi:**

```bash
pi install npm:@xiaoso/pi-plugin-windows-notify
```

**OMP:**

```bash
omp plugin install @xiaoso/pi-plugin-windows-notify
```

Or from git:

```bash
pi install git:github.com/xiaoso456/pi-plugin-windows-notify
```

## Commands

```text
/notify    — open notification settings
```

## Settings

| Setting | Values | Description |
|---|---|---|
| Enabled | on / off | Master switch |
| Notify Mode | afk / all | afk: only notify when away; all: always notify |
| Language | en / zh-CN / ja / ko / es / fr / ru | Display language |

Config file (Pi): `~/.pi/agent/pi-windows-tip-config.json`
Config file (OMP): `~/.omp/agent/pi-windows-tip-config.json`

## How it works

Listens to Pi lifecycle events and sends notifications via [node-notifier](https://github.com/mikaelbr/node-notifier). In AFK mode, [active-win](https://github.com/sindresorhus/active-win) checks whether the foreground window is still Pi — notifications are suppressed while you're watching.


## License

MIT

简体中文 | English

pi-windows-tip

A pi extension that sends Windows desktop notifications when tasks complete, fail, or need your confirmation — so you can step away and come back when Pi needs you.

⚠️ Windows only — this extension uses Windows-specific APIs and will not work on other platforms.

Compatible with both Pi and OMP (Oh My Pi).

Features

Task completion / failure / confirmation-request notifications
AFK mode — only notify when you're away from the Pi window
Minimum task duration filter (skip trivially short tasks)
7 languages (en, zh-CN, ja, ko, es, fr, ru) — auto-detected from system locale
Persistent settings across sessions

Install

Pi:

pi install npm:@xiaoso/pi-plugin-windows-notify

OMP:

omp plugin install @xiaoso/pi-plugin-windows-notify

Or from git:

pi install git:github.com/xiaoso456/pi-plugin-windows-notify

Commands

/notify    — open notification settings

Settings

Setting	Values	Description
Enabled	on / off	Master switch
Notify Mode	afk / all	afk: only notify when away; all: always notify
Language	en / zh-CN / ja / ko / es / fr / ru	Display language

Config file (Pi): ~/.pi/agent/pi-windows-tip-config.json Config file (OMP): ~/.omp/agent/pi-windows-tip-config.json

How it works

Listens to Pi lifecycle events and sends notifications via node-notifier. In AFK mode, active-win checks whether the foreground window is still Pi — notifications are suppressed while you're watching.

License

MIT