跳到正文

用标注提供反馈

让网页反馈有明确目标,并了解网站批注扩展的接入边界。

内置批注与网站扩展

Lime 的内置浏览器可以把元素、区域或文本选择作为批注上下文。你可以指出要修改的内容并补充说明,智能体据此定位和验证。网站无需加入专有属性才能使用这种内置选择。

当前没有对网站公开的自定义批注控件注册、画布表面注册或页面脚本主动打开批注 API。不要把其他浏览器的命名空间替换为 Lime 后直接调用。

批注目标与扩展边界 · Lime 界面与流程示意

选择反馈目标

目标适合场景
元素指出按钮、表格、图片或一个具体控件。
文本指出一句话、一个短语或表单文字。
区域说明页面布局、间距或多个元素之间的关系。

先选择能独立说明问题的最小范围。补充期望变化和成功条件,例如“保持这行高度,只缩小左侧空白”,比“这里不好看”更容易实施。

文本与元素定位

批注会关联当前页面、标签页与任务身份,并保存选择位置、页面标题、路径或文本等上下文。文本选择可能使用 DOM 范围或表单控件范围;它不等同于页面全部内容。

页面更新、导航或重新布局后,原选择可能过期。遇到 stale、捕获失败或超时,重新打开当前页面选择目标,不继续使用旧坐标操作。

提交前核对

  1. 确认当前页面与任务是预期目标。
  2. 检查高亮范围、选中文字和截图。
  3. 写明期望变化与应保留的行为。
  4. 移除无关个人信息和敏感内容。
  5. 发送后让 Lime 先复述目标,再检查实际实现。

为普通网页提供清晰结构

使用有语义的 HTML、可访问名称和稳定的业务文本,帮助用户和智能体区分相邻控件。将表格、卡片、标题与操作组织成清晰区域;不需要发明专有批注属性。

html
<section aria-labelledby="report-title">
  <h2 id="report-title">月度报告</h2>
  <p>统计范围:本月</p>
  <button type="button" aria-label="导出月度报告">导出</button>
</section>

预览与自定义控件

颜色、间距、选项和设计变量的实时预览应由网站现有界面实现。可以把用户选定值和期望结果写进批注,但 Lime 不会自动注册网站的滑块、下拉框或 reset 回调。

网站自身预览与最终保存应分开,取消预览要恢复原值。任何提交、删除或外部发送仍需要网站的正式验证和授权。

画布与对象

画布对象不一定具有独立 DOM。需要反馈时使用区域批注,并附上对象名称、图层、坐标或应用中的稳定标识。Lime 当前没有向网站开放 hitTest、getContext 或自定义对象高亮注册接口。

为画布提供可访问的对象列表、文本替代或普通详情面板,可帮助定位对象,也能保留不支持专有扩展的浏览器体验。

验证反馈闭环

  1. 确认智能体定位的是同一个页面与对象。
  2. 实施后检查实际页面、文本与交互。
  3. 对照原批注验证期望变化。
  4. 页面状态改变时重新取证,不以旧截图代替当前结果。