ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

如何 3 步跑通 Skyvern CLI:从首次启动到工作流自动化的完整实用指南

如何 3 步跑通 Skyvern CLI:从首次启动到工作流自动化的完整实用指南 如何 3 步跑通 Skyvern CLI从首次启动到工作流自动化的完整实用指南【免费下载链接】skyvernAutomate browser based workflows with AI项目地址: https://gitcode.com/GitHub_Trending/sk/skyvern想让浏览器自动化工作流定时跑、批量跑又不想每次都打开网页界面点来点去Skyvern 是一个用 AI 驱动浏览器操作的平台能把在网站上完成某件事的描述变成可重复执行的工作流。而它的命令行工具 Skyvern CLI让你一条skyvern quickstart就把服务拉起来之后触发工作流、传参、看状态、停服务全程只碰终端——对脚本、CI 和 AI Agent 都友好。全局速览最常用的 10 条命令速查表先建立整体印象。下面是日常用得最多的命令用到哪个查哪个命令作用什么时候用skyvern quickstart一条命令完成环境初始化并启动服务首次部署skyvern run server只启动 API 后端默认 8000 端口只要 API不要界面skyvern run all并行启动 API UI需要网页界面调试skyvern run ui只启动 UI默认 8080 端口后端已跑补开界面skyvern run dev后台启动 API UI立即释放终端不想占着终端窗口skyvern stop all停掉 8000/8080/9090 上的全部服务干净地收工skyvern run code 脚本.py运行 Python 脚本并注入参数写自动化脚本skyvern workflow run --id wpid触发工作流可--wait等结果脚本化批量执行skyvern run mcp启动 MCP 服务器接入 Claude、Cursor 等 AI 工具skyvern doctor/skyvern status检查安装健康度 / 服务是否在跑排错第一反应所有命令的实现都在 skyvern/cli/ 目录里遇到看不懂的参数直接翻源码比查文档快。3 步跑起来从安装到打开界面第 1 步装好 Python 环境和 CLI前提只有一个Python 3.11 / 3.12 / 3.13。然后安装带服务端依赖的完整版pip install skyvern[all]装完就有skyvern命令可用。如果你走 Docker Compose 路线不想装 Python则需要先启动 Docker并在仓库目录下执行git clone https://gitcode.com/GitHub_Trending/sk/skyvern cd skyvern。第 2 步一条命令完成初始化skyvern quickstart它会交互式地帮你搞定选择部署方式、配置 LLM Provider写入 API key、安装 Chromium 浏览器、初始化数据库最后询问是否立刻启动服务。全程跟着提示走即可。几个常用开关参数含义示例/默认值--server-only只起后端不起 UI默认带 UI--no-postgres不起 Postgres 容器默认走本地 SQLite~/.skyvern/data.db默认起 Postgres--database-string连接已有的 Postgrespostgresqlpsycopg://user:passhost:5432/db--skip-browser-install跳过 Chromium 安装默认安装--docker-compose用 Docker Compose 全容器化部署需在仓库目录内第 3 步确认服务真的起来了 ✅启动成功后按两个地址验证UI 界面http://localhost:8080 —— 能看到工作流列表就说明前后端都通了API 服务http://localhost:8000 —— 能被访问说明后端活着如果界面一直转圈用docker compose logs -fDocker 路线或重跑skyvern doctorpip 路线看哪一步卡住了。日常操作按场景选命令只起后端不要网页界面无头服务器上只暴露 API 时用skyvern run server单独拉 API。注意它读取.env里的PORT配置默认就是 8000。端口 8080 被占用了怎么办skyvern run ui启动前会检测端口。发现被占时它会询问是否杀掉占用进程交互场景直接确认即可脚本场景则加--force跳过询问skyvern run ui --force注意--force会直接终止占用 8080 的进程动手前确认那个进程不是别人的服务。怎么干净地停掉服务停止命令按端口找进程并终止不需要你去记 PID命令停什么skyvern stop all8000 8080 9090 上的 API 和 UIskyvern stop server只停 API--port可指定其他端口skyvern stop ui只停 UIskyvern stop docker等价于docker compose down停整个容器栈想要后台常驻终端不能一直挂着用skyvern run dev它以脱离终端的方式把 API 和 UI 都放到后台终端立即返回打印两个 PID 供你随时核对。停掉它们同样用skyvern stop all。进阶玩法脚本化、工作流自动化与 MCP用 run code 批量执行 Python 脚本如果你已经用 Skyvern 的 SDK 写好了自动化脚本skyvern run code可以直接在 CLI 里跑它参数有三种传法优先级从高到低方式写法适合场景JSON 文件--params-file params.json参数多、会被反复复用JSON 字符串--params {k1: v1}参数少一条命令带过去单个 flag-p k1v1 -p k2v2临时改一两个值例如skyvern run code my_script.py --params-file params.json。脚本不存在、不是.py后缀、JSON 写错它都会打印明确的修正提示而不是直接抛异常。在命令行触发、等待、取消工作流工作流管理命令是脚本化批量的核心。触发并同步等结果最多 5 分钟skyvern workflow run --id wpid_xxx \ --params {file: invoice.pdf} --wait --timeout 300其余操作都是同一风格场景命令查组织里的所有工作流skyvern workflow list支持--search、--page-size查某次运行里的任务明细skyvern tasks list --workflow-run-id wr_xxx查运行状态skyvern workflow status --run-id wr_xxx取消正在跑的运行skyvern workflow cancel --run-id wr_xxx失败后重跑skyvern workflow retry --run-id wr_xxx配好定时任务skyvern schedule系列list / create / enable / disable / delete这套组合拳的含义是定时任务交给schedule单次执行交给workflow run --wait结果查询交给tasks list——整个自动化闭环都不用离开终端。把 Skyvern 暴露成 MCP 服务器想让 Claude 或 Cursor 直接驱动浏览器自动化skyvern run mcp就能起一个 MCP 服务器关键参数参数含义默认值--transport传输方式stdio/sse/streamable-httpstdio--scope只暴露部分工具operate/build/browser/leanall--host/--port/--pathHTTP 传输时的监听地址127.0.0.1:8000/mcp--browser-extension额外启用 Chrome 扩展桥接仅 stdio关stdio是默认值适合本地 AI 编程工具直接拉起要远程托管时换streamable-http并显式传--host 0.0.0.0。避坑与排错常见报错对照表 ⚠️常见问题原因处理table organizations already existsskyvern1.0.31的已知 bug删掉~/.skyvern/data.db升级到 1.0.32再跑skyvern quickstartpip install skyvern报 ResolutionImpossible1.0.31 的 litellm/fastmcp 依赖冲突升级到 1.0.32或改用uv pip install skyvernDocker is not installed or not runningDocker Desktop 没启动启动 Docker 后重跑Compose 路线强依赖 DockerPostgres 容器名冲突postgresql-container残留的独立 Postgres 容器和 Compose 自带服务打架重跑skyvern quickstart按提示移除旧容器UI 起不来提示端口 8080 被占有其他进程占用确认后skyvern run ui --force或先skyvern stop ui服务没起来提示浏览器安装未完成Chromium 没装好playwright install chromium后再skyvern run server不确定环境哪里有问题——先跑skyvern doctor它会逐项检查依赖、配置和服务状态更多资源Skyvern CLI 把部署、运行、排错都压缩进了一个终端工具装完skyvern[all]之后你可以再也不会需要为一次自动化任务去开浏览器。下面两个入口足够你继续深入官方文档与快速上手README.mdCLI 全部命令源码skyvern/cli/【免费下载链接】skyvernAutomate browser based workflows with AI项目地址: https://gitcode.com/GitHub_Trending/sk/skyvern创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表