WakerFlow是QoderWake内建的可视化工作流编排引擎，必须依附于已激活的QoderWake实例运行；启用需在系统设置中开启功能、校验License、重启核心服务，并通过拖拽节点或导入JSON绑定技能与执行器，调试时需联动审计中心验证日志与产物落盘。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
理解WakerFlow与QoderWake的协同关系
WakerFlow是QoderWake平台内建的可视化工作流编排引擎，它不独立运行，必须依附于已激活的QoderWake实例才能加载节点、绑定技能与触发执行；若QoderWake服务未启动或认证失效，WakerFlow画布将显示“离线模式”，所有保存操作均无法提交至调度中心。
在QoderWake中启用WakerFlow支持
1、登录QoderWake管理控制台，进入【系统设置】→【功能模块】页面。
2、找到“WakerFlow可视化编排”开关，点击启用，系统自动校验当前租户License是否包含该能力。
3、【启用后需重启QoderWake核心服务】，否则WakerFlow节点库为空，画布拖入组件时提示“no available skill registered”。
4、执行命令 qoderwake service restart --module=wakerflow，等待终端返回 WakerFlow engine reloaded with 47 built-in nodes。
创建首个WakerFlow任务并绑定QoderWake执行器
方法一：从空白画布构建
1、点击左侧导航栏“WakerFlow” → “新建流程”，选择模板类型为“Blank Flow”。
2、在画布中拖入“HTTP Trigger”节点，双击配置监听路径为 /api/v1/weekly-report，启用签名验证。
3、连接“AI Skill”节点，下拉选择已发布的技能“/report weekly”，确认其参数 schema 匹配上一节点输出结构。
4、添加“PDF Export”节点，设置文件名格式为 weekly_{{now|strftime:%Y%m%d}}.pdf，输出路径指定为共享存储桶 s3://qoder-reports/。
5、点击右上角“发布”，输入流程ID weekly-report-flow-v2，勾选“启用实时调度”，完成绑定。
方法二：导入预设JSON流程定义
1、准备标准WakerFlow JSON描述文件（含trigger、nodes、edges、metadata字段），确保其中 "executor": "qoderwake-core" 字段存在且值合法。
2、在WakerFlow首页点击“导入”，粘贴JSON内容或上传文件。
3、系统自动校验节点兼容性，若提示“Skill not found: /db/backup”，说明该技能尚未在当前QoderWake实例中注册，需先在【技能中心】完成部署。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
调试WakerFlow任务执行链路
第一步：触发本地调试模式
1、打开已发布的流程详情页，点击“调试”按钮。
2、在弹出面板中选择“模拟触发”，填写测试Payload，例如：{"user_id": "U123", "timezone": "Asia/Shanghai"}。
3、点击“运行”，观察右侧日志流中各节点状态变化，绿色表示成功，红色表示失败并附带错误堆栈。
第二步：检查QoderWake侧执行日志
1、切换至QoderWake【审计中心】→【WakerFlow事件流】。
2、筛选 trace_id 与调试时生成的 ID 一致的记录，展开查看原始输入、技能调用参数、子进程退出码及标准输出截断内容。
3、若某节点显示 timeout=3000ms, actual=3280ms，说明该AI技能响应超时，需在技能配置中调高 timeout 值或优化模型推理逻辑。
第三步：验证产物落盘位置
1、根据流程中“PDF Export”节点配置的 s3 路径，使用 CLI 执行：qoderwake storage ls s3://qoder-reports/weekly_20260730.pdf。
2、若返回文件元数据（size、last_modified），说明WakerFlow已成功驱动QoderWake完成端到端执行；若报错“No such key”，则检查S3权限策略是否授予了 qoderwake-executor-role 的 s3:PutObject 权限。
