configure-pi-notifications skillA
configure-pi-notifications is agent-read markdown (skill) from maplezzk/pi-extensions: 配置与排查 pi-notifications 的外部通知命令、argv 参数、超时和一次性失败提示。Use when configuring or diagnosing Pi external notifications..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# 配置 pi-notifications
## 配置文件
读取实际 Pi agent 目录下的 `extensions/pi-notifications/config.json`。不存在时使用内置默认配置；不要猜测未列出的字段。可以从包内 `config.example.json` 开始。
配置字段：
- `enabled`：布尔值，默认 `true`。
- `adapter.command`：通知可执行文件名或路径，默认 `terminal-notifier`。
- `adapter.args`：argv 字符串数组；支持 `{title}`、`{subtitle}`、`{message}` 占位符。
- `timeoutMs`：正整数，默认 `3000`。
修改配置后执行 `/reload`。配置文件损坏会明确提示，并使用默认配置继续启动。
使用 `/config:notifications` 在 TUI 中修改完整通知配置，输入 `reset` 恢复默认值。保存后执行 `/reload`。
Use `/config:notifications` to edit the complete notification configuration in the TUI, use `reset` for defaults, and run `/reload` after saving.
## 运行行为
- `ask_user_question` 和 `ask_user` 在真正等待输入前发送通知。
- `agent_end` 发送完成通知，并根据 tool result 是否报错选择完成或错误标题；消息包含 turn 数和耗时。
- 命令通过 argv 执行，不经过 shell；不要把整条 shell 命令写入 `adapter.args`。
- 扩展加载时不依赖外部命令存在；第一次发送通知时探测命令。
- 命令缺失或第一次执行失败只提示一次，并停用当前运行的外部通知；Pi 任务继续执行，不要重试或阻塞。
- 运行时文案语言由 `pi-extensions-i18n` 控制。
## 排查
1. 检查配置文件的 JSON、`enabled`、命令和 argv 参数类型。
2. 在当前 Pi 进程的 `PATH` 中确认配置的命令可执行。
3. 如果看到一次“命令不可用”或“执行失败”提示，先修复命令或配置，再执行 `/reload`。
4. 不要读取凭据、Pi settings 或私有服务来排查通知 adapter。
## 验证
- 定向测试：`npm test --workspace pi-notifications`。
- 类型检查：`npm run typecheck --workspace pi-notifications`。
…Read the whole file at its exact version.
How to install
mdr add maplezzk/pi-extensions/configure-pi-notifications@git:20260907.3bd68afmdr add maplezzk/pi-extensions/configure-pi-notifications@sha256:d397b3becde93863Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_jkginzlo7vsx7ojg)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260907.3bd68af latest | 2026-09-07 | 3bd68af | 2,531 B | A | view · diff |
| git:20260906.5bc2191 | 2026-09-06 | 5bc2191 | 2,636 B | A | view · diff |
| git:20260905.1bba7c7 | 2026-09-05 | 1bba7c7 | 2,252 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (2531 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
maplezzk/pi-extensions · 12 stars · license MIT · pushed 2026-09-22 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_jkginzlo7vsx7ojg GET https://markdownregistry.com/api/v1/resolve?ref=maplezzk/pi-extensions/configure-pi-notifications GET https://markdownregistry.com/api/v1/blob/d397b3becde93863477384df35454cd390b2988b9110967a3634cb6838241987
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.