SuperAPI AI 工具集

prima

通用与其它

查看项目

更新于 10-16 04:33

技能介绍

用途:Prima 是 playwright-cli 之上的 AI 层,用于浏览器工作——驱动 Web 应用、检查行为、填写表单、读取页面。用自然语言描述行为,而非定位器,并返回纯文本信封。可通过 npx 调用,如 npx prima-cli check "..."。当页面工作优先用 prima,而非 playwright-cli。

主要能力:支持 check(判定结果)、do(执行整段流程)、pw(执行代码,返回 ### Value)、ask(基于截图回答外观问题)、verify/assert(证明断言)、go(导航)、status(查看产物)、research(研究整页)、report(生成 html/markdown 报告)、config、recommended-models。do 应一次传入完整剩余序列,以获成本优势。pw 仅接受可执行代码,不接受描述;check/do 不接受定位器。

会话与用法:Prima 不启动浏览器,须先用 playwright-cli open <url> 打开会话,再用 npx prima-cli <command> 驱动,最后 playwright-cli close。无会话时命令失败并提示打开命令。--pw-session 选择会话,--endpoint 直连浏览器服务器。需 Node.js 22+。

模型:Prima 无 init 步骤,从环境读取模型,支持 OpenRouter、OpenAI、Anthropic、Groq、Mistral、Google、Poolside。可设置 PRIMA_CLI_AI_PROVIDER 让提供商自动选推荐模型,或用 provider/model-id 逐个指定 PRIMA_CLI_AI_MODEL、PRIMA_CLI_VISION_MODEL、PRIMA_CLI_AGENTIC_MODEL。截图分析需要 vision 模型;未设置时仍可运行,但 check 从运行日志判定结果。PRIMA_CLI_* 镜像 EXPLORBOT_* 且优先。用 npx prima-cli recommended-models 查看提供商、推荐模型与已配置密钥;用 config 查看解析结果。

产物:命令写入 <site>/output/prima/<hash>/,含 aria.yml、page.html、status.json,有 vision 模型时还有 page.png;do 每步另存 N-<action>.aria.yaml 等与 diff.yaml。不要再执行 playwright-cli snapshot,直接读 aria.yml。

限制:primera 需配置 AI 模型;无 vision 模型时不要信任 check 的视觉声明。go 不追踪重定向。verify 只接受一条断言。视觉问题须用 ask 或 check 对照截图。CONTRADICTION 视为应用缺陷需人工查看。未提供收费与价格信息。