browser-preview 是 starchild-ai-agent/official-skills 中的一项技能,用于补充 preview_serve 与 preview_stop 之外的部分:当 preview_serve 返回 URL 后,用户实际如何看到内容。它面向开发与调试场景,帮助排查右侧预览面板(含 Files 与 Preview 两个标签)中的各类异常。核心能力与规则:每次 preview_serve 会创建一个 Preview 标签,URL 格式为 /preview/{id}/,面板右上角 ⋮ 菜单可查看 RUNNING SERVICES;关闭标签不会停止后端服务,而服务停止后标签会显示错误页。用户浏览器无法访问 localhost 或 127.0.0.1,必须使用 /preview/{id}/ 或完整 https://<host>/preview/{id}/ 地址,curl http://localhost:{port} 仅用于服务端自身诊断。由于预览挂在 /preview/{id}/ 下,HTML、JS、CSS 及框架配置中的绝对路径会失效,需改为相对路径(如 static/app.js、./static/app.js、api/users、images/logo.png、./fonts/x.woff、data.json),并逐一检查 src、href、fetch、动态导入、CSS url() 与字符串字面量。诊断步骤:先读注册表 cat /data/previews.json 2>/dev/null || echo "NO_REGISTRY";为空或缺失则读历史 cat /data/preview_history.json 2>/dev/null || echo "NO_HISTORY";历史为空时可扫描工作区查找 package.json、index.html、app.py、main.py、vite.config.* 等项目文件。若端口无响应或前端不同步,可用 preview_stop(id) 后再 preview_serve(dir, title, command) 重建以强制重新注册。限制:无法直接打开、关闭或刷新预览标签,无法强制刷新 iframe,也无法读取 iframe 显示内容;此类情况需告知用户手动操作。资料未提供具体价格、平台支持范围等更多信息。
browser-preview
通用与其它
更新于 10-16 09:35