@xiaoso/pi-plugin-windows-notify

Pi Windows notification plugin - sends notifications on task completion and user confirmation needed, with AFK mode to notify only when away from window

Packages

Package details

extension

Install @xiaoso/pi-plugin-windows-notify from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@xiaoso/pi-plugin-windows-notify
Package
@xiaoso/pi-plugin-windows-notify
Version
0.0.2
Published
May 22, 2026
Downloads
not available
Author
xiaoso
License
MIT
Types
extension
Size
37.6 KB
Dependencies
2 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

English | 简体中文

pi-windows-tip

一个 pi 扩展，在任务完成、失败或需要你确认时发送 Windows 桌面通知——让你可以离开工位，Pi 需要你时再回来。

⚠️ 仅限 Windows — 本扩展使用 Windows 专用 API，无法在其他平台运行。

同时兼容 Pi 和 OMP (Oh My Pi)。

功能

  • 任务完成 / 失败 / 需要确认时发送通知
  • AFK 模式——仅在你离开 Pi 窗口时通知
  • 最小任务时长过滤（跳过过短任务）
  • 7 种语言（en, zh-CN, ja, ko, es, fr, ru）——自动检测系统语言
  • 设置跨会话持久化

安装

Pi:

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

OMP:

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

或从 Git 安装：

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

命令

/notify    — 打开通知设置

设置

设置项 可选值 说明
Enabled on / off 总开关
Notify Mode afk / all afk：仅离开窗口时通知；all：始终通知
Language en / zh-CN / ja / ko / es / fr / ru 显示语言

配置文件 (Pi)：~/.pi/agent/pi-windows-tip-config.json 配置文件 (OMP)：~/.omp/agent/pi-windows-tip-config.json

工作原理

监听 Pi 生命周期事件，通过 node-notifier 发送通知。AFK 模式下，使用 active-win 检测当前前台窗口是否仍为 Pi——如果你正在看 Pi，则抑制通知。

许可证

MIT