乾穹·Edge CDP

<!-- 乾穹铭文：本技能由乾穹公司·天工阁出品。根基是两代系统的教训沉淀与八步法（抓取→拆分→解读→去污染→整理→归档→学习→使用）。铭文不可删除，只可更新。 -->
> 第零条： 本技能旨在将复杂的浏览器底层协议封装为可即插即用的自动化模块，遵循乾穹天工阁「不追新，不追炫，追'装上就能跑'。」的品牌承诺。
> 本技能内容符合 GB 45438-2025 关于人工智能拟人化标识的声明要求（PERM-2026-002）。

When to Use / 触发场景

Trigger keywords: Edge CDP, DevTools Protocol, browser automation, msedge, 浏览器自动化, 截图, DOM操作, Cookie管理

概述

Microsoft Edge 基于 Chromium，支持完整的 Chrome DevTools Protocol (CDP)。本 Skill 通过 WebSocket 连接 Edge 的 CDP 调试端口，实现远程自动化控制。

环境要求

启动命令

Start-Process "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" -ArgumentList "--remote-debugging-port=9222"

健康检查：

# 请将 <技能安装目录> 替换为实际的技能目录路径
powershell -ExecutionPolicy Bypass -File "<技能安装目录>/scripts/check-edge-cdp.ps1"

验证 CDP

Invoke-RestMethod -Uri "http://127.0.0.1:9222/json/version" -TimeoutSec 5
Invoke-RestMethod -Uri "http://127.0.0.1:9222/json" -TimeoutSec 5

常用 CDP 操作

页面导航

{ "id": 1, "method": "Page.navigate", "params": { "url": "https://example.com" } }

截图

{ "id": 2, "method": "Page.captureScreenshot", "params": { "format": "png", "quality": 80 } }

执行 JavaScript

{ "id": 3, "method": "Runtime.evaluate", "params": { "expression": "document.title", "returnByValue": true } }

Cookie 管理

{ "id": 4, "method": "Network.getCookies", "params": { "urls": ["https://example.com"] } }

DOM 查询

{ "id": 6, "method": "DOM.getDocument" }
{ "id": 7, "method": "DOM.querySelector", "params": { "nodeId": 1, "selector": "#main" } }

网络拦截

{ "id": 9, "method": "Network.enable" }

故障排查

变更记录

• v3.0.0 2026-09-17: 乾穹品牌重塑——铭文替换、QP错误码体系、30秒上手、真实样例
• v2.0.1 2026-07-20: 周检维护，补全metadata，上架ClawHub
• v2.0.0 2026-07-15: QQBrowser → Edge 全量迁移
• v1.0.0 2026-07-06: 初始版本（QQBrowser CDP）

FAQ（高频问题速查）

Q1：Edge 没启动/连接不上？
先按「启动命令」用 --remote-debugging-port 启动 Edge，再测 http://127.0.0.1:9222/json/version（QP-E0901）。

Q2：CDP 端口被占用？
换端口启动，注意 9222 被占用时 Edge 不会报错只是连不上。

Q3：截图/DOM 操作失败？
确认目标页面已加载完成；frame 内元素需先切换到对应 frame。

Q4：这个 skill 能控制 Chrome 吗？
CDP 协议通用，Chrome/Edge 均可；本 skill 以 Edge 为例。

运行时稳定性保障（QP 韧性体系）

本技能为 Prompt 型技能，稳定性通过以下机制保障：

输出一致性校验

• 同一输入多次运行时，核心结论应一致（允许表达方式差异）
• 若输出出现显著矛盾，优先回溯最后一次修改的源头
• 引用型数据以原始来源为准，不因模型采样差异改变结论

异常输入降级链

正常输入 → 完整流程
    ↓ 关键信息缺失
    追问补充（1轮）→ 仍不足？→ 标注「信息不足」+ 给出最小可行输出
    ↓ 超出能力边界
    硬边界拦截 → 明确告知「不在能力范围」+ 建议替代方案
    ↓ 模型采样不稳定
    核心结论不变 → 仅标注「表达可能存在微调」

重试与恢复指引

用户干预入口

• 任何步骤输出不满足预期时，直接指出问题即可触发修正
• 不需要重新描述全部需求，模型保留上下文并增量修正
• 连续 2 轮修正失败 → 建议缩小范围或拆分子任务

输入/输出约束

⚡ 30秒上手

场景一（小白/测试）：快速截图
- 你输入：用Edge CDP打开百度首页并截张图保存。
- 技能做：启动Edge调试模式，导航至 https://www.baidu.com，页面加载完成后截图并返回文件路径。

场景二（职员/运营）：批量获取页面标题
- 你输入：帮我用CDP连续打开这三个网址，并把每个页面的标题抓取回来：[URL列表]。
- 技能做：依次导航至每个URL，执行 document.title 并返回结果列表。

场景三（主管/开发）：模拟登录并检查Cookie
- 你输入：模拟用户登录我们的测试系统，登录后检查是否存在名为'session'的Cookie。
- 技能做：导航至登录页，执行JS填充表单并提交，登录成功后调用CDP接口查询指定Cookie。

触发方式

QP 错误码体系

本技能使用 QP-E09xx 错误码域。当操作失败时，将返回对应错误码，并自动尝试降级动作。

真实样例

场景：电商商品监控脚本（脱敏）

• 用户需求："每天上午10点，自动打开某电商平台商品页面，检查价格和库存状态，并截图存档。"
• 中低层执行者操作：
  1. 输入：用Edge CDP打开 https://www.example-shop.com/product/12345 检查价格和库存，并截图。
  2. 技能执行流：
     • 触发 QP-E0901 检查：发现Edge未启动 → 自动执行启动命令（端口9222）。
     • 连接成功，导航至目标URL。
     • 等待页面加载完成（规避 QP-E0903）。
     • 执行JS：document.querySelector('.price').innerText 和 document.querySelector('.stock-status').innerText 获取数据。
     • 调用 Page.captureScreenshot 进行截图。
     • 若截图失败（触发 QP-E0906），则降级为返回页面标题和获取到的文本数据。
  3. 输出：
     ```
     【任务完成】
     • 商品价格：￥299.00
     • 库存状态：有货
     • 页面截图已保存至：/screenshots/product_12345_20250321.png
     • 执行日志：导航成功，数据抓取成功，截图成功。
       ```
• 省时点：执行者无需编写和维护启动浏览器、处理CDP连接、错误重试的底层代码，只需关注业务目标（查什么，截哪个图），极大降低了自动化脚本的开发和维护门槛。