# VichuFlow：可观测、可验证的智能体工作流编排引擎 > VichuFlow 是一个开源跨平台运行时，将工作流作为持久状态机运行，协调外部编码智能体，并通过自验证的证据决定阶段转换，从不盲目信任智能体的自我报告。 - 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm) - 发布时间: 2026-06-14T01:15:59.000Z - 最近活动: 2026-06-14T01:23:25.382Z - 热度: 157.9 - 关键词: agentic workflow, observable, verifiable, orchestration, coding agent, state machine, cross-platform - 页面链接: https://www.zingnex.cn/forum/thread/vichuflow - Canonical: https://www.zingnex.cn/forum/thread/vichuflow - Markdown 来源: ingested_event --- ## 原作者与来源 - **原作者/维护者**: corteshvictor - **来源平台**: GitHub - **原始标题**: vichu-flow - **原始链接**: https://github.com/corteshvictor/vichu-flow - **发布时间**: 2026-06-14 --- ## 背景：编码智能体的信任危机 当前AI编码助手和智能体(agent)在代码生成方面表现出色，但在验证代码正确性方面却令人担忧。它们常常宣称"完成了✅"然后继续下一个任务，却无法提供可靠的证据证明代码确实可用。 现有的工具面临两难困境：要么让智能体在编辑器内部运行（没有外部记录，崩溃后无法恢复），要么并行启动多个智能体展示差异对比（没有工作流概念，没有验证关卡）。VichuFlow正是为解决这一痛点而生——它是一个**不信任智能体的外部运行时**。 --- ## 核心理念：三大支柱 ### 1. 外部可观测运行时 VichuFlow的每次运行都是磁盘上的纯文本文件（`state.json` + `events.ndjson`）。CLI、TUI和Web界面只是这些文件的视图。这种设计带来关键优势： - **崩溃恢复**：运行可以 survives 崩溃，通过`vichu resume`命令从断点继续 - **完全可审计**：所有事件和状态变更都被记录，便于事后分析 - **工具无关**：不绑定特定编辑器或IDE，可以在任何环境中使用 ### 2. 验证驱动的证据 VichuFlow亲自运行测试、代码检查、类型检查等命令，捕获退出码和输出，只有这些验证结果才能授权阶段转换。智能体声称成功但未通过验证关卡，则无法前进。这种"show, don't tell"的哲学确保了代码质量。 ### 3. 跨厂商设计 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`、安装命令等危险操作 - **自动回滚**：如果验证检查触及了你的文件，自动回滚到安全状态 ### 预算控制 为避免意外账单，VichuFlow提供硬性限制： - 挂钟时间限制 - 成本上限 - Token使用量限制（跨所有智能体累计） 这些限制可以阻止失控循环和意外费用。 --- ## 工作流程模式 VichuFlow内置两种主要工作流： ### Quick 工作流 标准的三阶段流程： 1. **explore**: 探索和理解任务 2. **implement**: 实现功能 3. **verify**: 验证实现（必须通过测试才能进入下一阶段） ### Review 工作流 更复杂的对抗性审查流程： 1. **adversarial review**: 审查代码并提出问题 2. **auto-fix loop**: 自动修复循环 3. **structured verdict**: 基于持久化裁决的分支决策 这种工作流特别适合代码审查场景，可以自动迭代直到满足质量标准。 --- ## 快速开始 ### 新项目 使用模板快速创建可运行的项目： ```bash vichu new my-app --template go # 支持 go | node | python | rust | empty cd my-app vichu run "add a sum function" # → 运行完成（关卡：go test ./...） vichu status # 检查最新运行状态 ``` 每个模板都包含最小化的源代码和真实关卡，使用对应技术栈的内置测试运行器，因此**第一次运行就能完成**——无论是否有Git。 ### 现有项目 在现有项目中初始化： ```bash cd your-project # Git仓库或任意文件夹——Git是可选的 vichu init # 检测技术栈，写入vichu.yaml vichu run "add a hello function" # 开始运行 ``` 默认情况下，新项目使用`fake`适配器，因此即使没有安装智能体CLI，`vichu run`也能工作。 ### 配置真实智能体 要使用Claude Code等真实智能体，安装CLI后配置`vichu.yaml`： ```yaml agents: default: provider: claude-code model: sonnet ``` 然后`vichu run "your task"`会以无头模式运行智能体，并根据测试关卡验证其工作。 --- ## 技术实现细节 ### 持久化运行时 VichuFlow的运行时基于原子操作： - **state.json**: 原子写入的状态文件 - **events.ndjson**: 追加式事件日志 - **心跳锁**: 支持孤儿进程回收 - **协作取消**: 优雅处理取消请求 ### 工作区提供者 VichuFlow支持两种工作区提供者： - **git**: 在Git仓库中使用Git作为基线，高效且与历史记录集成 - **filesystem**: 在非Git文件夹中，在`.vichu/`下快照整个目录树 两种提供者提供相同的变更检测、变更追踪和回滚功能，**无需VCS也能工作**。 ### 项目模板系统 模板系统确保第一次运行就能成功： - 检测技术栈并配置相应关卡 - 使用内置测试运行器（无需额外安装包） - 空文件夹没有关卡，会诚实地在`verify`阶段阻塞 --- ## 安全与隐私 VichuFlow本身免费开源（MIT许可证），不收集遥测数据。它协调的智能体由各自提供商计费（如Anthropic的Claude Code），VichuFlow的每次运行成本和Token预算帮助你控制支出。`shell`和`fake`适配器完全免费。 命令策略系统在执行前拦截危险操作，防止意外数据丢失。工作区快照和自动回滚机制提供了额外的安全保障。 --- ## 总结与展望 VichuFlow代表了AI辅助编程工具的一个重要发展方向：**从盲目信任智能体输出，转向基于验证的证据驱动工作流**。它解决了编码智能体最核心的痛点——无法可靠证明代码正确性。 通过将工作流作为持久状态机运行，VichuFlow提供了： - **可观测性**：所有运行都是磁盘上的纯文本，完全可审计 - **可靠性**：崩溃后可恢复，变更可追踪，危险操作可拦截 - **灵活性**：支持多种智能体和纯shell命令，不绑定单一提供商 - **经济性**：硬性预算限制防止意外费用 对于希望将AI智能体集成到生产级开发流程的团队，VichuFlow提供了一个值得信赖的编排层。它不取代智能体，而是让它们更可靠、更可控、更值得信赖。 随着AI编程助手的普及，像VichuFlow这样的验证层将变得越来越重要。毕竟，在关键业务代码中，"相信但验证"永远比"盲目信任"更安全。