SuperAPI AI 工具集

browser-work

通用与其它

查看项目

更新于 10-16 06:14

技能介绍

用途:让代理可靠地代为执行浏览器任务。核心思路是侦察优先(explore → document → delegate):编排者先亲自走一遍站点、记录坑点,形成指南文件,再委派给浏览器代理执行。

主要能力与流程: 第0步环境准备:初始化会话目录,解析 chromux 路径(命令缺失则报错停止),以 headless 模式启动 Chrome,用 openssl rand -hex 2 生成会话 ID(如 exp-ab12),可用 show 在浏览器中打开实时标签页(如 chromux show exp-ab12)。 第1步评估复杂度:单页且点击少、知名站点可跳过侦察直接委派;多步骤、不熟悉站点、3 次以上交互需侦察;动态内容、登录流程、分页、对机器人敏感站点需详细侦察并加注意项。跳过侦察也需建最小指南文件。 第2步侦察:编排者直接用 chromux 导航、快照、走完整个工作流,记录元素 @ref 编号变化、弹窗、模态框、登录墙、无限滚动、动态加载等障碍;注意机器人检测,操作间加 wait 2000,避免快速重复同一动作,遇验证码或限流则停止并记录。 第3步写指南:保存到 $WORK_DIR/guide.md,含任务、目标 URL、站点特征、工作流步骤、坑点与洞见、机器人检测说明。 第4步委派:以子代理 hoyeon:browser-explorer 执行,提示词附上指南全文与执行规则(保守操作、加等待、不符则重新快照适配、遇验证码停止、结束关闭会话);独立子任务可并行开多个代理各占一个标签页。 第5步汇报:总结完成情况与失败项,并把新洞见回写指南。

运行环境:Claude Code 使用 UserPromptSubmit 钩子提供的 CLAUDE_SESSION_ID 作为 ~/.hoyeon/{session}/ 路径并委派逻辑浏览器代理;Codex 走 Bash 优先的 chromux,不加 Hoyeon MCP,无钩子会话 ID 时用 date +%Y%m%d-%H%M%S 生成并存到 $HOME/.hoyeon/codex-browser-$RUN_ID/,映射到适配器 hoyeon-browser-explorer,未加载适配器则用 chromux 完成最小安全操作并说明回退;仅当用户明确要求 Codex 应用内浏览器行为时才用 Browser Use 插件,本技能的标准浏览器运行时是 chromux。

限制与错误处理:chromux 缺失需先安装(npm i -g @team-attention/chromux);需登录时检查 chromux 配置是否已有登录态,否则让用户手动登录;侦察中遇验证码应停止并记入指南;代理照指南仍失败可带修正重启或更详细重侦察;任务过于复杂则拆分子任务。指南文件保留在 ~/.hoyeon/{sid}/,不自动清理。关于收费、价格等信息,资料暂未提供。