VichuFlow：可观测、可验证的智能体工作流编排引擎

VichuFlow 是一个开源跨平台运行时，将工作流作为持久状态机运行，协调外部编码智能体，并通过自验证的证据决定阶段转换，从不盲目信任智能体的自我报告。

• 原作者/维护者: corteshvictor
• 来源平台: GitHub
• 原始标题: vichu-flow
• 原始链接: https://github.com/corteshvictor/vichu-flow
• 发布时间: 2026-06-14

---

当前AI编码助手和智能体(agent)在代码生成方面表现出色，但在验证代码正确性方面却令人担忧。它们常常宣称"完成了✅"然后继续下一个任务，却无法提供可靠的证据证明代码确实可用。

现有的工具面临两难困境：要么让智能体在编辑器内部运行（没有外部记录，崩溃后无法恢复），要么并行启动多个智能体展示差异对比（没有工作流概念，没有验证关卡）。VichuFlow正是为解决这一痛点而生——它是一个不信任智能体的外部运行时。

---

VichuFlow的每次运行都是磁盘上的纯文本文件（state.json + events.ndjson）。CLI、TUI和Web界面只是这些文件的视图。这种设计带来关键优势：

• 崩溃恢复：运行可以 survives 崩溃，通过vichu resume命令从断点继续
• 完全可审计：所有事件和状态变更都被记录，便于事后分析
• 工具无关：不绑定特定编辑器或IDE，可以在任何环境中使用

VichuFlow亲自运行测试、代码检查、类型检查等命令，捕获退出码和输出，只有这些验证结果才能授权阶段转换。智能体声称成功但未通过验证关卡，则无法前进。这种"show, don't tell"的哲学确保了代码质量。

VichuFlow不绑定单一智能体提供商。你可以用一种智能体实现功能，用另一种审查——或者完全不使用智能体，仅用普通shell命令。当前支持的适配器包括：

• claude-code: Anthropic Claude Code CLI
• codex: OpenAI Codex CLI
• shell: 普通shell命令
• fake: 确定性模拟（用于CI测试）

---

VichuFlow通过以下手段防止智能体"撒谎"：

• 阶段只有在VichuFlow亲自运行测试并看到通过后才能前进
• 声称成功但未通过绿色关卡的智能体会被阻止，证据保存在磁盘上
• 验证命令（test/lint/typecheck）由项目自身工具链执行，VichuFlow只负责协调

为防止智能体破坏工作成果，VichuFlow提供多层保护：

• 工作区快照：基于Git或文件系统，在每次运行前创建快照
• 变更追踪：按工作者追踪文件变更，识别意外修改
• 命令策略：在执行前拦截rm -rf、git push、安装命令等危险操作
• 自动回滚：如果验证检查触及了你的文件，自动回滚到安全状态