🌌 fate · 天命之名

基于八字五行 · 三才五格 · 周易卦象 · 诗词出处的智能起名引擎
FATE — Celestial Naming Engine

English | 中文

✨ 功能亮点

📸 界面预览

💡 提示：Web 界面运行在 http://localhost:18080，启动服务器后即可访问。

首页	命名结果

候选名册（表格）	候选名册（卡片）

🚀 快速开始

环境要求

• Go 1.22+
• Bun（前端开发需要，生产部署无需）

安装 & 运行

# 克隆项目
git clone https://github.com/babyname/fate.git
cd fate

# 下载依赖
go mod download

# 初始化数据库（必需）
go run ./cmd/dbinit

# 启动 Web 服务
go run ./cmd/server
# 访问 http://localhost:18080

CLI 命令行

# 编译
go build -o fate ./cmd/console

# 生成名字
./fate name -s 张 -b "2024/06/15 10:30" -g boy

═══════════════════════════════════════
           Top 10 推荐名字
═══════════════════════════════════════
  #1  张适抡  评分:90.1  等级:上上  五行:火火
      天格:凶 人格:吉 地格:半吉 总格:吉
      三才:木水水(大吉)

  #2  张粮屠  评分:90.1  等级:上上  五行:火火
  #3  张适晶  评分:90.1  等级:上上  五行:火火
  ...
───────────────────────────────────────
  全部候选名字共 10000 个
═══════════════════════════════════════

═══════════════════════════════════════
  张适抡  评分: 90.1  等级: 上上
═══════════════════════════════════════
  【五格分析】
  天格:12(凶)  人格:29(吉)  地格:30(半吉)
  外格:13(吉)  总格:41(吉)
  三才: 木水水(大吉)

  【八字分析】
  四柱: 甲辰 庚午 庚戌 乙酉
  喜神: 火  忌神: 金

  【周易卦象】
  本卦: 水山蹇  变卦: 地山谦

  【评分明细】
  文化:86  五行:94  生肖:94  五格:89  音韵:89
═══════════════════════════════════════

CLI 参数

🔌 Web API

启动服务器后可用：

生成请求示例

curl -X POST http://localhost:18080/api/generate \
  -H "Content-Type: application/json" \
  -d '{
    "surname": "张",
    "born": "2024/06/15 10:30",
    "sex": "boy",
    "poetry_mode": 2,
    "avoid_chars": ["病", "死"]
  }'

🧩 代码集成

go get github.com/babyname/fate/v4

package main

import (
    "fmt"
    "time"

    "github.com/babyname/fate/v4"
    "github.com/babyname/fate/v4/config"
)

func main() {
    cfg := config.DefaultConfig()
    f, _ := fate.New(cfg)

    filter := fate.NewFilter(fate.FilterOption{
        CharacterFilter:     true,
        CharacterFilterType: fate.CharacterFilterTypeDefault,
        MinStroke:           3,
        MaxStroke:           18,
        RegularFilter:       true,
        DaYanFilter:         true,
        WuXingFilter:        true,
        AvoidCharacters:     []string{"病", "死", "穷"},
    })

    s := f.NewSessionWithFilter(filter)
    born, _ := time.Parse("2006/01/02 15:04", "2024/06/15 10:30")
    input := &fate.Input{
        Last: [2]string{"张", ""},
        Born: born,
        Sex:  fate.SexBoy,
    }

    s.Start(input)
    s.Wait()

    // 获取结果
    output := input.Output()
    for _, nr := range output.TopNames() {
        fmt.Printf("%s - %.1f (%s)\n", nr.FullName, nr.Score, nr.Grade)
    }

    // ExcellentTable: 流式 Top-N 访问
    table := output.GetExcellentTable()
    entries := table.TopN(10)
    for _, e := range entries {
        fmt.Printf("%s%s - %.1f has_poetry=%v\n", e.Char1, e.Char2, e.Score, e.HasPoetry)
    }

    // Explore: 随机采样 + 条件过滤
    explored := table.Explore(10, func(e fate.ExcellentEntry) bool {
        return e.HasPoetry
    })
    for _, e := range explored {
        fmt.Printf("%s%s - %.1f\n", e.Char1, e.Char2, e.Score)
    }
}

核心 API

🏛️ 架构

┌─────────────────────────────────────────────┐
│                  fate CLI / Server           │
├─────────────────────────────────────────────┤
│  cmd/console     │  cmd/server               │
│  (CLI 工具)     │  (HTTP API + 嵌入式前端)   │
├─────────────────────────────────────────────┤
│               internal/http                  │
│               (API 路由 & 中间件)             │
├─────────────────────────────────────────────┤
│                  fate 核心引擎                │
│  ┌──────────┬──────────┬──────────────────┐ │
│  │ Session  │ Filter   │ ExcellentTable   │ │
│  │ 异步生成 │ 多级筛选  │ 流式Top-N        │ │
│  ├──────────┼──────────┼──────────────────┤ │
│  │ Bazi     │ Wuge     │ Zhouyi           │ │
│  │ 八字推算 │ 五格数理  │ 周易卦象          │ │
│  └──────────┴──────────┴──────────────────┘ │
├─────────────────────────────────────────────┤
│              chronos/v2 (八字引擎)            │
│              yi (周易引擎)                    │
│              Ent ORM (数据层)                 │
├─────────────────────────────────────────────┤
│              SQLite3 (数据存储)               │
│              character.json (汉字数据库)       │
│              chinese-poetry (诗词库)          │
└─────────────────────────────────────────────┘

目录结构

fate/
├── cmd/                # 命令行入口
│   ├── console/        #   主 CLI（name / dbinit / dictctl）
│   ├── server/         #   Web 服务
│   ├── dbinit/         #   数据库初始化
│   ├── character/      #   汉字数据工具
│   ├── dictctl/        #   字典管理工具
│   └── tools/          #   开发调试工具
├── config/             # 配置定义
├── data/               # 种子数据
│   ├── chinese-poetry/ #   诗词库
│   └── seed/           #   基础数据
├── docs/               # 文档 & 截图
├── ent/                # Ent Schema & 生成代码
├── internal/           # 内部包
│   ├── chronosfate/    #   chronos 适配层
│   ├── http/           #   HTTP API
│   └── ...
├── model/              # 数据模型
├── resources/          # 嵌入式资源
│   ├── character.json  #   汉字元数据库
│   └── static/         #   Web 前端构建产物
├── scripts/            # 构建脚本
└── web/                # React 前端源码
    └── src/
        ├── components/ # UI 组件
        ├── pages/      # 页面
        ├── lib/        # API 客户端 & 工具
        └── store/      # 状态管理 (Zustand)

📐 五维评分体系

🌿 喜用神算法

平衡用神法

基于日主强弱，通过同党/异党力量对比取用神：

格局用神法

先定格局（正官/七杀/食神/伤官/正财/偏财/建禄/阳刃等 10 种），再按格局取用神。

🔀 分支策略

⚠️ 历史原因：v3 分支的模块路径不含 /v3（早期 Go module 规范未强制要求）。 从 v4 开始引入 /v4 后缀，未来 v5 也将统一使用 /v5。

版本标签

🛠️ 技术栈

🧪 开发

# 前端开发（热更新）
cd web && bun install && bun run dev

# 后端开发
go run ./cmd/server

# 构建生产版本
cd web && bun run build    # 前端构建 → resources/static/
go build -o fate ./cmd/console    # CLI 工具
go build -o fate-server ./cmd/server  # 服务器（含嵌入式前端）

# 运行测试
go test ./...

# 代码检查
golangci-lint run

📄 License

MIT © babyname