Agent Skills
返回列表
Notify 通知浮层

Notify 通知浮层

生活服务 更新于 2026.08.29

将以下提示词粘贴到你的 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、以后台进程常驻浮层的本地自动化使用者。