用途：chatbot-template 是 shadcn/ui 提供的极简、有主见的 Next.js 起步模板，用于搭建 AI 聊天机器人，省去从零手写 useChat、流式输出与 Markdown 渲染。适合新建 Next.js AI 聊天应用、添加自定义工具、调整模型列表或联网搜索、在公开流量前加固 /api/chat。
主要能力：流式 Markdown 响应（react-markdown + shadcn/typeset）、类型化工具调用、提供商原生联网搜索，以及模型可触发的人工确认 ask_user 问卷。部署到 Vercel 零配置，AI Gateway 通过 OIDC 自动认证；本地则用网关 API 密钥运行。
使用方式：克隆仓库后执行 pnpm install，再通过 vercel link 与 vercel env pull 获取 OIDC 令牌，或在 Vercel 控制台创建 API 密钥并写入 .env.local 的 AI_GATEWAY_API_KEY，然后 pnpm dev。模型列表在 lib/models.ts 配置，首项为默认模型，isModelAllowed() 限制 /api/chat 可用模型。自定义工具放在 tools/<name>.ts，导出 tool() 的 description、inputSchema 与 execute（UI 回答型工具省略 execute），并在 tools/index.ts 注册，再在 components/parts/ 添加部件组件、在 components/chat-message.tsx 添加对应 case。可用 npx shadcn@latest add button 添加 UI 组件。
限制：模板不含持久化聊天历史、多用户认证或数据库，需自行构建；仅面向 Next.js App Router 与 React 技术栈；/api/chat 默认公开且无认证，每个请求都会消耗 AI Gateway 额度，上线前应做限流、设置消费上限并按需加认证。请使用 pnpm，仓库自带 pnpm-lock.yaml 与 pnpm-workspace.yaml。交接前运行 pnpm lint、pnpm typecheck、pnpm build 验证。