企业官网建设流程全解析

Flue CLI完全指南：在终端玩转你的AI Agent

【免费下载链接】flueThe sandbox agent framework.项目地址: https://gitcode.com/GitHub_Trending/flue1/flue

Flue CLI（flue命令行工具）是 Flue 这个沙箱 AI Agent 框架的终端入口：它让你不用打开浏览器，就能在本地一键初始化 Agent 项目、直接运行 AI Agent 并与它对话、拉取现成的集成"蓝图"（Blueprint），甚至离线搜索全部官方文档。本指南面向新手，带你用 5 个常用命令从零跑通一个属于自己的 AI Agent 🚀

为什么选择 Flue CLI 来运行 AI Agent

很多 Agent 框架要求你起一个 Web 服务再打开页面调试，而 Flue 的思路完全不同：Agent 就是一个普通的 TypeScript 函数，CLI 负责把模型、沙箱、工具、技能等运行环境一次性装配好，然后直接把回复打印到终端。

Flue 框架的核心能力包括：

• 🤖Agents——跨对话保持上下文的自主 Agent
• 📦Sandboxes——安全的沙箱环境，让 Agent 能跑代码、改文件
• 🔧Tools / Skills——类型安全的工具调用与可复用技能包
• 📡Channels——Slack、Teams、Discord、GitHub 等消息通道接入

CLI 源码位于 packages/cli/，核心命令注册逻辑见 cli.ts，它一共注册了四个命令家族：run、init、add/update、docs。

如何安装 Flue CLI：3 步完成配置

前提条件：Node.js ≥ 22.19.0（见 package.json 中的engines配置）。

第 1 步：安装 CLI

在你的 Agent 项目目录中执行：

npm install -D @flue/cli

第 2 步：验证版本

npx flue --version

第 3 步：准备模型 API Key

把你的模型提供商密钥（如 Anthropic、OpenAI）写入项目根目录的.env文件，flue run会自动加载。

💡 想从源码了解 CLI 的构建方式，可以查看 packages/cli/README.md 与官方示例 examples/hello-world/。

如何用 flue init 初始化 AI Agent 项目

flue init会用交互式提问帮你搭好一个完整项目骨架，核心逻辑在 init.ts 中：

npx flue init ./my-agent-app

运行后会依次询问两个问题：

也可以跳过交互，用参数直接指定：

npx flue init --target node --deploy

完成后 CLI 会打印"next steps"清单，告诉你下一步该写什么文件。目录非空或已存在flue.config.*时，需要加--force才会覆盖。

flue run：一键本地运行你的 AI Agent 并对话

这是最常用的命令（实现见 run.ts）。它执行无网络传输的一次性本地运行：启动 Agent、打印回复、然后退出。

npx flue run src/agents/hello.ts -m "你好，介绍一下你自己"

执行后终端会显示品牌化的会话信息（Agent 身份、会话 ID、数据库位置），接着以user/assistant标签逐行打印对话内容，最后输出agent completed✅。

常用参数速查：

多轮对话技巧：--id让会话可以延续：

npx flue run src/agents/hello.ts -m "帮我总结昨天的会议纪要" --id support-4821 npx flue run src/agents/hello.ts -m "再展开第三点" --id support-4821

⚠️ 按 Ctrl-C 中断时，CLI 会优雅地排空正在执行的 Agent（最多等待 5 秒），而不是直接掐断，避免半成品写入。

如何用 flue add 拉取集成蓝图（Blueprint）

当你想让 Agent 接入 Slack、Telegram、Postgres、Daytona 沙箱等平台时，Flue 提供了"蓝图"——一份给 AI 编码代理执行的实现指南（实现见 blueprints.ts，仓库内置的蓝图模板在 blueprints/）。

查看可用蓝图清单：

npx flue add

输出是一张三列表格：命令、类别、对应网站，覆盖sandbox、database、channel、tooling四大类，例如flue add channel slack、flue add database postgres。

把蓝图喂给你的编码代理：

npx flue add sandbox daytona --print | claude

还支持"从零构建"模式——传入任意提供商文档的 URL，作为蓝图的起点让 Agent 现场实现。升级已有集成则使用npx flue update <kind> <name>。

flue docs：离线搜索与阅读官方文档

CLI 内置了完整文档（实现见 docs.ts，基于 MiniSearch 做全文检索），断网也能查：

# 列出所有文档页 npx flue docs # 阅读某一页 npx flue docs read guide/sandboxes # 全文搜索（返回 JSON 结果） npx flue docs search "durable execution"

搜索对标题、小标题、描述做了加权，支持前缀匹配与模糊匹配，最多返回 8 条带摘要的结果。

新手常见问题（FAQ）

Q1：flue命令提示找不到？确认已安装依赖且用npx flue调用，或检查 Node 版本是否 ≥ 22.19.0。

Q2：和vite dev什么关系？flue只负责本地一次性运行与脚手架；开发服务器和生产构建由 Vite 的flue()插件接管（来自@flue/vite），详见 packages/vite/。

Q3：模型在哪里配置？在 Agent 函数里用useModel('provider-id/model-id')设置，或在调用prompt/skill/task时按次传入{ model: ... }。

Q4：会话数据存在哪里？flue run会把对话持久化到本地数据库（终端会打印db路径），所以同一个--id能跨命令续聊。

总结

Flue CLI 用四个命令覆盖了 AI Agent 开发的完整闭环：init建项目 →run本地对话调试 →add拉取集成蓝图 →docs离线查文档。对于新手来说，这是目前最轻量的方式把自主 AI Agent 真正跑起来——没有浏览器、没有复杂服务，一切都在终端完成。现在就打开终端，执行第一条npx flue init试试吧！🎉

【免费下载链接】flueThe sandbox agent framework.项目地址: https://gitcode.com/GitHub_Trending/flue1/flue