用途:在做完 UI 改动后,用 Shiplight MCP 浏览器工具在真实浏览器中确认改动的外观和行为是否正确,适用于布局/样式/组件变更的视觉检查、交互行为验证(点击、表单输入、导航)、提交前的 UI 检查以及视觉回归排查。后端改动、无 UI 影响的依赖升级、文档/注释/测试类改动不建议使用。
主要能力:可启动浏览器会话并指定起始 URL,支持同时开启多个会话对比不同页面或状态;inspect_page 获取带元素索引的 DOM 树与截图,act 模拟用户操作并按索引执行断言(如文本可见、元素存在);get_browser_console_logs 检查是否引入 JavaScript 错误;close_session 返回本地视频与 trace 路径,配合 record_evidence: true 可用 generate_html_report 生成报告,upload_html_report 可上传视频、trace 与报告 HTML 到 Shiplight 云端并返回可分享的 report_url。
使用方式:先用 /shiplight:verify 触发,分析改动并制定验证计划(涉及哪些文件/组件、需检查的页面与交互、通过标准);若开发服务器未运行,用对应命令(如 npm run dev、yarn dev)后台启动并等待就绪;调用 new_session 打开页面,先读 DOM 再按需查看截图以节省 token;用 act 交互与断言,检查控制台日志,汇总验证结果,关闭会话后再生成与上传报告。
需登录的应用:先在登录页开启会话,请用户手动登录后调用 save_storage_state,将 cookies 与 localStorage 保存到 ~/.shiplight/<site_url>/storage-state.json(如 ~/.shiplight/http_localhost_3000/storage-state.json);后续会话传入同一 storage_state_path 即可恢复登录态。若使用已保存状态后仍跳转登录页或出现认证错误,说明状态可能过期,需重新登录并保存。
限制:报告生成与云端上传依赖 session 开启时的 record_evidence 设置及相关 MCP 工具可用性;截图比 DOM 消耗更多 token,应仅在需要视觉信息时查看。其余未在资料中说明的内容暂未提供。