publishport-opencli 1.0.28 → 1.0.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "publishport-opencli",
-  "version": "1.0.28",
+  "version": "1.0.30",
   "publishConfig": {
     "access": "public",
     "provenance": false

package/skills/opencli-browser/SKILL.md

@@ -176,15 +176,15 @@ Error envelope always includes `error.code` and `error.message`. Target errors (
 
 | command | notes |
 |---------|-------|
-| `browser captcha [selector] [--scale N]` | 抓验证码：整页图 + **只含验证码、放大 N 倍(默认3)的裁剪图** `crop`（存 JPEG，走命令桥回传不超时）。返回 `{selector, prompt, crop, crop_scale, crop_pad, saved, rect_css, ...}`。缺省自动探测常见点选验证码图（mocaptcha / 极验点选等），认不出就显式传 selector。 |
-| `browser captcha-click <points> [--in selector] [--crop]` | 按坐标依次点击（顺序即点击顺序），自带**人手鼠标轨迹**（过行为检测关键）。**推荐 `--crop`：坐标就是你看的那张 `crop` 图里的比例(0..1)，pad 由工具内部扣除，不用暗算 rect。** 另有 `--px`(截图设备像素)/`--css`(CSS 视口像素)。点完会回读 `after`（验证码是否还在 / 状态文字 / URL）。 |
+| `browser captcha [selector] [--scale N] [--adapter]` | 抓验证码：整页图 + **只含验证码、放大 N 倍(默认3)的裁剪图** `crop`（存 JPEG，走命令桥回传不超时）。返回 `{selector, prompt, crop, crop_scale, crop_pad, saved, rect_css, ...}`。缺省自动探测常见点选验证码图（mocaptcha / 极验点选等），认不出就显式传 selector。 |
+| `browser captcha-click <points> [--in selector] [--crop] [--adapter] [--save path]` | 按坐标依次点击（顺序即点击顺序），自带**人手鼠标轨迹**（过行为检测关键）。**推荐 `--crop`：坐标就是你看的那张 `crop` 图里的比例(0..1)，pad 由工具内部扣除，不用暗算 rect。** 另有 `--px`(截图设备像素)/`--css`(CSS 视口像素)。点完会回读 `after`（验证码是否还在 / 状态文字 / URL）。 |
 
 闭环步骤：
 
 1. `browser <s> captcha` → 拿到 `crop` 裁剪图路径 + `prompt`（要点的字和顺序）。
 2. **看图**：用 `read_local_file`（PublishPort MCP）或直接读 `crop` 图（只含验证码、已放大，认扭曲字最准）。按 `prompt` 顺序找出每个待点字，读出它**在 crop 图里的比例**(0..1，左上角为 0,0)。注意常有**干扰字**（不在 prompt 里的字），只点 prompt 列的那几个。
 3. `browser <s> captcha-click --crop --in "<selector>" "x1,y1 x2,y2 ..."` → 一次性依次点上。
-4. 看回读的 `after`：验证码消失 / URL 跳转 = 成功；仍在且 prompt 变了 = 认错刷新了要重来；仍在且 prompt 没变 = 可能漏点，补点。
+4. 用 `--save /tmp/captcha-after.png` 看点击后的截图：先核对编号和顺序，再按截图坐标点「确认」。`ok: true` 只表示点击完成；验证码消失后还须重新执行原只读查询确认恢复。仍在时先读错误提示，区分等待确认、超时、答错，不盲目补点。
 
 ```bash
 ppcli browser pub captcha --scale 4            # 存 crop 裁剪图 + 返回 prompt
@@ -192,6 +192,17 @@ ppcli browser pub captcha --scale 4            # 存 crop 裁剪图 + 返回 pro
 ppcli browser pub captcha-click --crop --in ".js-mocaptcha-img" "0.24,0.17 0.69,0.38 0.82,0.36"
 ```
 
+平台适配器弹出验证码时，必须回到原适配器会话，例如（这些命令通过 PublishPort `local_bash` 调用）：
+
+```bash
+ppcli browser site:douyin captcha --adapter --save /tmp/douyin-captcha.png
+# read_local_file 打开返回的 crop，按这次题目识别文字、顺序和坐标。
+ppcli browser site:douyin captcha-click --adapter --crop --in 'iframe[src*="/verifycenter/captcha/"]' "<x1,y1 x2,y2 x3,y3>" --save /tmp/douyin-selected.png
+# 从截图核对编号后，以相同坐标系单独点确认按钮，再检查结果。
+```
+
+`--adapter` 仅用于 `captcha` / `captcha-click`，session 必须是 `site:<平台>`，并沿用原命令的 `--profile`。它定位平台适配器原有标签，不要求用户切换当前标签或 bind。抖音跨域 iframe 会整块裁剪，包含题目、图片和确认按钮；`prompt` 可能为空，直接看 `crop` 读题。`--crop` 比例基于整张裁剪图，已经处理视口边缘、缩放和留白，不能混用页面截图坐标。显式选择器失效会报错，不会自动改点其他元素。题目刷新后必须重新截图，旧坐标不能沿用；超时可刷新新题，及时完成点选和确认。验证码操作不会自动重发原评论、点赞等写命令。
+
 提醒：验证码识别靠视觉，扭曲字**可能认错**（尤其岩石/云等低对比背景、生僻复杂字）——背景太乱认不清就点刷新按钮换一张（`.js-mocaptcha-refresh` 之类，刷新不提交、无害，多数会换到干净背景）。别短时间反复猛试同一账号（会抬高风控/被判异常），一两次不过就退回让用户手动点。
 
 ### Wait