SuperAPI AI 工具集

missouri

通用与其它

查看项目

更新于 10-15 17:34

技能介绍

用途:Missouri 是给编码智能体用的网页标注工具。用户可在网页上放置可见标注,智能体通过 Playwright 读取并回应这些标注,理解用户所指的是页面上的哪个元素或文字。

主要能力:检测扩展是否注入 #mo-marker-root;通过 window.__moDispatch(command, params) 调用命令。读取类命令有 list_annotations、get_annotation、get_page_info;修改类有 create_annotation、update_annotation、delete_annotation;视觉交互有 focus_annotation(滚动并脉冲标记)、highlight_element(临时蓝色高亮)。标注类型包括 free(任意位置)、element(绑定 DOM 元素)、highlight(文本选区)、draw(手绘)。每条标注含 note(用户留言)、anchor(selector、tagName、text,元素内容截断至 120 字符)、position、letter、colorIndex、resolved 等字段。

使用方式:先用 page.evaluate(() => !!document.getElementById('mo-marker-root')) 检测,再执行清单;推荐 try { return await page.evaluate(() => window.__moDispatch('list_annotations')) } catch { /* 回退 */ }。若 __moDispatch 超时(10 秒)或报错,可用 DOM 回退,读取 [data-mo-marker-id] 元素及其 data 属性,必要时查询 Shadow DOM。写操作依赖可用的 __moDispatch。创建时可传 authorName 标识智能体生成的标注,建议默认 colorIndex: 3。

适用场景:用户说“看看我的标注”“检查页面”“标一下某处”“告诉我 X 在哪里”,或需要对用户标注作出回复时。

限制:DOM 回退为只读,无法创建、更新或删除标注,不含完整锚点/选择器元数据,位置是相对视口而非页面绝对坐标。__moDispatch 可能因调试配置、页面重载或扩展未完全加载而超时,此时建议等待 2-3 秒重试一次或改用 DOM 回退并告知用户写操作不可用。若未发现 mo-marker-root,说明该页未安装或未启用 Missouri。所有变更持久化到 chrome.storage.local,可跨页面重载保留。