@bflyt/pi-delivery-status0.1.0
Explicit execution handoffs, verification evidence, user actions, and opt-in next steps for Pi
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
@bflyt/pi-delivery-status — 执行交接
让 Pi 明确显示:执行结果、验证证据、未完成项、需要你做什么,以及下一步可执行任务。
安装
pi install npm:@bflyt/pi-delivery-status
随后在 Pi 中执行 /reload,或开始新会话。需要 Pi 0.87.1+、Node.js 22.19+。
如需可信的后台任务数量,同时安装:
pi install npm:pi-background-tasks
没有后台插件或查询失败时显示“未知”,不会伪装成零。状态未知时不能提交 completed 报告,其余状态仍可用。
使用
| 命令 | 用途 |
|---|---|
/delivery |
完整报告:结果、验证、限制、你的待办、下一步 |
/delivery-next |
选择下一步,仅填入输入框;你确认发送后才执行 |
/delivery refresh |
刷新后台任务快照并展示报告 |
/delivery hide / /delivery show |
隐藏或显示交接面板 |
/delivery clear |
确认后清除当前分支显示,不停止任务、不删除历史 |
/delivery help |
帮助 |
首次显示“尚无交接报告”属于正常状态。可以告诉助手:
完成任务后请调用 delivery_report,明确结果、验证、需要我做什么和下一步;不要自动执行建议的下一步。
状态与边界
completed:助手已汇报完成,无待用户操作、失败或未执行检查。partial:部分完成,必须说明限制。awaiting_user:等待你操作或验收,必须列出具体动作。blocked:存在阻塞,必须说明原因。running:还未收尾。
已汇报后继续调用工具、收到后台终态或进入新一轮工作,旧报告会标记为未更新。中断、错误、尚无报告不能被解释为完成。使用最终 agent_settled 生命周期边界,而不是把单次 agent_end 当作整体任务已结束。
报告来自助手,不是独立审计。插件不自行跑测试、不启动 shell、不自动续跑、不发布,也不会直接发送下一步指令。
后台数字只覆盖当前 Pi 进程中的 pi-background-tasks,不覆盖其他进程、任务插件或外部服务。手动启动任务后可以 /delivery refresh 更新快照。
支持 TUI 和具备 Pi Extension UI 能力的 RPC 客户端;JSON/print 模式保留报告工具和数据,不显示 TUI 面板。报告跟随当前会话分支保存。
从本地开发副本切换
如果已在 Pi 配置中加载了本插件的本地副本,先移除那个本地包配置,再安装 npm 包,避免两个版本同时注册同名工具。移除配置不会删除本地源码或历史报告。
开发与许可
开发检查命令见 English README,报告契约见 docs/report-contract.md。
MIT。