Wave Flow

让任务有章可循，让不同 Agent 发挥所长。

Wave Flow 是一个本机运行的 AI Agent 工作流桌面应用。用对话描述目标，让主控提出方案；确认后，由真实的 Codex / Kimi Agent 分阶段执行，你可以随时查看进度、回答问题或停止任务。

把任务交给可控的流程，把不同工作交给合适的 Agent。不必让一段越来越长的对话，承担从规划到交付的所有事情。

中文 | English

从一句目标，到一场协作

比如：“审查当前项目，让另一位 Agent 独立复核，只报告有证据的问题。”

在 Wave Flow 中，你可以：

1. 先看方案，再决定执行。 通过对话生成和调整工作流，也可从内置的只读代码审查预置开始。
2. 按阶段掌握进度。 Phase → Worker 层级展示协作分工，查看每个 Agent 的状态、流式正文和工具活动。
3. 需要你时，再接手。 Agent 显式请求人工协助，你提交答案后，由原 Agent 确认继续；也可主动暂停或停止。
4. 结束之后，有据可查。 查看结构化交付与历史执行尝试；中断后显式恢复，不悄悄重跑。

写入类 Workflow 使用独立 Git worktree，自动保存实际 tracked 改动与非 ignored untracked 文件（排除未跟踪 node_modules）。无需提前填写成果文件路径。多个并行写分支须由明确的集成 Worker 合并；完成后查看真实 diff，明确选择目标本机分支并 squash 合入为一条 commit。不会自动合入或 push；内部检查点保留用于恢复和诊断。

为什么是 Wave Flow？

长任务，靠流程推进，不靠模型记住计划

工作流明确阶段、依赖、并行与完成条件，支持顺序、并行、流水线和动态调用。用明确的执行规则减少长程任务的编排漂移；模型仍有发挥空间，但不需要独自记住整个执行计划。底层采用 TypeScript 编排，兼顾灵活性与可控性。

交付须经过 Schema 校验和持久化记录，Agent 的一句“完成了”不能替代完成证据。流程可控不代表答案必然正确，执行完成也不等于目标已验收。

不押注一个 Agent，让不同 CLI 各展所长

把 Codex、Kimi 放进同一条 Workflow：独立研究、交叉审查，再比较证据、择优汇总。也可以结合各自模型、工具与 CLI 能力分配工作，让擅长分析的分析、擅长实现的实现。

每个 Worker 绑定独立真实 ACP 会话，使用你选择的本机 CLI 及其默认模型。多 CLI 协作利用不同模型与 Harness 的互补性，降低单一路径的盲区；当前由用户分配 CLI，不提供自动模型路由。

方案可以商量，执行权始终在你手里

通过对话调整待执行方案，版本记录保留每次变化；放弃方案不丢掉任务和对话。主控负责提案，用户确认才授权运行。执行中可以查看进度、提供人工协助、暂停或停止，中断后显式恢复原执行。

一个新 Task 持有一条持续演进的工作流链。执行后可根据反馈修订源码、输入或 CLI 配置；确认新版后创建新的 Execution，在已安全交接的当前现场重新工作。原版本恢复仍属于同一 Execution，不提供任意节点回滚或跨版本自动重放。

特别适合这些任务

• 广覆盖、重证据的探索：技术调研与大范围 CR。 多 CLI 独立探索不同方向，再集中复核与比较，减少单一模型或 Harness 的遗漏和偏差。
• 多阶段、强约束的交付：需求分析 → 代码开发 → 自测 → 代码 CR。 将阶段交接与验证纳入工作流，让开发和审查各有分工，不把整条交付链只写在 Prompt 里。
• 重复多、标准统一的治理：依赖升级、API 迁移与跨模块规范修正。 按模块拆分任务，独立处理后统一验证与复核。并行写入使用独立 worktree，冲突须显式集成，不把目录分离当作安全隔离。

快速开始

运行桌面应用，在项目中选择“自动编排”“预置工作流”或“本地工作流”。本地来源须是项目内受信任 .ts 文件，声明纯字面量 meta.inputSchema 对象参数 Schema；预检只读取、不会运行脚本。保存方案后，在方案页确认参数、CLI 和必要的 Git 授权才启动。

执行结束后查看影响面总结。需要调整时，通过对话修订生成方案、准备模板参数新版本，或编辑本地文件后重新预检；仅切换 CLI 可选择“保留源码，准备 CLI 配置新版本”。写修订明确选择原保存现场，独立分支须显式集成；新版启动前重新核验现场，旧结果不自动复用。归档后只读。

当前边界

Wave Flow 仍在早期开发，欢迎试用，也请留意：

• 本地 Workflow 是用户明确选择的受信任扩展；不支持 URL 下载工作流、可视化流程编辑、远程控制或云同步。
• 主控保留 OS 文件写隔离与四个窄工具；Worker 使用可信原生 CLI 配置与权限，不额外施加 Wave Flow OS 文件隔离。worktree/cwd 只分离正常工作现场，不能阻止 Worker 修改其他目录、其他 worktree、共享 Git 或凭据；任务意图不是安全保证。不同 worktree 可修改同一文件，冲突由显式集成处理。Git diff 不证明工作区外影响，也不替代敏感内容审阅。
• 完整集成且 ready 后可查看成果 diff 并明确 squash 合入目标本机分支，不自动 push。目标分支漂移或未提交内容存在覆盖风险时拒绝。原生 CLI 仍使用 ~/.codex、~/.kimi-code；配置与凭据也可能被模型工具修改。
• 完整总结、当前现场补充及 writer 安全交接是修订启动的前置条件。新版所有实际节点重新工作，不跨 Execution 缓存旧完成结果。新 Task 使用单链契约，旧多卡记录不自动迁移。
• 中断恢复只复用同一执行内严格匹配的已完成前缀；不会回滚文件或撤销外部副作用。
• Worker 原生会话持续五分钟没有事件时，执行器会记录停滞诊断并中断，不自动重发任务；等待人工答案、用户暂停与控制操作不计入窗口。静默和 read-only 意图都不能证明没有副作用。
• 原版恢复须先完成影响面总结并核验现场；Git 现场变化会要求独立影响面补充和重新确认。未交接 writer、未保存改动或旧成果不一致会阻止恢复，不自动回滚。Git 指纹只覆盖可核验文件，不证明外部系统状态。
• 业务已完成但最终 Git 来源保存失败时，可显式重试成果收尾，不重跑业务 Worker；未知 writer 退出仍会阻止交接。
• 工作台与执行引擎运行在本机；模型请求仍由所选 CLI 发送给其服务商，不代表离线推理或数据不出本机。

如果你有建议，或者希望参与项目维护，欢迎联系：oliver.ysq@gmail.com

如果你也希望 Agent 协作不止于“开几个聊天窗口”，欢迎给 Wave Flow 一个 Star。让我们一起把复杂任务的执行过程，做得更清楚、更可靠。