57 lines
2.1 KiB
Markdown
57 lines
2.1 KiB
Markdown
# 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`。
|