SuperAPI AI 工具集

user-activation-contracts

通用与其它

查看项目

更新于 10-16 06:44

技能介绍

用途:排查须用户激活(user activation)才能调用的浏览器 API。这类能力的契约不是“有 click 处理器”,而是受控调用必须在激活仍有效、且未被其他 API 消耗前发生。适用于 window.open 返回 null、OAuth 弹窗在异步准备后被拦截、以及更严格浏览器下的失败。

主要能力与做法:

  • 确认具体受控 API 及所需激活类型(transient 或 sticky),不要从 UI 相似的其它能力推断。
  • 从可信用户事件到受控调用全程追踪,记录每个 await、定时器、排队任务、框架过渡与更早的受控调用,不假设激活能跨越任意异步工作或多个消耗型 API。
  • 可用时读取 navigator.userActivation.isActive 作为诊断证据,但以实际 API 结果与恢复路径为准。
  • 尽量把激活敏感步骤留在可信事件内;OAuth 弹窗需要异步构造 URL 时,可采用有界模式:同步打开具名空白窗口,异步准备后导航该窗口,准备失败则关闭。需确认符合产品安全与无障碍流程,不要为保留句柄而削弱既有 opener 或跨域隔离策略。
  • 处理拒绝、取消与 window.open() === null,保留可用的重定向/手动回退,受控操作完成前不报成功。
  • 不要用合成 click 或程序化事件绕过;不可信事件不产生用户激活。
  • 在相关浏览器族中测试真实序列,包括慢准备路径和可能暴露激活消耗的第二次快速操作。

快速探针:在处理函数内、异步前后、受控调用前记录 isActive;延迟 URL/令牌准备以稳定跨过时间边界;断言被拦截/取消路径恢复按钮、关闭空白弹窗并提供回退;多个受控操作时颠倒顺序以判断哪个调用消耗激活。

边界:OAuth 回调、返回目标、passkey 等归 frontend-auth-flow-contracts;剪贴板/导出内容与生命周期归 download-export-safety;PAN/CVV 归 payment-page-client-security;sandbox 与权限委托归 iframe-embed-contracts。

限制与提交门槛:需指出真正受控的 API、记录可信手势到调用的序列、在真实受支持浏览器复现拒绝/拦截结果。弱结论应拒绝:受控 API 之后无实际调用的通用 await、产品策略有意拦截的弹窗、由权限或不安全上下文而非激活导致的拒绝、在调用已处于有效激活时仍建议加 click 处理器。输出先给处置(confirmed、candidate/needs evidence、reject、route),再报受控 API 与激活类型、可信事件、异步/消耗边界、浏览器证据与异常、最小顺序或回退改动、兄弟技能移交、覆盖成功与拒绝的测试。具体平台、收费与价格信息暂未提供。