照命

照命 是一个纯开源、无广告的现代化 AI 传统命理排盘与分析系统。

我们致力于打破传统算命网站充斥广告、页面嘈杂且带有迷信色彩的现状，用克制的视觉语言、理性的数据推演与现代大模型（LLM），提供一个干净、现代的数字命理工作台。

🔮 已支持命理门类

项目核心提供以下数术门类的排盘与测算，且均已接入 AI 智能流式解盘（Streaming）：

• 八字排盘：提供八字大运、十神、神煞、五行分析。
• 紫微斗数：支持 4x4 中空环形星盘绘制。
• 三式排盘：支持奇门遁甲、太乙神数、大六壬。
• 六爻占卜：提供起卦与装卦排盘。
• 梅花易数：提供起卦、体用及基础断语。
• 称骨算命：提供袁天罡称骨斤两计算。

在线地址

• 生产域名：https://www.zhaoming.app
• 部署平台：Vercel

技术栈

• Next.js 16.2.6 + App Router
• React 19.2.4
• TypeScript 5
• Tailwind CSS 4
• shadcn/ui（new-york 风格）
• Radix UI
• React Hook Form + Zod
• Better Auth
• Neon Postgres
• Vercel AI SDK 6
• OpenAI-compatible Provider（当前默认用于接 OpenRouter）
• lunar-typescript
• iztro

本地开发

项目统一使用 Bun 作为包管理器。

环境变量

复制 .env.example 为 .env.local：

cp .env.example .env.local

根据 .env.example 文件中的注释说明，在 .env.local 中填写你的本地数据库、Better Auth 鉴权以及大模型等环境变量。

安装与启动

1. 安装依赖：

   bun install

2. 初始化数据库：
   • 生成/迁移 Better Auth 认证表：bunx better-auth migrate（若使用 Neon Auth 托管则在后台开启即可）。
   • 按文件名编号顺序依次执行 db/migrations/ 目录下的业务 SQL 脚本。
3. 运行开发服务器：

   bun run dev

本地默认访问地址为 http://localhost:5555。可以使用 bun run lint 或 bun run build 进行代码规范检查与编译。

补充说明：

• 本地默认地址为 http://localhost:5555
• 鉴权相关环境变量如果误拉成生产域名，开发环境会优先回退到本地地址，避免 Google OAuth 出现 Invalid origin

目录结构

src/
  app/
    (marketing)/
    (auth)/
    (dashboard)/
    api/
  components/
    divination/
      bazi-basic-info-card.tsx    # 八字基本信息卡片与复制入口
      bazi-chart.tsx              # 八字排盘基础信息与四柱详解
      bazi-dayun-analysis.tsx     # 八字大运详情与十年运势卡片
      bazi-insights.tsx           # 八字分析区组合：五行、十神、神煞、大运
      bazi-pillars-info-card.tsx  # 八字四柱详解卡片与复制入口
      bazi-shensha-analysis.tsx   # 八字神煞分析四柱分栏
      bazi-ten-god-analysis.tsx   # 八字十神分析四柱分栏
      bazi-verdict-card.tsx       # 八字 AI 判词卡片与流式生成入口
      birth-place-input.tsx       # 出生地搜索输入
      chart-shell.tsx             # 简单命盘图表外壳
      copy-content-button.tsx     # 客户端复制按钮
      divination-form.tsx         # 新建测算表单
      wuxing-analysis-card.tsx    # 可复用五行分析卡片
      wuxing-badge.tsx            # 五行彩色徽章
      wuxing-radar-chart.tsx      # SVG 五行雷达图
      ziwei-chart.tsx             # 紫微斗数 4 x 4 宫位网格
    layout/
    prose/
    ui/
  lib/
    ai/
    auth/
    divination/
    blog/
    db.ts
    auth.ts
    auth-client.ts
  types/
db/
  migrations/

鸣谢与致敬

本项目在设计灵感与工程实现上参考或使用了以下优秀项目，在此致以诚挚的感谢：

• FateMaster.AI：启发了本项目的产品定位与现代化交互设计理念。
• next-shadcn-dashboard-starter：本项目后台工作台布局及骨架结构基于此进行定制与二次开发。