{"skill":{"slug":"realtime-interact-overlay","displayName":"realtime-interact-overlay","summary":"实时交互浮窗技能。在需要用户确认、输入或交互的场景中，通过浮窗方式在当前操作界面旁边进行交互， 而不是回到OpenClaw聊天窗口。适用于：(1) 评论内容需要用户确认后执行，(2) 删除文件前需要用户确认， (3) 购物付款时需要输入密码，(4) 任何需要即时交互的场景。支持系统级浮窗和浏览器内浮窗。","description":"---\nname: realtime-interact\ndescription: |\n  实时交互浮窗技能。在需要用户确认、输入或交互的场景中，通过浮窗方式在当前操作界面旁边进行交互，\n  而不是回到OpenClaw聊天窗口。适用于：(1) 评论内容需要用户确认后执行，(2) 删除文件前需要用户确认，\n  (3) 购物付款时需要输入密码，(4) 任何需要即时交互的场景。支持系统级浮窗和浏览器内浮窗。\nmetadata:\n  version: \"1.0.0\"\n  author: \"liuyong74\"\n---\n\n# Realtime Interact - 实时交互浮窗\n\n在用户当前操作界面旁边弹出浮窗进行交互，提供流畅的确认/输入体验。\n\n## 快速开始\n\n### 浮窗类型\n\n| 场景 | 使用方式 |\n|------|---------|\n| 确认框（是/否） | `interact.confirm(title, message)` |\n| 输入框 | `interact.input(title, message, default)` |\n| 选择框 | `interact.select(title, options)` |\n| 自定义HTML | `interact.html(title, html_content)` |\n\n### 基础示例\n\n**1. 评论前确认**\n```\n用户：帮我评论这条朋友圈\n\nAI：准备评论内容后，调用浮窗确认\n→ 浮窗弹出：显示\"写的评论内容\"\n→ 用户点击\"确认\"\n→ AI执行评论\n```\n\n**2. 删除文件确认**\n```\n用户：帮我删除这个文件\n\nAI：准备删除操作后，调用浮窗确认\n→ 系统浮窗弹出：\"确定删除 xxx 吗？\"\n→ 用户点击\"确认删除\"\n→ AI执行删除\n```\n\n**3. 密码输入**\n```\n用户：帮我完成支付\n\nAI：准备支付后，调用输入框\n→ 浮窗弹出：密码输入框\n→ 用户输入密码\n→ AI执行支付\n```\n\n## 技术实现\n\n### 方式一：macOS 系统浮窗（本地操作）\n\n适用于：删除文件、执行命令等本地操作\n\n```bash\npython3 ~/.openclaw/skills/realtime-interact-1.0.0/scripts/macos_dialog.py \\\n  --type confirm \\\n  --title \"确认删除\" \\\n  --message \"确定要删除文件 /path/to/file 吗？\"\n```\n\n**参数：**\n- `--type`: confirm | input | select\n- `--title`: 浮窗标题\n- `--message`: 浮窗内容\n- `--default`: 默认值（input类型需要）\n- `--options`: 选项（select类型需要，用逗号分隔）\n\n### 方式二：浏览器内浮窗（网页操作）\n\n适用于：网页评论、购物等浏览器内操作\n\n```bash\n# 在当前浏览器页面注入浮窗\npython3 ~/.openclaw/skills/realtime-interact-1.0.0/scripts/browser_modal.py \\\n  --action show \\\n  --type confirm \\\n  --title \"评论确认\" \\\n  --message \"确认发送这条评论吗？\"\n```\n\n### 方式三：Canvas 覆盖层（通用）\n\n使用 OpenClaw canvas 绘制覆盖层：\n\n```javascript\n// 通过 JavaScript 注入创建浮窗\n// 见 scripts/inject_modal.js\n```\n\n## 浮窗样式\n\n浮窗采用现代美观设计：\n- 🎨 毛玻璃效果背景\n- 📐 居中弹出，带阴影\n- 🔘 圆角按钮\n- ✨ 流畅动画过渡\n\n## 交互流程\n\n```\n1. 用户发起请求（如：评论朋友圈）\n2. AI 准备交互内容（评论文案、操作指令等）\n3. 判断场景类型：\n   - 本地操作 → macOS 浮窗\n   - 浏览器操作 → 浏览器内浮窗\n   - 不确定 → 优先浏览器浮窗\n4. 弹出浮窗展示内容\n5. 用户确认/输入\n6. 返回结果给 AI\n7. AI 执行实际操作\n8. 反馈结果给用户\n```\n\n## 错误处理\n\n- 用户取消：返回 `{\"result\": \"cancel\"}`\n- 超时（默认60秒）：返回 `{\"result\": \"timeout\"}`\n- 执行失败：返回 `{\"result\": \"error\", \"message\": \"...\"}`\n\n## 扩展功能\n\n### 语音交互（未来）\n\n计划支持：\n- 语音输入\n- 语音确认（\"好的\"、\"确认\"）\n- 语音播报结果\n\n---\n\n**注意**：首次使用需要授权 macOS 辅助功能权限（系统偏好设置 → 安全性与隐私 → 辅助功能）\n","topics":["购物"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":920,"installsAllTime":34,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772098393641,"updatedAt":1779077369175},"latestVersion":{"version":"1.0.0","createdAt":1772098393641,"changelog":"实时交互浮窗技能。在需要用户确认、输入或交互的场景中，通过浮窗方式在当前操作界面旁边进行交互，\n  而不是回到OpenClaw聊天窗口。适用于：(1) 评论内容需要用户确认后执行，(2) 删除文件前需要用户确认，\n  (3) 购物付款时需要输入密码，(4) 任何需要即时交互的场景。支持系统级浮窗和浏览器内浮窗。","license":null},"metadata":null,"owner":{"handle":"lightcastlepro","userId":"s17cbax7jdh47vr0snff9pm6cx88432y","displayName":"LightCastlePro","image":"https://avatars.githubusercontent.com/u/18499297?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779961778733}}