mirror of
https://github.com/NCBM/plyngent.git
synced 2026-11-07 23:47:54 +08:00
docs: describe the notification that stays and the answers it offers
The table of what a notification answers was out of date: the limit prompt and the batch confirm now offer their own answers, and a skill write distinguishes "once" from "this chat". The desktop section now says what actually keeps the notification up (no expiry, urgency at the default) instead of naming `critical`, and the follow-up rule — announced at once, past the grace period — is written where a reader looks for why a prompt appeared without waiting.
This commit is contained in:
@@ -45,13 +45,15 @@
|
||||
# Notifications while a prompt waits on the human: a tool confirmation, a
|
||||
# directory-access grant, a skill write, an ``ask_user_*`` question, or the
|
||||
# limit-continue prompt. A prompt is announced only after `grace_seconds` of
|
||||
# waiting, so one you answer at the terminal stays silent; `min_interval_seconds`
|
||||
# throttles bursts.
|
||||
# waiting, so one you answer at the terminal stays silent — except a prompt that
|
||||
# follows an answer given on the notification, which is announced at once;
|
||||
# `min_interval_seconds` throttles bursts.
|
||||
# channels: "auto" tries the desktop first (needs the `notify` extra:
|
||||
# `pip install plyngent[notify]`) and falls back to a terminal escape sequence;
|
||||
# "desktop" / "terminal" pin one of them.
|
||||
# `actions` offers allow / deny / review as notification buttons; where the
|
||||
# platform has none the notification stays text-only.
|
||||
# `actions` offers the answers the prompt accepts as notification buttons (allow /
|
||||
# deny / review when it names none); where the platform has none the notification
|
||||
# stays text-only.
|
||||
# `include_reason` adds the one-line reason — it can name a command or a URL, so
|
||||
# it stays off by default (a notification may be mirrored to a lock screen).
|
||||
# [notify]
|
||||
|
||||
Reference in New Issue
Block a user