基于 AI Agent 的中文宝宝起名工具。通过 17 张卡片式交互收集 6 维用户偏好，结合大语言模型生成有文化内涵的名字，探探式滑动选名。

在线体验 →

• 卡片式交互 - 17 张卡片覆盖 6 个维度（基本信息、期望寓意、家族信息、文化偏好、生活背景、自由补充），渐进式收集用户偏好
• 探探风格滑动 - 结果页采用 Tinder/探探式左右滑动卡片，右划收藏、左划跳过
• 语音输入 - 文本输入卡片和自由补充支持语音输入，基于智谱 GLM-ASR 语音识别
• 快速起名 - 首页输入姓氏 + 选择性别即可直接跳到 AI 生成，无需走完整卡片流程
• AI 生成 - 调用智谱 GLM-4 大模型，结合 6 维用户上下文生成 5 个有文化内涵的名字
• Apple 风格动效 - 完整的运动设计系统：iOS 缓动曲线、弹簧物理、交错入场、手势反馈
• 移动端优先 - 针对手机端设计，暖色调 UI、毛玻璃卡片、流畅动画

系统采用四层架构设计：

本系统采用 Structured Prompt Engineering 模式（非 ReAct Agent，非 RAG 检索增强），通过精心设计的 Prompt 模板将多维用户上下文注入单次 LLM 调用：

上下文收集 → Prompt 构建 → 单轮 LLM 推理 → JSON 提取 → 结构化输出

五阶段流水线：

1. 上下文收集 — 17 张卡片收集 Partial<UserContext>（17 个字段，6 组分类）
2. Prompt 构建 — buildPrompt() 将 6 维上下文通过模板插值注入结构化 Prompt，包含系统角色（"起名大师"）、6 段上下文、JSON Schema、5 条约束
3. LLM 推理 — 单次调用 GLM-4（temperature: 0.8 提高创造性，AbortController 30s 超时）
4. 输出解析 — 正则 /\[\s*\{[\s\S]*?\}\s*\]/ 鲁棒提取 JSON，字段校验与归一化
5. 结构化输出 — 生成 5 个 GeneratedName，每个含 6 维结构化信息

buildPrompt() 将 17 张卡片的用户输入整合为 6 维上下文：

每个名字包含 6 个维度的结构化输出：

{
  "givenName": "名字",
  "pinyin": "完整拼音（含声调）",
  "meaning": "含义解释（每个字的含义和整体寓意）",
  "source": "诗词典故出处",
  "wuxingAnalysis": "五行分析（每个字的五行属性及组合关系）",
  "personalConnection": "与用户上下文的个人关联"
}

通过 MediaRecorder API 录制音频，调用智谱 GLM-ASR 进行语音转文字，支持 webm/mp4/ogg/wav 多种格式自动检测。

系统通过 Zustand 全局 Store 管理所有状态，支持两条用户路径：

• Path A（完整流程）：首页 → 17 张卡片顺序输入 → AI 生成 → 滑动选名 → 结果汇总
• Path B（快速生成）：首页输入姓氏 + 性别 → 直接跳到 AI 生成

核心状态：currentCardIndex、context: Partial<UserContext>（17 字段）、generatedNames: GeneratedName[]、isGenerating、favoriteIds: string[]（localStorage 持久化）

1. 首页 - 点击「开始起名」进入完整流程，或输入姓氏 + 选择性别「马上起名」快速生成
2. 卡片交互 - 依次回答 17 个问题（可跳过非必填项），文本输入支持语音
3. AI 生成 - 提交后 AI 根据 6 维上下文信息生成 5 个推荐名字
4. 滑动选名 - 左右滑动浏览名字，右划收藏、左划跳过
5. 结果汇总 - 浏览完毕后查看收藏列表，可「换一批」重新生成

基于 Apple 设计理念构建的运动设计系统（lib/motion.ts），四大核心原则：

1. 物理真实感 - 基于弹簧动画（Spring Physics），模拟真实物理运动
2. 层次分明 - 页面元素按优先级依次入场（Stagger Animation）
3. 即时反馈 - 点击/触摸立即响应，无感知延迟（100ms 内）
4. 含蓄优雅 - 动画服务于功能，不喧宾夺主

name-agent/
├── app/
│   ├── page.tsx                  # 首页（开始起名 + 快速生成）
│   ├── layout.tsx                # 根布局
│   ├── globals.css               # 全局样式 + 动画变量 + 暖色主题
│   ├── flow/page.tsx             # 卡片交互流程页
│   ├── result/page.tsx           # 结果页（探探式滑动卡片）
│   └── api/
│       ├── generate/route.ts     # AI 起名 API（GLM-4）
│       └── transcribe/route.ts   # 语音转文字 API（GLM-ASR）
├── components/
│   ├── VoiceButton.tsx           # 通用语音按钮组件
│   ├── cards/
│   │   ├── CardStack.tsx         # 卡片流程容器（进度条、导航、动画）
│   │   ├── TextInputCard.tsx     # 文本输入卡片（带语音）
│   │   ├── SelectCard.tsx        # 单选卡片（弹簧动画）
│   │   ├── MultiSelectCard.tsx   # 多选卡片（交错入场）
│   │   ├── SliderCard.tsx        # 滑块卡片
│   │   ├── DatePickerCard.tsx    # 日期选择卡片（带时辰）
│   │   └── VoiceInputCard.tsx    # 语音输入卡片
│   └── ui/                       # Shadcn/UI 组件
├── hooks/
│   └── useVoiceInput.ts          # 语音录制 + ASR Hook
├── stores/
│   └── flow-store.ts             # Zustand 全局状态
├── lib/
│   ├── motion.ts                 # Apple 风格运动设计系统
│   ├── types.ts                  # TypeScript 类型定义
│   ├── cards-config.ts           # 17 张卡片配置（6 组）
│   ├── utils.ts                  # 工具函数
│   └── ai/
│       ├── client.ts             # 智谱 AI 客户端
│       └── prompt.ts             # 结构化 Prompt 构建
└── public/screenshots/           # 产品截图 + 架构图

• Node.js 18+
• 智谱 AI API Key (获取地址)

# 克隆项目
git clone https://github.com/ava-agent/name-agent.git
cd name-agent

# 安装依赖
npm install

# 配置环境变量
cp .env.local.example .env.local
# 编辑 .env.local，填入你的 API Key

# 启动开发服务器
npm run dev

MIT