cdp-page-control

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

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

• 平台：全平台
• 许可：GPL-3.0-or-later（全文见 LICENSE）

安装

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
cookies	读写 cookie
import-cookies	把日常 Chrome 的登录态复制进受控浏览器（默认预览，--yes 执行）
persist-cookies	把会话 cookie 改成持久 cookie（跨重启保登录）
targets	列出标签页
open	新开标签页
close	关闭标签页
status	浏览器状态
stop	关闭受控浏览器

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