ISSUE-001: {Short title}【免费下载链接】agent-browserBrowser automation CLI for AI agents项目地址: https://gitcode.com/gh_mirrors/agen/agent-browserFieldValueSeveritycritical / high / medium / lowCategoryvisual / functional / ux / content / performance / console / accessibilityURL{page URL where issue was found}Repro Video{path to video, or N/A for static issues}Description{What is wrong, what was expected, and what actually happened.}Repro StepsNavigate to {URL} Step 1{Action -- e.g., click Settings in the sidebar} Step 2{Action -- e.g., type test in the search field and press Enter} Step 3Observe:{what goes wrong -- e.g., the page shows a blank white screen instead of search results} Result### 4.1 字段表可检索的缺陷元数据 - **Severity / Category**直接从分类法取值保证全仓库报告口径一致方便按严重度或类别筛选、聚合 - **URL**问题发现页面的精确地址复现的起点 - **Repro Video**复现视频路径**静态问题填 N/A**——这是模板中最关键的证据分级规则见模板中的 HTML 注释说明交互类问题需要视频 逐步截图静态问题错别字、视觉瑕疵只需一张截图。 ### 4.2 Description问题三要素 模板用注释明确要求 Description 回答三个问题**什么是错的What is wrong、预期是什么What was expected、实际发生了什么What actually happened**。这种预期 vs 实际的对比式描述正是工程缺陷单的黄金结构能显著降低研发团队的沟通成本。 ### 4.3 Repro Steps可视觉跟读的逐步复现 模板要求**每一步都附带对应截图**并强调读者应能完全不碰浏览器、仅凭截图就跟着复现一遍。步骤编号与截图文件一一对应issue-001-step-1.png、issue-001-step-2.png……最后一步用 **Observe:** 标出问题显现点配 issue-001-result.png 结果图。 ## 五、证据生成模板背后的 agent-browser 能力 模板中的截图与视频路径全部由 agent-browser CLI 在探索阶段生成。理解这些命令才能真正用好模板。 ### 5.1 注释截图screenshot --annotate dogfood 技能在每个页面都会执行 bash agent-browser --session {SESSION} screenshot --annotate {OUTPUT_DIR}/screenshots/{page-name}.png--annotate会在截图上叠加元素编号标注框其实现位于 cli/src/native/screenshot.rs通过 CDP 的Runtime.evaluateobjectGroup: agent-browser-annotate收集可交互元素的位置与编号再注入__agent_browser_annotations__覆盖层最后把标注框按滚动偏移投影到最终截图上见 project_annotations 与 inject_annotation_overlay。这意味着报告里每一张--annotate截图都自带可点击 / 可填充元素编号复现步骤中可以精确写出点击e3这样的操作与agent-browser --session {SESSION} fill e1 ...、click e3等交互命令形成闭环——截图证据与操作命令互相印证。5.2 复现视频record start/record stop对交互类问题技能要求在复现之前先开录像agent-browser --session {SESSION} record start {OUTPUT_DIR}/videos/issue-{NNN}-repro.webm # ... 逐步操作每步之间 sleep 1 ... agent-browser --session {SESSION} record stop录制底层实现在 cli/src/native/recording.rsvalidate_output_path要求输出必须带.webm或.mp4扩展名.webm 走 libvpx 编码其余走 libx264录制帧率经validate_fps校验默认值之外测试用例覆盖了 0 与 61 等非法值的拒绝逻辑录制完成后还会在视频旁生成 contact-sheet 缩略图demo.webm→demo.contact-sheet.png。此外录制会合成鼠标指针轨迹cursor_video_frame把历史光标状态合入视频帧让人眼能看清操作位置。5.3 静态问题的轻量取证对于加载即可见的问题错别字、文字截断、错位技能明确禁止录视频只需agent-browser --session {SESSION} screenshot --annotate {OUTPUT_DIR}/screenshots/issue-{NNN}.png报告中Repro Video填N/A。这正是模板注释set Repro Video to N/A在实操中的落点——证据强度与问题性质匹配既不浪费录制资源也不牺牲可复现性。5.4 配套的探索命令在每个页面dogfood 技能还会并行执行快照与控制台检查agent-browser --session {SESSION} snapshot -i # 交互模式找可点击/可填充元素 agent-browser --session {SESSION} snapshot # 内容模式读文本、标题、列表 agent-browser --session {SESSION} errors agent-browser --session {SESSION} console【免费下载链接】agent-browserBrowser automation CLI for AI agents项目地址: https://gitcode.com/gh_mirrors/agen/agent-browser创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考