Harness 最小项目（前端+AI）
目标：在已有 Chat / Tool 经验基础上，用 1 周搭出可演示的 Agent Harness 最小骨架，并叠加护栏与 Eval 回归。
目录
阅读指引
本路线假设你已读过 Harness 专题 的 01–03，或至少理解 Agent = Model + Harness。
与 05.1 最小项目 的关系：
| 05.1 | 05.3（本路线） |
|---|---|
| 流式 Chat、RAG、结构化输出 | 多步 tool loop + trace + 护栏 + Eval |
| 单轮或浅工具 | 编排环、步数上限、HITL |
技术栈
| 层 | 选型 |
|---|---|
| 框架 | Next.js App Router |
| AI SDK | Vercel AI SDK（ai + @ai-sdk/openai 或兼容 provider） |
| 校验 | Zod（tool 参数） |
| Eval | promptfoo（可选，第 3 篇） |
| 观测 | 结构化 console / 后续接 Langfuse |
章节顺序
- 01-最小 Agent Harness 骨架 —
streamText+ tools +maxSteps+traceId - 02-加护栏与审批门（HITL） — 写操作挂起、白名单、步数监测
- 03-加 Eval Harness 回归 — 10 条 Golden + CI 本地命令
每个阶段交付标准
- 能跑：
npm run dev端到端 - 可控：maxSteps、abort、tool 校验
- 可讲：面试 2 分钟说清 Harness 四层（编排 / 网关 / 护栏 / trace）
- 可回归（第 3 篇）：
npx promptfoo eval通过
与知识库交叉引用
- 理论：Harness 专题
- Agent：[Agent工作流与MCP落地](../../06-实时多模态与 Agent/Agent工作流与MCP落地.md)
- 工程化：[AI工程化流程与团队协作](../../07-AI工程化与 Skill/AI工程化流程与团队协作.md)