Notify 通知浮层
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c9b69df4/notify-overlay。
技能介绍
要解决什么问题
Agent 或脚本跑多步骤流水线(构建、测试、同步)时,终端日志容易被淹没,用户也很难同时盯着消息流和待办清单。NotifyOverlay 在项目根目录挂一个 PySide6 桌面浮层,把状态与待办从 CLI 推到独立窗口,长任务不必反复切终端。
如何工作
技能约定在含 .opencode/ 的项目根执行。浮层进程与调用方通过临时文件做 IPC:
.opencode/temp/notify.json— 状态消息.opencode/temp/notify-todos.json— 待办(格式{"todos": [{"text", "done", "t"}]}).opencode/temp/notify.pid— 进程标识
典型长任务流程:后台启动浮层 → --status 确认在线 → 每步 --push 文案 → 结束 --stop。待办用 --push-todo 追加,在窗口内点击可切换完成态;也可用 --clear、--clear-todos、--toggle-stats 等维护界面。
后台常驻需一次性指定带 PySide6 的 python.exe(--set-python);纯 CLI 的 stop / status / push 可不配。
边界与注意
- 所有路径与 IPC 文件都绑定当前项目根,换目录即另一套实例。
- 从
TODO.md等来源同步待办时,调用方应先去掉已完成项(- [x]),只推未完成;内置逻辑会跳过空行、已完成标记和重复项,但上游过滤更稳。 - 浮层依赖 PySide6 与本地 GUI 环境,适合本机开发/自动化场景,不是远程无头服务的通用通知方案。
使用场景
- 本地执行多阶段构建或测试脚本时,在独立浮层里查看当前步骤,而不必一直滚动终端输出。
- Agent 或脚本在后台做同步、校验等连续操作时,每完成一步用 `--push` 写入一条可读状态。
- 长任务进行中需要同时看消息流与待办:用 `--push-todo` 追加事项,在窗口内点击切换完成状态。
- 从项目根启动浮层并用 `--status` 确认在线后,按流水线逐步 `--push`,全部结束再 `--stop` 收尾。
适合人员
- 在本机 `.opencode/` 项目里跑 Agent 多步流水线、希望有单独窗口跟踪进度的工程师。
- 负责编写 build/test/sync 自动化脚本、要把步骤进度从日志改成用户可见推送的后端或 DevOps。
- 协作中让 AI 维护 TODO.md,并需把未完成项同步到可点击勾选的浮层待办列表的开发者。
- 在 Windows 上用 conda 指定 PySide6 的 Python、以后台进程常驻浮层的本地自动化使用者。