SuperAPI AI 工具集

preview

编程与开发

查看项目

更新于 10-16 07:18

技能介绍

用途:当用户想查看、打开、跳转、可视化或预览某个 flow、script、app,或刚写完想提供可视化验证时使用。Windmill 开发页面会渲染 flow 图或脚本编辑器,支持逐步执行,并在每次保存时热重载;它通过 wmill dev 在本地运行,经 localhost 端口访问。

主要能力与两种决策:

  1. 模式选择。代理模式(--proxy-port <port>)在 http://localhost:<port>/ 暴露开发页,适用于只接受 localhost URL 的嵌入器;直连模式(默认)由浏览器从远程工作区 HTTPS URL 加载,本地 wmill dev 仅运行 WebSocket 回传通道用于热重载,适用于普通浏览器标签页。除非嵌入器明确需要 localhost,否则默认直连,不要“以防万一”启动代理。
  2. 由谁启动服务器。可自行在后台启动并捕获打印的 URL;若运行时支持读取 .claude/launch.json(如带 mcp__Claude_Preview__ 前缀的 MCP 预览工具),可写入按目标命名的条目并由 MCP 工具按需启动。没有此类工具时不要写 launch.json,否则无人读取、服务器不会启动。

自行启动命令(长时运行,需后台执行): flow/script 直连:wmill dev --path <wmill_path> --no-open flow/script 代理:wmill dev --proxy-port 4000 --path <wmill_path> --no-open app:cd <app_path>__raw_app && wmill app dev --no-open --port 4000 各命令会在 stdout 打印 URL,用宽松匹配捕获首个 https?:// 令牌后交给嵌入器或用户,不要自行拼接 URL(缺少工作区 ID 与令牌)。

launch.json 路径(仅限 Claude Desktop / Code MCP):每个 flow/script/app 使用独立命名条目(如 windmill: f/test/my_flow)与独立端口,不要复用通用条目或改写已有条目的 --path。flow/script 条目使用 bash -c 运行 wmill dev --proxy-port ${PORT:-4000} --path f/test/my_flow --no-open;app 条目运行 cd f/test/my_app__raw_app && wmill app dev --no-open --port ${PORT:-4001}。随后调用 MCP 预览工具,URL 用 http://localhost:<port>/,由代理的 / 重定向附加工作区 ID、令牌与路径,不要自行构造 /dev?... URL。

非可视化替代:flow 用 wmill flow preview <path> -d '<args>',script 用 wmill script preview <path> -d '<args>',两者打印作业结果、可安全自行运行且不会部署。

限制与注意:不要在前台启动 wmill dev(会阻塞);不要为每个预览目标复用同一 launch.json 条目;不要在没有 MCP 预览工具时写 launch.json;不要自行拼接 localhost 的 /dev 链接。