项目背景:把网页 Bug 交给 Claude Code 等 AI 编程助手修复时,录屏和截图它看不懂,人工描述复现步骤又容易漏掉关键细节,比如点了哪个元素、哪个接口报错、控制台有什么异常。本项目是一个 Chrome 扩展:在页面上把复现过程录下来,直接输出结构化的 Markdown 报告,AI 可以照着定位问题,也能据此生成自动化测试。不录视频,不截图,只记录语义化、机器可读的信息。
功能模块:
一、步骤录制:记录点击、表单输入、滚动、键盘快捷键和页面跳转,单页应用和传统页面都支持;输入做了防抖合并。
二、语义化捕获:记录 CSS 选择器、DOM 路径、组件层级和元素文本,而不是像素坐标,页面改版后仍能定位。
三、网络与控制台:通过 webRequest 记录录制期间的请求、状态码和耗时;拦截 console 错误与警告、未捕获异常和未处理的 Promise 拒绝,并对应到具体步骤。
四、框架识别:自动识别 React、Vue、Svelte、Angular 及版本。
五、导出:一键生成包含步骤、网络日志、控制台错误和环境信息的 Markdown,并生成 Playwright 测试脚本草稿。
六、隐私与隔离:密码输入自动打码;工具栏放在 Shadow DOM 里,不受宿主页面样式影响;会话保存在扩展本地存储,可稍后查看和导出。
本人负责:独立完成设计、开发和测试。技术:TypeScript、Chrome 扩展 Manifest V3、Vite、Vitest。共有八十六个自动化测试,覆盖选择器生成、事件录制、跳转检测、Markdown 与 Playwright 导出等模块。
点击空白处退出提示










评论