SuperAPI AI 工具集

preview-dev

前端与建站

查看项目

更新于 10-16 09:35

技能介绍

用途:preview-dev 用于网页、前端应用、全栈项目及各类 Web UI 的开发,边写代码边启动实时预览,让用户在浏览器面板直接看到运行结果。技能以“可运行代码、无模板无占位符”为原则,并使用用户语言回答。

主要能力:提供 read_file、write_file、edit_file、bash、preview_serve、preview_stop、preview_check 等工具;preview_serve 返回 preview_id 与 health_check,可判断 directory_listing、script_escape_error、blank_page、connection_failed 等问题。支持静态 HTML/CSS/JS、Vite/React/Vue、Python 与 Node 后端、Streamlit、Gradio 及全栈项目。全栈采用单端口暴露:前端 build 后由后端静态托管,如 FastAPI 用 app.mount("/", StaticFiles(directory="../frontend/dist", html=True), name="static"),Express 用 express.static 并加 catch-all 返回 index.html。

使用方式:先分析需求并写代码,读取代码确认真实监听端口,再调用 preview_serve(端口必须与代码一致);纯静态可省略 command 与 port,如 preview_serve(title="Dashboard", dir="my-dashboard");Vite 项目用 preview_serve(title="React App", dir="my-app", command="npm install && npm run dev", port=5173)。修改后在原项目用 edit_file 原地修复,先 preview_stop(old_id) 再以相同 dir、command、port 重启并验证 health_check.ok 为 true。preview_id 可从 /data/previews.json 或 preview_serve 输出读取,不可猜测。

限制与注意:预览经 /preview/{id}/ 反向代理,必须使用相对路径,Vite 配置 base: './';不要提示访问 localhost,应让用户看 Browser 面板。前端不可直接调用外部 API,需由后端代理;后端代理可参考 core/http_client.py 的 _get_proxy_config() 与 _get_ca_file_path()。轮询会消耗额度,需提前告知。仅监听 127.0.0.1,不要用 --host 0.0.0.0;最多 3 个基于 command 的预览。

社区发布:预览健康后可用 community_publish(preview_id="xxx", slug="price-dashboard") 生成公开 URL,格式为 {user_id}-{slug},端口不变则重启后仍有效;每用户最多 10 个,公开链接无认证,链接在容器运行期间可用。community_unpublish 移除公开 URL。