需启用flow-engine并配置权限后，通过YAML文件定义流程，绑定target_context方可运行WakerFlow。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在QoderWake中运行WakerFlow——这个专为复杂业务编排设计的可视化工作流引擎，但发现点击“Run”按钮后无响应、节点卡在pending状态，或根本找不到启动入口。这通常是因为WakerFlow未被激活、上下文缺失，或当前会话未绑定到支持该能力的数字员工岗位。
确认WakerFlow引擎已启用并加载
WakerFlow不是默认开启的模块，它依赖独立的flow-engine组件与岗位技能绑定，未启用时界面不会显示任何流程画布或运行控件。
执行qoderwake config get flow-engine.enabled → 若返回false，则需手动启用：qoderwake config set flow-engine.enabled true。
重启QoderWake客户端（非仅刷新页面），再次进入主界面，左下角应出现「WakerFlow」图标；若仍不显示，检查员工角色是否具备flow_admin权限：qoderwake status中role字段必须包含flow_admin或admin。
创建或导入WakerFlow定义文件
WakerFlow不支持纯图形拖拽即时生成，所有流程必须基于YAML格式的定义文件驱动，直接在UI中新建空白画布无法触发实际执行。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
方法一：使用CLI快速生成模板
在终端中执行qoderwake flow init --name "my_approval_flow" → 自动生成my_approval_flow.flow.yaml文件，含标准trigger→validate→review→approve四节点骨架。
方法二：从已有项目导入
将他人共享的.flow.yaml文件（如ci-deploy.flow.yaml）复制到本地workspace目录下的.flows/子目录，确保文件名以.flow.yaml结尾，QoderWake会在下次扫描时自动识别。
【文件必须放在.flows/目录下且扩展名为.flow.yaml，放错路径或改名会导致WakerFlow完全不可见】
绑定执行上下文并启动流程
WakerFlow每个实例必须挂载明确的target_context，例如Git仓库路径、告警ID或API端点，否则即使定义合法也无法调度执行器。
- 打开QoderWake客户端 → 点击左侧WakerFlow图标 → 在列表中选中目标.flow.yaml文件
- 点击右上角「Launch」按钮 → 弹出上下文绑定面板
- 在target_context输入框中填入真实值，例如github:org/repo:main:PR-123 或 prometheus:alert-id=ALERT-5566
- 点击「Confirm & Run」→ 界面跳转至实时执行视图，顶部显示Running状态及当前活跃节点高亮
此时流程真正开始执行：首节点触发条件校验，若通过则自动推进至下一节点；任一节点失败将中断流程并标记Failed，同时写入D:qoderwakelogsflow-execution.log。
