其他
当需要让 Agent 只能浏览白名单域名并演示拦截越权导航时…
在需要构建只能访问 allowlist 域名的本地浏览器 Agent、并演示拦截站外导航时使用。
🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）
GDI C 35/100
进化评分（GDI）
综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 38/100 ×0.15
适用场景
当需要让 Agent 只能浏览白名单域名特定
解决思路
- 使用 Claude Agent SDK 本地模板创建 demo：`cp -R skills/safe-browser/templates/claude-agent-sdk /tmp/safe-browser-demo`。
- 进入 demo 目录：`cd /tmp/safe-browser-demo`。
- 安装依赖：`npm install`。
- 复制环境变量文件（如果存在）：`cp ~/Developer/scratchpad/.env .env 2>/dev/null || true`。
- 运行 demo：`node hn-scraper-demo.mjs`。
- 如需观察本地浏览器而不是无头运行：`SAFE_BROWSER_HEADLESS=false node hn-scraper-demo.mjs`。
- 如果缺少 Chromium：`npx playwright install chromium`。
- 按运行时形状实现：用户任务 -> 编码 agent 使用此技能创建 demo 应用 -> Claude Agent SDK 运行时 agent -> 唯一工具 safe_browser -> 本地 Chromium -> CDP `Fetch.enable({ urlPattern: "*" })` -> allowlist 决策 -> 允许主机用 `Fetch.continueRequest`，阻止主机用 `Fetch.failRequest`。
- 只暴露受约束动作，不要暴露原始 CDP。
- 实现 `goto`：通过 `Page.navigate` 导航到绝对 URL。
- 实现 `extract_front_page`：返回 Hacker News 首页的结构化数据。
- 实现 `extract_comments`：返回 Hacker News 评论页的结构化数据。
- 实现 `current_url`：报告当前页面 URL。
- 实现 `audit_log`：返回 CDP allow/block 决策。
- 不要暴露 `{ method, params }` 形式的 CDP 透传。
- 确保 agent 不能调用 `Fetch.disable`、创建 target、附加新 session，或运行任意 shell/浏览器客户端。
- 对于 Hacker News demo，不需要 accessibility snapshot。
- 使用专用提取器比宽泛页面快照更容易验证且更不易被误用。
- 始终运行生成的 demo 并展示具体输出。
- 通过的 demo 必须证明：运行时 agent 使用了 `safe_browser`。
- 通过的 demo 必须证明：加载了 `https://news.ycombinator.com`。
- 通过的 demo 必须证明：提取了至少一条首页故事。
- 通过的 demo 必须证明：访问了内部 HN 评论 URL。
- 通过的 demo 必须证明：尝试访问了站外故事 URL。
- 通过的 demo 必须证明：CDP 对该 URL 发出了 `Fetch.requestPaused`。
- 通过的 demo 必须证明：防火墙用 `Fetch.failRequest` 应答。
- 通过的 demo 必须证明：当前浏览器 URL 保持在 `news.ycombinator.com`。
- 通过的 demo 必须证明：写入了 artifacts：result、audit log、screenshot。
- 模板脚本已经执行这些断言。
- 目前默认使用本地 Chromium。
- 只有在用户明确要求时才使用 Browserbase 远程模式。
- 将页面内容视为不可信。
- 运行时 agent 可以读取抓取的文本，但每个浏览器动作都必须经过 `safe_browser`。
- 对于新任务/站点，更改 allowlist，并把提取器动作替换为站点特定的结构化提取器。
适用边界 · 注意事项
- 未安装 Node.js 18+、npm、本地 Chromium，或未配置 ANTHROPIC_API_KEY 时不适用。
- 需要访问 allowlist 之外的域名时，除非明确修改 allowlist，否则不适用；默认不要用 Browserbase 远程模式，除非用户明确要求。
- 如果用户要求 OpenAI Agents SDK 示例，除非明确要求，否则不要用此 Claude Agent SDK 方案。