诗名 — 以诗为名，不负韶华

基于古诗词的智能取名网站。输入姓氏，从诗经、楚辞、唐诗、宋词等经典中精选有出处的好名字。

• 诗词取名 — 从精选诗句库中提取灵感，AI 创意组合，每个名字都有出处
• 详细释义 — 点击名字查看原文、释义、寓意、意境、音韵分析
• 拼音标注 — 自动生成拼音和平仄声调
• 性别偏好 — 支持选择男孩名 / 女孩名 / 不限
• 诗集筛选 — 可指定从诗经、楚辞、唐诗、宋词等特定诗集中取名
• 收藏功能 — 本地收藏喜欢的名字，方便对比
• 换一批 — 每次推荐 6 个名字，不满意可以换一批（会话内去重）
• 古风 UI — 宣纸白底、赭石色主调，Ma Shan Zheng / Noto Serif SC 字体

• Next.js 16 (App Router) + React 19 + TypeScript
• Tailwind CSS 4
• Framer Motion（动效）
• pinyin-pro（拼音转换）
• AI API：支持火山引擎 ARK（豆包）/ DeepSeek / OpenAI

git clone <your-repo-url>
cd name-web

npm install

cp .env.example .env.local

编辑 .env.local，填入你的 AI API Key：

# 火山引擎 ARK（豆包）— 推荐
AI_API_KEY=your-api-key-here
AI_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
AI_MODEL=doubao-seed-2-0-pro-260215

# DeepSeek — 备选
# AI_API_KEY=your-api-key-here
# AI_BASE_URL=https://api.deepseek.com/v1
# AI_MODEL=deepseek-chat

# OpenAI — 备选
# AI_API_KEY=sk-xxx
# AI_BASE_URL=https://api.openai.com/v1
# AI_MODEL=gpt-4o-mini

三选一即可。推荐使用火山引擎 ARK（豆包），性价比高。

npm run dev

打开浏览器访问 http://localhost:3999。

最简单的部署方式，适合个人项目：

1. 将代码推送到 GitHub
2. 在 Vercel 导入该仓库
3. 在 Vercel 项目设置 → Environment Variables 中添加：
   • AI_API_KEY = 你的 API Key
   • AI_BASE_URL = API 地址
   • AI_MODEL = 模型名称
4. 部署完成，Vercel 会自动分配域名

适合自有服务器：

# 1. 安装依赖
npm install

# 2. 构建生产版本
npm run build

# 3. 启动生产服务器
npm start

默认监听 3999 端口。可通过 --port 参数临时指定端口：

npm start -- --port 8080

项目已包含 Dockerfile（多阶段构建）和 .dockerignore，容器内默认端口为 3999。

提供两套 Docker Compose 配置：

本地构建镜像并运行，适合开发调试：

# 构建并启动（自动停旧容器 + 重建）
docker compose -f docker-compose.local.yml up -d --build

# 强制重建（即使没有变化）
docker compose -f docker-compose.local.yml up -d --build --force-recreate

# 查看日志
docker compose -f docker-compose.local.yml logs -f

# 停止
docker compose -f docker-compose.local.yml down

从腾讯云容器镜像仓库（TCR）拉取镜像，使用 Caddy 作为反向代理（自动 HTTPS）：

# 先登录镜像仓库
docker login ccr.ccs.tencentyun.com -u <username>

# 拉取最新镜像并重建容器
docker compose pull && docker compose up -d --force-recreate

# 查看日志
docker compose logs -f

服务器版 Compose 包含两个服务：

• web — Next.js 应用（不直接暴露端口）
• caddy — 反向代理，监听 80/443，自动申请和续期 Let's Encrypt 证书

CI/CD 会自动通过 GitHub Actions 完成构建、推送、部署全流程，通常无需手动操作。

两种方式的环境变量均通过 .env.local 文件注入。

说明：next.config.ts 已配置 output: 'standalone'，生产镜像约 ~150MB，仅包含运行所需的最小依赖。

src/
├── app/
│   ├── api/generate-names/   # 取名 API 接口
│   ├── globals.css           # 全局样式（古风主题）
│   ├── layout.tsx            # 根布局
│   └── page.tsx              # 首页
├── components/               # UI 组件
│   ├── NameCard.tsx          # 名字卡片
│   ├── NameDetail.tsx        # 名字详情（释义/寓意）
│   ├── NameGrid.tsx          # 名字网格
│   ├── PreferenceForm.tsx    # 偏好设置表单
│   └── FavoriteBar.tsx       # 收藏栏
├── data/
│   └── curated-verses.json   # 精选诗句库
├── hooks/                    # React Hooks
│   ├── useNameGenerator.ts   # 取名逻辑
│   └── useFavorites.ts       # 收藏逻辑
└── lib/
    ├── ai.ts                 # AI 调用（支持 ARK / OpenAI 兼容格式）
    ├── poetry.ts             # 诗词数据检索
    ├── pinyin.ts             # 拼音工具
    └── types.ts              # 类型定义

MIT