SuperAPI AI 工具集

ego-search

通用与其它

查看项目

更新于 11-16 11:17

技能介绍

ego-search 是 argo 的登录态专业搜索子技能,定位为常规检索覆盖不足时的升级手段。其双运行时由 ego lite(ego-browser)与 WebBridge(用户浏览器扩展桥)组成,二者互补,任一可用即可使用 search、fetch、act、api 功能。

【用途与升级场景】 常规 API/HTML 检索遇到以下情况时可升级到 ego-search:登录墙内容(知乎、小红书、微博、X、公众号、会员站等)拿不到正文;JS 渲染、SPA、懒加载页面可能返回空壳;反爬或 Cloudflare 保护(尽力而为,重度防护可能失败);需要翻页、加载更多、表单筛选等动态交互;搜索引擎实时 SERP 结构化提取;深嵌套 iframe 页面;已知同源 API URL 但 DOM 不全。未知 XHR 的 URL 发现不在 CLI 内,需通过 heredoc 自探或先拿到 URL 再用 api 模式。

【专业搜索模式开关】 涉及真实浏览器登录态继承,出于安全与可靠性考虑默认关闭。未开启时调用会被拒绝并提示开启命令,Agent 不得自行开启,只有用户明确表达开启意图后才运行 enable。状态持久化于 ~/.local/state/ego-search/pro-mode.json,开启后长期生效,直到手动关闭。命令:python3 sub-skills/ego-search/scripts/ego_search.py enable(开启)、disable(关闭)、status(查看状态)。

【依赖与环境】 需要浏览器运行时(macOS 应用)与运行时命令 ego-browser(位于 ~/.local/bin)。首次使用前用 command -v ego-browser 确认,未安装时按 references/install.md 完成安装。运行时依赖由安装包自管理。登录态来自运行时 onboarding(可导入 Chrome 数据),不同站点登录态由用户在运行时中维护。

【CLI 快速开始】 status [--fix] 探测运行时与专业模式,--fix 幂等启用 WebBridge 桥;search 执行浏览器态搜索(--engine bing 默认、baidu、google;--n 结果条数默认 8);fetch 做浏览器态正文提取(--focus 关键词可只返回关键词附近段落);api 进行同源接口数据直取(--origin 指定登录态上下文页面 URL,跨子域须显式指定);--task-space 可为同一目标的多轮操作复用任务空间。输出 JSON 到 stdout(机器可读),日志到 stderr。

【输出约定与登录态 provenance】 所有 search、fetch、act、api 输出均带 login_state_used=true、auth_partition=login、cache_eligible=false、search_partition=login、merge_with_public_ok=true、runtime=ego|webbridge。公共缓存库 ~/.cache/unified-search/cache.db 在入口会硬拒绝此类载荷,登录态结果默认不缓存 body。检索阶段 public 与 login 分开跑、分 cache、分 partition;汇总阶段可用 merge --public --login 将两路结果一并送入 evidence 或报告生成,用 source、runtime、search_partition 区分权重与可信语境。

【模式说明】 search 打开指定搜索引擎真实结果页并提取结构化 SERP,但 SERP 本身是检索入口而非正文证据,高后果结论必须 fetch 结果页正文后再判断。fetch 优先 article/main/[role=main] 等语义容器,回退 document.body.innerText,输出 url、title、content、word_count、fetch_method。api 先打开目标站点页面继承登录态,再用 browserFetch 从页面上下文请求同源接口,覆盖 SPA 懒加载截断、登录态私有数据、站点内 API 搜索等场景;data_type 为 json/text/error,超 100KB 截断并标记 truncated。act 把搜索、点开结果、抓正文链式动作一次跑完;更复杂的多步交互用 ego-browser nodejs heredoc。

【安全控制】 专业模式闸门默认关;URL 守卫仅允许 http(s),默认禁本机与字面私有 IP,EGO_SEARCH_STRICT_SSRF=1 启用全量 DNS,ARGO_ALLOW_PRIVATE_URLS=1 放行;ego 路径默认 completeTaskSpace keep:false 防标签堆积,--keep-space 与 --site 可保温多轮;fetch/act 输出 quality.auth_wall_suspected 与 login_likely_ok 质量信号;WebBridge 不自动 close_session 以免误关用户标签;登录态结果拒写公共缓存。登录态稳定建议:同站多轮用 --site 或 --task-space --keep-space;单次取证用默认设置;login_likely_ok=false 时在 ego App 或用户 Chrome 人工登录后重试。

【与 argo 主系统配合】 输出与 argo schema 对齐,results 可直接喂 scripts/evidence.py 做评分,正文可复用 content_signals / content_security 检查;source=ego-browser 可参与多源去重;事实类问题保持 2–3 条子查询纪律,ego-search 仅承担登录态、动态内容这一路,不替代 argo 引擎的全量召回。更多细节见 references/browser-runtime.md、references/install.md、references/original-ego-upgrade.md。