Skip to content

SKILL.md

Latest commit

 

History

History
87 lines (66 loc) · 3.93 KB

SKILL.md

File metadata and controls

87 lines (66 loc) · 3.93 KB
Raw
name ganhuo-adspower-budianji
description 通过 AdsPower LocalAPI 对指定环境号并行执行授权的链接可达性与重复稳定性测试。用户提到 AdsPower 补点击、重复打开链接、长链接测试、一个环境同时打开多个链接、按轮启动关闭环境或考核链接能否稳定打开时，都应使用本技能；先检测 LocalAPI，再按“同轮链接并行打开、全部关闭并关闭环境才算一轮”的规则执行和留存报告。
compatibility Requires Node.js 18+, AdsPower LocalAPI, and Playwright available locally.
metadata
short-description
AdsPower 多链接按轮可达性与稳定性测试

AdsPower 补点击稳定性测试

本技能用于用户有权测试的链接可达性和重复稳定性。同一轮的链接全部并行处理，使一轮耗时接近最慢链接的加载时间加 30 秒，而不是链接数量乘以等待时间。本技能不用于伪造流量、广告互动或归因数据。

必要输入

  • AdsPower 环境号，例如 1001
  • 一个或多个完整的 http:// 或 https:// 链接，保持原文不变
  • 正整数轮数

缺少其中任一项才询问用户。不要把多个链接合并、去重或改写。

执行规则

  1. 先运行 dry-run。脚本会优先探测 http://127.0.0.1:50325，再探测 50326；也可用 ADSPOWER_API 或 --api 指定地址。
  2. LocalAPI 不可用时立即停止，不启动环境、不访问链接，并提示用户启动 AdsPower、启用 LocalAPI 后重试。
  3. 按环境号的 serial_number 精确查找。找不到或匹配不唯一时停止。
  4. 若目标环境已处于 Active，停止并提示用户先关闭现有会话，避免误关用户正在使用的浏览器。
  5. 用户已明确授权执行测试时，在 dry-run 通过后加 --execute 执行，不重复索要确认。
  6. 每轮严格执行：启动环境 → 同时为全部链接新建页面并并发导航 → 每个页面基本加载后等待 30 秒 → 关闭全部页面 → 关闭环境 → 回读确认为 Inactive。同一轮内禁止逐条串行等待。
  7. 一轮中的全部链接都完成打开和关闭，且环境关闭已确认，才计为 completed_round；全部链接加载成功才同时计为 successful_round。
  8. 单条链接失败时记录轮次、链接序号、HTTP 状态或错误，继续完成其余链接和后续轮次，不用重试掩盖失败率。
  9. 不修改环境配置、代理、Cookie、账号资料或启动页。

命令

先解析本文件所在目录为 SKILL_DIR，所有链接都要作为独立且完整的 --url 参数传入，并正确加引号。

Dry-run：

node "$SKILL_DIR/scripts/run.mjs" \
  --profile-no 1001 \
  --rounds 10 \
  --url 'https://example.com/a?x=1' \
  --url 'https://example.com/b?x=2' \
  --dry-run \
  --json

真实测试：

node "$SKILL_DIR/scripts/run.mjs" \
  --profile-no 1001 \
  --rounds 10 \
  --url 'https://example.com/a?x=1' \
  --url 'https://example.com/b?x=2' \
  --execute \
  --json

可选参数：

  • --settle-ms 30000：每个并行页面基本加载后的停留时间，默认 30000 毫秒
  • --navigation-timeout-ms 30000：单链接超时，默认 30000 毫秒
  • --between-rounds-ms 1500：轮次间隔，默认 1500 毫秒
  • --report-dir /path：报告目录，默认当前目录下 .adspower-safe-reports
  • ADSPOWER_API_KEY：LocalAPI 开启鉴权时从环境变量读取，禁止把密钥写入命令参数或报告

输出

最后简洁报告：

  • LocalAPI 是否连接、实际 API 地址
  • 环境号、环境名
  • 请求轮数、链接数、计划导航次数
  • 链接执行模式 parallel_per_round 和每轮并行标签页数
  • 完整轮数、成功轮数、失败轮数
  • 每个失败项的轮次和链接序号
  • JSON 报告绝对路径

报告只保存脱敏 URL 与哈希，不保存查询参数值、账号密码、Cookie、代理凭据或 API Key。

自检

node "$SKILL_DIR/scripts/run.mjs" --self-test