用 Flue 2.0 写一个 TypeScript Agent：Agent Hooks 与崩溃可恢复实战

# 新建目录并初始化
mkdir my-flue-agent && cd my-flue-agent
npm init -y

# 装运行时与 CLI
npm install @flue/runtime @flue/cli

# 确认 CLI 可用
npx flue --help

新建 src/agents/assistant.ts。文件开头的 'use agent' 是框架指令，用来标记这个模块是一个 Agent 定义：

'use agent';
import { useModel } from '@flue/runtime';

export function Assistant() {
  useModel('anthropic/claude-haiku-4-5');
  return 'You are a helpful assistant. Keep replies short.';
}

函数返回的字符串就是系统提示。注意它可以直接引用外部变量，这让「提示词随状态变化」变成了很自然的事，而不是拼字符串的苦力活。

npx flue run src/agents/assistant.ts --message "Say hello"

看到模型回复就算跑通了。这一步的价值在于：它把「框架是否装对」「模型 Key 是否可用」「Agent 定义是否合法」三件事一次性验证完，后面再出问题就不用怀疑环境。

这是 Flue 2.0 和多数轻量框架拉开差距的地方：会话被记录在持久流里，运行时重启后会自动恢复，不需要你自己写恢复逻辑。下面这个「GitHub Issue 分诊」Agent 用持久状态记住走到哪一步：

export function IssueTriageAgent({ id }) {
  useSandbox(local());
  const [step, setStep] = usePersistentState('step', 'reproduce');

  if (step === 'reproduce') {
    useModel('anthropic/sonnet-5-0');
    useSkill(reproChecklist);
    useTool({ name: 'submit_repro', run: () => setStep('diagnose') });
  }
  if (step === 'diagnose') {
    useModel('anthropic/fable-5-0');
    useSkill(debuggingGuide);
    useTool({ name: 'submit_diagnosis', run: () => setStep('report') });
  }
  if (step === 'report') {
    useModel('anthropic/sonnet-5-0');
    useTool(postGitHubComment);
  }

  return `Follow the workflow to triage GitHub issue ${id}.`;
}

这段代码里有三个值得借鉴的设计：按阶段换模型（复现阶段用推理更强的模型，报告阶段换更快的）、按阶段换技能（每一步只加载当下需要的说明，控制上下文长度）、用工具推进状态（submit_repro 的副作用就是把状态推到下一步）。

Flue 支持从任意 Model Context Protocol 服务器挂载工具，也支持给 Agent 一个沙箱来执行命令、编辑文件。这意味着你在别处已经写好的 MCP Server 可以直接复用，不必为框架重写一遍。

export function OpsAssistant() {
  useModel('anthropic/claude-haiku-4-5');
  // 从 MCP 服务器挂载工具（具体 API 以官方文档为准）
  useMcp('filesystem', { command: 'npx', args: ['-y', '@modelcontextprotocol/server-filesystem', './data'] });
  useSandbox(local());   // 给 Agent 一个可执行命令的环境
  return 'You are an ops assistant. Use the filesystem tools to inspect ./data before answering.';
}

Flue 用 Vite 做构建、Hono 做路由，接进现有工程只需要加一个插件：

// vite.config.ts
import { flue } from '@flue/vite';
import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [flue()],
});

部署目标覆盖 Cloudflare Workers、Node.js、Docker、AWS、Vercel、Railway；渠道侧可接 Slack、Discord、GitHub、Telegram、WhatsApp、Microsoft Teams 等 20 多个平台；存储侧支持 PostgreSQL、Redis、MongoDB、MySQL、Supabase；可观测性对接 OpenTelemetry、Braintrust、Sentry。