Fate 是一款现代科学中文名创建工具。
基于八字五行 · 三才五格 · 周易卦象 · 诗词出处的智能起名引擎
FATE — Celestial Naming Engine
English | 中文
八字推命
|
多维评分
|
Web 界面
|
⚡ 高性能
|
提示：Web 界面运行在
http://localhost:18080，启动服务器后即可访问。
| 首页 | 命名结果 |
|---|---|
| 候选名册（表格） | 候选名册（卡片） |
|---|---|
# 克隆项目
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# 编译
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 个
═══════════════════════════════════════详细分析（name detail）：
═══════════════════════════════════════
张适抡 评分: 90.1 等级: 上上
═══════════════════════════════════════
【五格分析】
天格:12(凶) 人格:29(吉) 地格:30(半吉)
外格:13(吉) 总格:41(吉)
三才: 木水水(大吉)
【八字分析】
四柱: 甲辰 庚午 庚戌 乙酉
喜神: 火 忌神: 金
【周易卦象】
本卦: 水山蹇 变卦: 地山谦
【评分明细】
文化:86 五行:94 生肖:94 五格:89 音韵:89
═══════════════════════════════════════| 参数 | 简写 | 说明 | 示例 |
|---|---|---|---|
--surname |
-s |
姓氏 | -s 张 |
--born |
-b |
出生日期与时刻 | -b "2024/06/15 10:30" |
--gender |
-g |
性别 | -g boy / -g girl |
--xiyong |
喜用神算法 | balance（平衡法）/ geju（格局法） |
|
--strictness |
五格严格度 | loose / moderate / strict |
|
--filter |
-f |
过滤汉字 | -f 病死穷 |
--output |
-o |
输出到文件 | -o result.txt |
启动服务器后可用：
| Method | Endpoint | 说明 |
|---|---|---|
GET |
/health |
健康检查 |
POST |
/api/generate |
异步生成名字（返回 task_id） |
GET |
/api/task/:id |
查询任务状态 |
GET |
/api/names/:taskId |
分页获取名字列表 |
GET |
/api/name-detail |
名字详细分析 |
GET |
/api/explore/:taskId |
随机探索名字 |
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…| 类型 | 说明 |
|---|---|
fate.New(cfg) |
创建引擎实例 |
fate.NewSessionWithFilter(filter) |
创建带筛选器的会话 |
fate.NewFilter(option) |
创建筛选器 |
fate.FilterOption |
筛选选项（笔画/五行/大衍/性别/避用字等） |
fate.Input |
输入（姓氏/生日/性别） |
fate.Output |
输出（TopNames/ExcellentTable/CharMap） |
fate.ExcellentTable |
流式 Top-N 结构（TryPush/Finalize/TopN/Explore） |
……| 维度 | 权重 | 评分依据 |
|---|---|---|
| 文化印象 | 20% | 常用度、正体字、字义丰富度、文化关联 |
| 五行八字 | 25% | 名字五行与日主喜用神匹配度 |
| 生肖 | 10% | 生肖五行与名字五行的生克关系 |
| 五格数理 | 25% | 天格/人格/地格/外格/总格 81 数吉凶 |
| 音韵 | 20% | 姓名声韵调和谐度、平仄组合 |
基于日主强弱，通过同党/异党力量对比取用神：
| 日主 | 用神 | 喜神 | 忌神 |
|---|---|---|---|
| 强 | 克我（官杀） | 我克 + 生我 | 同我（比劫） |
| 弱 | 生我（印星） | 同我（比劫） | 克我 + 我生 |
先定格局（正官/七杀/食神/伤官/正财/偏财/建禄/阳刃等 10 种），再按格局取用神。
| 分支 | 用途 | go.mod module |
|---|---|---|
main |
v4.x 开发主线 | github.com/babyname/fate/v4 |
v3 |
v3.x Bugfix 维护 | github.com/babyname/fate |
⚠️ 历史原因：v3 分支的模块路径不含
/v3（早期 Go module 规范未强制要求）。 从 v4 开始引入/v4后缀，未来 v5 也将统一使用/v5。
| 系列 | 最新 | 标签 |
|---|---|---|
| v4.x | v4.2.0 | v4.0.0 |
| v3.x | v3.6.0 | v3.0.0 ~ v3.6.0（共 14 个发布） |
| v2.x | v2.0.2 | v2.0.0 ~ v2.0.2 |
| 层 | 技术 | 说明 |
|---|---|---|
| 语言 | Go 1.22+ | 核心引擎 & 服务 |
| 前端 | React 19 + Tailwind CSS 3 + Rsbuild | Web 界面 |
| 状态 | Zustand | 前端状态管理 |
| UI | Radix UI + Lucide Icons | 无障碍组件库 |
| ORM | Ent | 类型安全的 Go ORM |
| 存储 | SQLite3 (modernc) | 嵌入式数据库，零依赖 |
| 八字 | chronos/v2 | 八字推算引擎 |
| 卦象 | yi | 周易六十四卦 |
# 前端开发（热更新）
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 runMIT © babyname
暂无开放 Issues，或尚未同步最近议题。