传统命理算法（五格剖象、八字四柱、五格数理、生肖、星座、解梦、鲁班尺……）的原创重做， 统一架构：每个栏目都先给确定性的免费结果，再用一键「完整详批」按需调用 AI 深化。 传统取名/命理方法本身是公共知识，可自由使用；本仓库是全新原创的代码与品牌。
| 栏目 | 确定性免费底座 | 一键详批（DeepSeek） |
|---|---|---|
| 姓名测试 | 康熙全字库五格 · 八字/大运 · 三才 · 音韵 · 字义 · 财官 · 喜用 · 幸运 · 置信度 | 取名契合度 · 谐音 · 名人用例 · 诗词推荐 |
| 八字占卜 | lunar-javascript 真节气排盘（四柱/藏干/十神/纳音/旬空/胎元命宫） | 12 段命理详批 |
| 号码吉凶 | 五格数理归一 + 吉凶等级 | 数理 / 五行 / 事业 / 财运详解 |
| 星座查询 / 配对 · 生肖查询 / 配对 | 元素 / 六合六冲三合 + 契合分 | 性格 / 感情 / 相处 / 婚配详批 |
| 周公解梦 | 142 意象词典（传统 + 心理 + 宜忌 + emoji） | 整段梦境串解 |
| 血型 · 风水 | ABO 遗传推算 · 鲁班尺吉数 | 性格相性 · 居家布局建议 |
| AI 起名 / 公司起名 / 品牌起名 | — | DeepSeek 生成候选（每个自动算数理/五行/读音） |
- Next.js 14（App Router）+ TypeScript + Tailwind CSS
- DeepSeek（OpenAI 兼容，
response_format: json_object）— 详批 / 起名层，带重试与结果缓存 - lunar-javascript — 真节气八字排盘 · pinyin-pro — 音韵 · Zod — 入参校验
- Vitest — 核心算法单测（五格 / 八字 / 数理 / 生肖 / 限流）
npm install
cp .env.example .env.local # 填入你的 DEEPSEEK_API_KEY
npm run dev # http://localhost:3000| 变量 | 必填 | 说明 |
|---|---|---|
DEEPSEEK_API_KEY |
✅ | DeepSeek Key（申请）。缺失时确定性结果照常，详批/起名不可用。 |
DEEPSEEK_MODEL |
默认 deepseek-chat（V3） |
|
RATE_LIMIT_PER_MIN |
每 IP 对 /api/* 每分钟上限，默认 60 |
|
DEEPSEEK_MAX_PER_MIN |
全局每分钟 DeepSeek 调用上限（预算硬顶），默认 60 | |
INTERPRET_CACHE_TTL_MS |
详批结果缓存时长，默认 86400000（24h） |
.env.local已被.gitignore忽略，密钥不会进仓库。
npm run typecheck # tsc --noEmit
npm run lint # next lint
npm test # vitest（核心算法 + 限流）
npm run db:check # 可选：已配置 DATABASE_URL 时，检查/初始化真实支付订单库
npm run inventory # 项目体检：路由/API/接闸表/测试/最大文件（纯静态，不依赖密钥；--json 出 JSON）运营数据（clean 口径）：后台流量真实指标读 /api/admin/insights 返回的 data.clean——topPages（已剔后台/测试路径）、referrers（已剔本机/内网）、excludedPathPv / internalRefPv / directPv。raw 字段（topPages/totals）保留全量可审计；转化判断以 clean 为准。后台流量页按 UI 治理约定不单设「页面排行」面板，clean 指标统一从该接口读取。
CI 配置在 docs/ci.yml（typecheck → lint → test → build）。工作流文件不随 git 推送：推送令牌无 workflow 权限，且仓库刻意不跟踪 .github/workflows/（见 .gitignore），保证日常 git push 不被 GitHub 的 workflow-scope 闸拦下。
启用 CI（一次性，走网页）：GitHub 仓库 → Add file → Create new file → 路径 .github/workflows/ci.yml → 粘贴 docs/ci.yml 内容 → Commit（网页用你账号的完整权限，不受 CLI 令牌限制）。
- Vercel 用 GitHub 登录 → Import 本仓库；Framework 自动识别 Next.js，全默认。
- Environment Variables 里加
DEEPSEEK_API_KEY（其余有默认值）。 - Deploy。
vercel.json已把函数区域钉到香港（hkg1，离 DeepSeek 更近）； 各 DeepSeek 路由已设maxDuration = 60（详批约 20s，覆盖 Vercel 默认 10s 超时）。
内置 MCP（Model Context Protocol）服务器，把确定性命理工具暴露给任意 MCP 兼容的 AI Agent：
- 端点：
POST /api/mcp（Streamable HTTP，JSON-RPC 2.0：initialize/tools/list/tools/call） - 工具：
analyze_name（姓名）·bazi_chart（八字）·numerology_number（号码）·dream_lookup（解梦）·shengxiao_by_year（生肖）·xingzuo_by_date（星座）—— 均免费、确定性、无副作用 - 自述：
/llms.txt；robots.txt显式欢迎 GPTBot / ClaudeBot 等 AI 爬虫
实现见 app/api/mcp/route.ts。
三层防护，零路由侵入：
- 每 IP 限流（
middleware.ts）：单 IP 对/api/*限速，超出返回 429 +Retry-After。 - 全局 DeepSeek 上限（
lib/ai.ts）：每分钟总调用封顶，超过即优雅拒绝 —— 预算硬顶。 - 详批结果缓存（
lib/ai.ts）：相同输入按 hash 缓存，不重复付费（实测 ~600× 提速）。
⚠️ 限流/缓存为进程内存级：单实例 / 自托管（next start）完全有效；多实例 / serverless 上每实例独立，属「尽力而为」第一层。要强一致，把lib/rate-limit的 Map 换成 Upstash / Vercel KV 即可。💡 最稳的兜底：在 DeepSeek 后台充固定小额、关自动续费，让绝对损失有硬上限。
新增一个栏目（checklist）——全站同构，照抄任意现有栏目即可，步骤固定：
lib/columns.ts注册：key/name/href/group/desc/Icon（单页栏目加noFull: true）；lib/seo.ts的COLUMN_SEO加 标题/描述/keywords；有/full的再补FULL_TITLES；app/<key>/layout.tsx：三行模板（columnMetadata+columnGraph），/full用fullMetadata；app/api/<key>/route.ts：确定性计算免费先出；要详批就接generateInterpretation+interpretationSSE（zod 加detail/stream），提示词末尾拼${PLAIN_TALK}；app/<key>/page.tsx：确定性结果 + 「完整详批」按钮（streamDetail流式）+track("detail_click")；适合分享的加SharePosterButton，详批后可加FollowUpChat与FaqSection（问答写进lib/faq.ts）；- 算法是新写的就进
lib/并在tests/锁锚点；npm run typecheck && npm run lint && npm test全绿再提交。
约定：确定性计算放 lib/（纯函数、必须可单测），页面只做渲染与交互；新算法没有锚点单测不合并；提示词不得出现「AI 生成」类字样；密钥只进 .env.local/服务器环境变量。
五格、八字、星座、生肖、血型、风水等均属传统民俗文化，结果仅作参考，不构成任何专业建议。