用途:当用户想查看、打开、跳转到或可视化预览 Windmill 的 flow、script、app,或刚写完一个流程想提供可视化验证时使用。Windmill 开发页会渲染 flow 图与脚本编辑器,支持逐步执行,并在每次保存时实时重载。
主要能力与关键决策:一是模式选择。proxy 模式(--proxy-port <port>)把开发页暴露在 http://localhost:<port>/,适合只接受 localhost URL 的嵌入器;direct 模式(默认)由浏览器从远程工作区 HTTPS URL 加载,本地只跑 WebSocket 实时重载。无特殊需求默认 direct。二是由谁启动服务:通常由你自行后台启动,或由支持 launch.json 的运行时(如带 mcp__Claude_Preview__ 前缀工具的 Claude Desktop / Code MCP 预览集成)按需启动。仅当确实存在该类工具时才使用 launch.json 路径。
用法:flow/script 使用 wmill dev --path <wmill_path> --no-open(direct)或 wmill dev --proxy-port 4000 --path <wmill_path> --no-open(proxy);app 使用 cd <app_path>__raw_app && wmill app dev --no-open --port 4000。命令为长驻进程,须后台运行。从输出中宽松匹配首个 https?:// 链接,交给嵌入器或转告用户;不要自行构造 URL,因为缺少工作区 ID 与鉴权 token。launch.json 条目按 windmill: <wmill_path> 命名,每个 flow/script/app 独立端口与条目。非可视化替代方案:wmill flow preview <path> -d '<args>' 与 wmill script preview <path> -d '<args>',打印作业结果且不会部署。
限制与注意:没有 MCP 预览工具时不要写 launch.json,否则无人读取、服务不会启动;无需 localhost 嵌入器时不要开 proxy;不要复用通用条目或改动已有条目的 --path;不要自行拼 /dev?path= 链接;不要前台启动。未提供部分:具体端口范围、平台支持与收费信息暂未提供。