# cdp-page-control

驱动受控浏览器操作任意网站页面（导航、填表、点击、读文本、截图、抓网络）

以 Pi package（技能形态）发布。技能本体在 `skills/cdp-page-control/`。

- 平台：全平台
- 许可：GPL-3.0-or-later（全文见 [LICENSE](LICENSE)）

## 安装

```sh
pi install git:gitea.vhkd.top/pi-hub/cdp-page-control.git@v0.1.4
```

装完 `pi-skill list` 能看到 `cdp-page-control`，`pi-skill cdp-page-control check` 会告诉还缺什么。

## 先准备什么

- 用系统已有的东西即可，没有额外依赖。

## 常用命令

| 命令 | 说明 |
|---|---|
| `launch` | 启动/复用受控浏览器 |
| `nav` | 打开 URL / 前进 / 后退 / 刷新 |
| `snapshot` | 页面结构快照：可见交互元素 + @N 引用 |
| `wait` | 等元素/条件出现 |
| `find` | 找元素，返回定位器 |
| `click` | 点击元素 |
| `type` | 输入文本 |
| `fill` | 按 JSON 批量填表（输入/下拉/勾选） |
| `press` | 按键/组合键 |
| `drag` | 真实鼠标拖拽（含原生 HTML5 拖放） |
| `select` | 下拉选择 |
| `hover` | 悬停元素 |
| `upload` | 上传文件 |
| `insert-text` | 向焦点元素插入文本（自绘编辑器） |
| `text` | 读元素文本 |
| `html` | 读元素 HTML |
| `eval` | 在页面里执行 JS |
| `net` | 抓网络请求 |
| `console` | 读控制台消息（含历史回放与异常） |
| `shot` | 截图（整页或单个元素） |
| `pdf` | 整页导出 PDF（打印管线，一次调用拿到全部内容，不受视口限制）：pdf <out.pdf> --size WxH [--media screen|print]；要 PNG 再用 qlmanage -t -s <2*max(W,H)> 矢量重栅格 |
| `cookies` | 读写 cookie |
| `import-cookies` | 把日常 Chrome 的登录态复制进受控浏览器（默认预览，--yes 执行） |
| `persist-cookies` | 把会话 cookie 改成持久 cookie（跨重启保登录） |
| `targets` | 列出标签页 |
| `open` | 新开标签页 |
| `close` | 关闭标签页 |
| `status` | 浏览器状态 |
| `stop` | 关闭受控浏览器 |

用法与对外契约见技能内的 `SKILL.md` 与 `REFERENCE.md`。