annotation-feedback-wait

标注反馈等待（Annotation Feedback Wait）

何时用

需要用户通过 Annotation Overlay 在浏览器标注页面反馈、并等待其提交时。典型场景：视觉设计评审、UI 问题反馈、页面缺陷圈画、before/after 验证。

核心前提：annotation-overlay-mcp 是 MCP 拉取模型 —— 用户点 Submit 后数据静默落库，agent 不会自动感知。必须主动挂 watcher 或轮询 read_annotations 才能收到反馈。设计缺陷，靠流程弥补。

流程

1. 确认环境

• annotation-overlay-mcp MCP server 已连接（read_annotations / capture_page / set_annotation_mode / clear_annotations 四个工具可用）
• 用户 Chrome 已加载 Annotation Overlay 扩展（chrome://extensions → Load unpacked → extension/ 目录）
• MCP server 在 localhost:3847 健康（curl http://localhost:3847/api/health）

2. 先 clear_annotations（关键：保证读到的是这一轮的新反馈）

调 clear_annotations 清空 store。clear 在前而不是在后：这样 read_annotations 永远只返回本轮用户新提交的标注，不需要"判断哪些是残留"。也顺带清掉上一轮的 before/after 截图路径。

（要保留历史做对比就跳过此步，改用 _receivedAt 时间戳判断残留 —— 主流程不做这个。）

3. 挂后台 watcher（在请用户标注之前）

用 Monitor 工具轮询标注数量，count 变化即推送事件。不要用 Bash 的 run_in_background 起 watcher —— 它只在进程退出时通知一次，持续输出的行不会推送，submit 后 agent 感知不到（踩过）。

Monitor 的 command 每个 stdout 行都变成事件通知，所以脚本只在 count 变化时输出一行：

last=""
while true; do
  c=$(curl -s --max-time 3 http://localhost:3847/api/annotations 2>/dev/null | grep -o '"count":[0-9]*' | cut -d: -f2)
  if [ -n "$c" ]; then
    if [ -z "$last" ]; then last="$c"
    elif [ "$c" != "$last" ]; then echo "annotation count changed: $last -> $c"; last="$c"; fi
  fi
  sleep 5
done

Monitor 会一直跑到 timeout 或 TaskStop。用户 submit → count 增加 → 收到事件；agent 自己 clear_annotations → count 回落 → 也收到事件。超时后若还需等待，重启一个 Monitor。

4. 让标注工具栏出现（主流程：agent 自己的浏览器）

主入口：调 annotation-browser-launch skill —— agent 用 Playwright 拉起 chromium-956323 + 扩展 + 持久 profile，导航目标页并 activate() 显示工具栏。agent 拥有浏览器，后续刷新/截图/复验都由 agent 原生控制。

兜底（用户真实 Chrome）：若标注必须发生在用户自己的 Chrome，才用 set_annotation_mode(true)（MCP 工具，走 SW 通道，返回 {ok, enabled, tabUrl} —— 核对 tabUrl 是否是要标注的页面）。用户也可按 Ctrl+Shift+A 手动唤出/隐藏。

然后明确告诉用户：在浏览器用标注工具圈画问题区域（箭头/方框/文字/自由画/点选元素/选文字），然后点 Submit。

5. 等通知，读取

收到 watcher 通知（或用户确认已提交）后，调 read_annotations。返回结构：