妙名阁 · 东方美学 AI 取名

以诗取名 · 以韵择字 —— 为宝宝、品牌与每一个重要命名，做一场有仪式感的东方推演。

妙名阁是一款面向中文家庭的全栈取名产品：在浏览器中实时完成「音韵、字义、五行、字形」四维推演，把冰冷的算法结果，变成可读、可感、可分享的命名体验。

✨ 核心体验

• 四维推演引擎：音律节奏（平仄/声韵避重）、字义寓意、五行生克、字形结构综合评分；结果实时生成，推演过程逐字可见——从「候选字规模已定」到「已推演 N 个组合 · 暂留 M 个候选」，让每一次取名都像一场真实的演算。
• 三行点评：每个名字都配三行“人话”点评——音律怎么顺耳、字义如何成画、五行气质是什么，读完就懂好在哪。
• 结果管理：搜索（名字/拼音）、排序（推荐/分数/笔画/五行）、收藏与排除、分页浏览。
• 详情页：逐字解析（释义/详解/诗词出处/笔画/结构/美感分）、字形评价、小名与乳名推荐（支持生辰解锁“按生辰而来”、生肖呼应、风格定制、换一批）。
• 家庭投票：收藏候选 → 全家人在同一页面上即点即投（爸爸/妈妈/长辈/自定义成员），实时票数排行；一键生成投票文案与水墨投票卡，发到家庭群继续比选。
• 分享卡片：微信友好文字名片 + 原生 Canvas 绘制的水墨风分享卡（大名字、拼音、评分、五行、寓意），无需任何额外依赖。
• 授权码机制：可选的轻后端（/api.php）完成授权码绑定、设备数与有效期管理；无后端时可用测试码直连本地体验。
• 移动端与无障碍：375px 小屏全流程可用，触控目标 ≥44px，支持用户缩放，图标按钮全部带 aria-label。

🛠 技术栈

• 框架：Next.js 16（App Router + Turbopack）+ TypeScript
• UI：React 19、Framer Motion、原生 Canvas（分享卡/投票卡）
• 数据：自研汉字库（3000+ 候选字：释义、诗词、五行、笔画、结构、美感分、小名）、姓氏表、小名模板库
• 测试：Playwright（桌面/移动端 e2e 回归）+ tsx 引擎级测试
• 可选后端：PHP（api.php）——授权码签发、设备绑定、使用统计

🔌 授权体系与扩展点

• 前端与后端的唯一通信入口是 src/lib/apiClient.ts，页面层不直接请求授权接口。
• 授权后端可整体替换为外部「统一卡密管理站点」：保持 validateCode / getStatus 等函数签名不变，仅替换 request 内的 API_BASE 与报文格式；或新增 authAdapter.ts 实现同一组函数，App 层无需改动。
• 前端依赖的授权字段：code / status / expires_at / valid_days / bound_surname / device_count / max_devices / error_type。
• 本地联调可用 NEXT_PUBLIC_API_BASE 指向任意后端；无后端时可用测试码 MMG-TEST-DEMO-2026 直接体验。

🚀 快速开始

npm install
npm run dev        # http://localhost:3000

本地体验无需后端：授权页输入测试码 MMG-TEST-DEMO-2026 即可。

npm run build      # 生产构建
npm run start      # 生产预览
npm run lint       # ESLint

测试

npx tsx tests/verify-homophone-guard.ts   # 谐音安全护栏
npx tsx tests/review-lines-test.ts        # 三行点评生成
npx tsx tests/chunked-progress-test.ts    # 推演进度单调性
npx playwright test tests/e2e-regression.spec.ts  # 桌面+移动端全流程回归
npx playwright test tests/e2e-vote-review.spec.ts # 家庭投票+三行点评

📁 目录结构

src/
  app/            # 页面：授权 / 输入 / 推演 / 报告 / 结果 / 详情
  lib/
    nameEngine.ts      # 四维评分 + 推演引擎（同步/分块异步）
    charData.ts        # 汉字库
    nicknameEngine.ts  # 小名/乳名推荐引擎
    shareCard.ts       # 文字名片 + 水墨分享卡/投票卡绘制
    familyVote.ts      # 家庭投票本地状态
    apiClient.ts       # 授权码后端通信
    store.ts           # 全局状态与本地持久化
public/
  data/            # 汉字库 / 姓氏 / 小名模板 / 点评模板等数据
tests/             # 引擎级 + Playwright e2e
docs/screenshots/  # 产品截图

📸 产品截图

输入页	报告页	结果页	详情页

⚠️ 说明

妙名阁基于音韵学、汉字学及传统五行理论提供取名参考，旨在提供文化层面的灵感与建议。名字的最终选择权在于家长，建议结合家庭文化背景与个人喜好综合考量。