Flue架构深度解析Harness-first测试架优先设计哲学完整指南【免费下载链接】flueThe sandbox agent framework.项目地址: https://gitcode.com/GitHub_Trending/flue1/flueFlue 是一款由 Astro 团队打造的开源 AI Agent 框架它的核心理念是 Harness-firstHarness 优先——把智能体运行架作为框架的地基而非附属功能。这意味着每个用 Flue 构建的智能体都会自动获得完整的运行环境会话管理、工具调用、技能加载、沙箱文件系统与持久化恢复。本文带你快速理解这套架构的设计哲学以及它为什么能让智能体真正自主干活而不只是会聊天。一、为什么测试架优先先搞懂 Harness 是什么很多 Agent 框架把智能体当成一个配置对象填几个字段拼一段提示词调用模型 API。但真正的自主智能体比如 Claude Code需要的远不止这些——它需要一个**运行架Harness**来支撑自主工作。Harness 可以理解为智能体的驾驶舱它负责会话Session跨多轮对话保持上下文连续性工具Tools让智能体调用你的应用代码查询数据、修改系统技能Skills按需加载的专业知识包沙箱Sandbox一个安全的文件系统与 Shell 环境让智能体真正读写文件、执行命令持久化Durability崩溃、重启、重新部署后已完成的工作不丢失Flue 官方对这一原则的表述是Harness 是框架的核心而不是框架的一个功能why-flue.md。这正是它与又一个 SDK的本质区别。二、3 步看懂 Flue 的架构分层Flue 仓库采用 monorepo 结构核心运行架逻辑集中在 packages/runtime/ 包中模块职责packages/runtime/src/harness.tsHarness 核心实现管理会话、沙箱环境、事件流packages/runtime/src/session.ts会话生命周期打开、恢复、中止packages/runtime/src/agent.ts内置标准工具工厂读文件、写文件、grep、bash 等packages/vite/构建工具扫描use agent并注册智能体packages/cli/flue run本地运行命令架构上可以概括为三层定义层你用 TypeScript 函数声明智能体下一节详解运行架层Harness 把模型、工具、沙箱、技能组装起来驱动智能体循环工作持久层所有会话记录写入可重放的日志流支撑崩溃恢复三、智能体是一个函数不是一段配置Flue 最反直觉的设计是智能体就是一个 JavaScript 函数。函数体里用 Hook 组装能力返回值是系统提示词use agent; function Triage() { useModel(anthropic/claude-sonnet-4-6); useSandbox(local()); useTool(searchIssues); useSkill(reviewChecklist); return 调查报告的 Issue 并给出下一步行动建议。; }这个设计刻意模仿了 React 组件函数每一轮都会重新渲染意味着能力可以随状态动态变化——例如根据usePersistentState里的标志位动态挂载更强的模型或更多工具让智能体自我升级这种函数即智能体的写法带来两个直接好处组合自由同一项目里的多个智能体共享工具、技能文件像普通模块一样 import行为可编程能用 if/else、异步、状态表达的逻辑配置对象永远做不到详细原理见 building-agents.md。四、Harness 内部如何驱动一次任务从 harness.ts 的源码结构能看出 Harness-first 的落地细节懒加载会话Harness.session()按需打开或恢复会话首次使用时才会从持久化存储中加载或创建会话记录共享环境槽Harness 持有一个可变的环境引用envSlot沙箱可以在轮次边界被整体替换且对所有会话可见子任务分派createTaskSession为子智能体创建独立的子会话它继承父级的模型与压缩策略但拥有全新的上下文——这就是父智能体把活儿外包给专家的机制作用域级联中止一个AbortController贯穿整个 Harness 作用域中止操作会优雅地传递给所有会话在工具层面agent.ts 定义了标准化的read、write、edit、bash等文件操作工具并内置了文件写锁——当智能体并行修改同一文件时框架保证写操作串行化避免静默丢失修改。这种替开发者处理脏活的思路贯穿整个运行架。五、持久化Harness 优先的另一半只给智能体一个运行架还不够——生产环境里服务器会重启、模型服务会超时、客户端会断线。Flue 把持久化做进了 Harness 契约中每个输入先被记录为durable 提交之后才启动模型工作每一条已接受的提交必然走向completed/failed/aborted之一无论期间崩溃多少次恢复时只依赖持久化证据部分响应会继续未完成的工具批次会被修复子任务从自己的转录记录中续跑默认每条提交有 10 次重试预算和 1 小时超时可通过智能体的durability静态属性调整。完整的恢复行为说明在 durability.md 中值得每个准备上生产的团队细读。六、开放生态模型、沙箱、部署全都不锁死Harness-first 并不意味着封闭。Flue 在每一层都保持开放开放模型接入任意受支持的 LLM 提供商开放沙箱内置内存虚拟沙箱纯 TypeScript 模拟 bashsandboxes.md也可接入 Daytona、Modal、Cloudflare Computer 等远程沙箱开放部署同一份智能体代码可部署到 Node.js、Cloudflare Workers、GitHub Actions、GitLab CI配套示例都在 examples/ 目录里从最简单的 hello-world 到带沙箱的 cloudflare 部署按难度递进是理解架构最快的路径。七、总结Harness-first 给了新手什么你关心的Harness-first 的回答智能体能不能真的干活能沙箱 标准文件工具开箱即用状态会丢吗会话与持久状态写入可重放日志崩溃自动恢复会被平台锁死吗模型、沙箱、部署目标全部开放学习成本高吗会写函数和 Hook 即可像写 React 组件一样一句话概括别人把 Harness 做成功能Flue 把 Harness 做成地基。这也是它敢于叫自己framework而非SDK的底气。【免费下载链接】flueThe sandbox agent framework.项目地址: https://gitcode.com/GitHub_Trending/flue1/flue创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考