用途:通过 flow CLI 在仓库内管理 Flow 工作流,而不是手动创建 .flow、手改 .gitignore 或猜测运行时 API。
主要能力:初始化或修复仓库级 .flow;编写与校验 workflow YAML;启动/停止本地运行时;执行与恢复执行;查看工作流、执行列表、执行详情、历史、追踪、记录与变更;查看适配器目录与版本等次要能力。
使用方式:优先在目标 Git 仓库中本地运行;不在目标仓库时用 --repo PATH。初始化用 flow init --repo .,随后直接编写 .flow/workflows/*.yaml。修改工作流后运行 flow validate;仅需结构校验时才用 --schema-only。常见本地执行与检查顺序:flow validate . --json、flow start --repo .、flow execution run --repo . --workflow-id <workflow-id> --binding-id manual --json、flow execution show --repo . --execution-id <execution-id> --json,完成后 flow stop --repo . --force。执行/恢复返回 JSON 后,直接从响应取 execution.id 用于后续检查,避免为重新发现已有 id 而调用 workflows、execution list 或 status。可用 jq 等只提取所需字段,如 .execution.id、.execution.lifecycle_state,lifecycle 变为 completed 时停止轮询。
限制与注意:execution run/resume/action run/watch 需要已有持久运行时,除非显式指定服务器目标。出现 Workflow <id> is not ready 属就绪失败,应据报告原因说明缺失的本地依赖或密钥。原生聊天不在 CLI 范围内,应使用 Web /chat 路由或运行时 /api/v1/chat/* API。除需要浏览器启动、跨仓库运行时检查、适配器目录或安装校验外,不要突出 start --open、status --all、adapters、--version。精确语法与行为以同步的规范文档为准;缺失信息暂未提供。