• 八字排盘：四柱、十神、藏干、纳音、神煞、大运、流年、旺衰、格局、用神与调候分析；出生时间必须通过输入约束后才进入排盘，不生成模糊时间候选盘；年限提示词可输出原局—大运—流年—流月—流日逐层合冲刑害破、伏吟、岁运并临与天克地冲证据；双盘可计算日主、日支、四柱交叉关系、双向十神、喜忌覆盖与结构化证据，支持传统派、盲派、新派流派指引。
• 紫微斗数：以 iztro 原生能力输出十二宫、星曜、亮度、四化、三方四正及本命、大限、流年、流月、流日、流时，并随结果披露实际安星、闰月、分年、运限月份、小限年龄和晚子时口径；三合派、飞星派、四化派选项只改变解读侧重点，不改底层安星。固定版本传统目录现登记 87 项，其中 55 条具备原文与可复算条件，32 项因原文含糊或依赖运限只登记边界、不伪造命中；原 84 条未校勘项目规则继续停用，目录外格局不作判断。
• 星盘排盘：西方占星完整排盘，包含太阳、月亮、上升星座与宫位、十大行星、逆行提示与主要相位分析；本命、行运和双盘相位输出角度偏差、容许度位置与紧密等级，不把归一化值包装成事件概率、匹配率或吉凶百分比；太阳返照采用粗定位加二分细化，并返回黄经残差、搜索过程和精度边界。
• 奇门遁甲：输出值符、值使、日干、时干对应的用神宫候选，逐宫保留门星神干、空亡、马星、格局、宫间作用、反证及方位与时间触发条件，不用数字评分替代判断。
• 住宅风水：产品统一入口，分层计算八宅人宅适配与玄空飞星宅运结构，再输出合参要点与建议；不生成综合吉凶总分。只需普通出生年月日+性别，或只填大门向屋内度数/山向，即可使用；可填建造/起运年。八宅负责命卦宅卦与四吉四凶，玄空负责下卦的运盘/山盘/向盘与到山到向，并在边界敏感时保留候选山向。底层仍可单独调用八宅与玄空。
• 七政四余：输出七政四余十一星、命身十二宫、宿度庙旺、吊照、月相与出生时刻光照。七政、罗睺、计都和月孛采用现代天文位置，二十八宿用 28 颗真实距星在目标日期的黄经划界；紫炁保留《七政算内篇》古法均速模型，并明确区分位置精度层级。
• 时间型占卜不机械换算固定天数、周数或百分比：奇门只输出盘内相对节奏、触发条件与限制。
• 合盘与关系分析：支持双方盘面结构化提示词，适配婚恋、合作、友情、亲子、父母、兄弟等场景。

• 干支：十天干、十二地支、六十甲子、六旬旬首、纳音、藏干、阴阳五行、合冲刑害破、三合三会统一真相源。
• 五行：统一生克、月令旺相休囚死和天干地支结构出现统计，可选计入藏干。
• 八字、六爻、奇门、六壬等旧模块统一复用公共地基，旧导入路径仅保留兼容转发。
• 核心包提供 mingyu-core/foundation，线上提供 /foundation/capabilities、/foundation/ganzhi、/foundation/wuxing、/foundation/direction、/foundation/shensha；通用神煞入口会严格核验完整四柱，逐项返回空亡、驿马、桃花的起法、目标地支、命中柱位、来源声明和解释限制，能力目录本身也返回稳定事实、来源、证据汇总与解释限制。
• 真太阳时统一提升到 mingyu-core/calendar，线上提供 /calendar/true-solar-time 便捷换算接口。
• mingyu-core/calendar 还提供统一天文时间尺度证据，可把当地钟表时间换算为 UTC、JD(UTC)、近似 JD(UT) 与 JD(TT)，同时返回 ΔT 模型、估算等级和精度限制；支持用 IANA 时区解析历史夏令时、回拨歧义和跳时缺口，太阳返照已接入该证据。
• 历法层可由日月地心黄经差输出月相角、最小距角、照明近似、盈亏、八相、近似月龄及前后朔弦望时刻；奇门和黄历候选日已接入，并明确不把月相自动解释为吉凶或观测级精度。
• 历法层还可按日期、经纬度和历史时区输出太阳高度、真北方位角、视太阳正午、日出日落及民用/航海/天文曙暮光；西占已接入，并保留极昼极夜、地平遮挡和大气折射限制。
• 二十四节气边界继续采用 tyme4ts 历表，同时按节气每隔 15° 太阳视黄经的定义，用 Meeus/NOAA 低阶公式独立求根核验；输出采用时刻、模型求根时刻、黄经残差、两者差值和精度限制。八字节令月与奇门节令提示词已接入该证据，临界时间不因显示到秒而宣称观测级精度。
• 十二时辰目录、月份天数和中国 1986–1991 历史夏令时也统一由公共日历层提供。

• 六爻：京房八宫法排盘，包含纳甲、六亲、六神、世应、动变、空亡、日破、月破、化进神、化退神、六亲持世等信息；回头冲、动变五行关系与化空可同时保留；输出用神候选、原神忌神仇神作用链，以及逐爻月日、空破墓、动变支持与反证，不生成吉凶总分。
• 梅花易数：支持时间起卦、数字起卦、随机起卦，包含体用生克、四时旺衰、64卦完整爻辞，以及主卦、互卦、变卦逐阶段体用推进与支持、限制证据。
• 奇门遁甲：时家奇门默认转盘法，可通过 API 参数请求飞盘法；定局默认拆补法，也可请求置闰法。包含天地人神四盘、值符值使、格局标签（含入墓、击刑、伏吟反吟、门迫等）、节令背景、复合格局与宫位洞察。
• 大六壬：天盘、四课、三传、月将、贵人、旬空、课体与问题范围选择；输出四课取传依据、初传发用、三传推进及逐传旺衰空亡支持与限制。
• 太乙神数：当前开放完成积年与阳遁七十二局立成校勘的年计，输出太乙、文昌、始击、计神、主客定算、将参与十六神盘，并提供计算链、主证、辅证、反证和方法限制组成的结构化证据。月、日、时计须补齐节气时刻、章月、月法、日法、气应与小余等古籍历法链后再开放；Kintaiyi 的简式与分计不作为古籍真值。
• 自定起卦时间：六爻、梅花易数、奇门遁甲、大六壬可在网页端选择当前时间或自定北京时间；公开 API、MCP Server 和 skill 使用 customDate 传入带时区的 ISO 8601 时间。
• 塔罗牌：78 张塔罗牌，支持单牌、时间流、爱情、事业、选择等牌阵；逐牌保留牌位、正逆位、关键词、元素、牌阶、牌序和解释限制，不输出能量分数或成功率。
• 三山国王灵签：92 签灵签，源自广东潮汕三山国王祖庙；保留签号、签题与签诗原文，直接围绕问题解读。

• 黄历择日：支持搬家入宅、订婚结婚、开业启动、签约合作、出行赴任、就医手术、考试学习、安葬修坟、修造动土等事项；按 tyme4ts 原始宜忌、参与人刑冲破害、时辰与现实限制分成可用、条件和慎用候选，不设置或包装吉凶总分。

• 内置 2025年第十六届全球算命师比赛 评测资料，包含原题、8 份提示词和 40 题正确答案。
• 提示词已补入题目涉及年份、年龄段对应的大运、流年、年龄、十神和小运信息，方便直接评测不同模型的命理选择题表现。
• 提供快速评测脚本，支持 OpenAI Chat Completions、OpenAI Responses、Claude Messages、Gemini generateContent 四种接口格式。
• 评测结果按 100 分制输出，并同时给出准确率和逐题明细。

无需安装，直接调用线上接口：

https://aov.cc/api/v1

详细文档：docs/api.md

OpenAPI：https://aov.cc/api/v1/openapi.json

命语内置 MCP Server，让支持 MCP 的 AI 客户端直接调用本地排盘引擎，不需要用户手动复制 JSON 或提示词。

快速安装：

git clone https://github.com/Brhiza/mingyu.git
cd mingyu
npm install

启动命令：

npm run mcp

详细文档：mcp/README.md

这个 skill 面向 AI 代理和开发者，说明如何通过 aov.cc 公开 API 完成排盘、占卜和提示词生成。

快速安装：

npx skills add Brhiza/mingyu --skill aov-mingyu-api -g -y

快速读取：

让你的 AI 代理读取这个 skill：
https://aov.cc/skills/aov-mingyu-api/SKILL.md

如果当前环境无法使用 npx skills，也可以手动创建目录后保存：

mkdir -p ~/.codex/skills/aov-mingyu-api
curl -L https://aov.cc/skills/aov-mingyu-api/SKILL.md \
  -o ~/.codex/skills/aov-mingyu-api/SKILL.md

Windows PowerShell：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex\skills\aov-mingyu-api"
Invoke-WebRequest "https://aov.cc/skills/aov-mingyu-api/SKILL.md" `
  -OutFile "$env:USERPROFILE\.codex\skills\aov-mingyu-api\SKILL.md"

详细文档：public/skills/aov-mingyu-api/SKILL.md

元数据发现：https://aov.cc/.well-known/aov-mingyu-api.json

mingyu/
├── packages/
│   └── core/                  # mingyu-core 算法包（独立发布到 npm）
└── src/                       # 应用层（React + Vite + MCP）

安装：

npm install mingyu-core

使用示例：

// 八字排盘
import { baziCalculator } from 'mingyu-core/bazi';

const result = baziCalculator.calculateBazi({
  year: 1990,
  month: 1,
  day: 1,
  timeIndex: 5,
  gender: 'male',
});

// 占卜算法
import { generateLiuyao } from 'mingyu-core/divination/liuyao';
import { generateQimen } from 'mingyu-core/divination/qimen';
import { generateLiuren } from 'mingyu-core/divination/liuren';

// 历法工具
import { getDivinationTime, getVoidBranches } from 'mingyu-core/calendar';

// 类型
import type { BaziChartResult, QimenData, LiurenData } from 'mingyu-core/types';

包覆盖能力：八字（含调候用神、格局、神煞、大运、命卦、小运、排盘边界预警、中国夏令时校正及透干根气、十神结构、合化评估等增强分析）、奇门遁甲（含节令背景、复合格局、方位应期）、六爻、大六壬、梅花易数、紫微斗数、西洋占星、七政四余、择日、塔罗、三山国王灵签，以及住宅风水（八宅+玄空合参）、八宅、玄空飞星、太乙和干支、五行、方位、神煞公共模块。

⚠️ 免责： 该包仅提供算法实现，所有结果仅供参考与学习娱乐，不构成任何命理预测或专业建议。

算法包详细文档：packages/core/README.md

mingyu/
├── functions/                 # Cloudflare Pages Functions 公开 API 和公开发现元数据
├── mcp/                       # MCP Server
├── packages/
│   └── core/                  # mingyu-core 独立算法包（发布到 npm）
│       ├── src/bazi/          # 八字引擎与增强分析
│       ├── src/divination/    # 占卜算法（六爻/奇门/六壬/梅花等）
│       ├── src/calendar/      # 历法工具
│       └── src/types/         # 共享类型
├── public/
│   └── skills/                # 公开 skill 文档
├── server/                    # Docker 自部署服务入口
├── src/
│   ├── components/            # 页面组件与通用 UI
│   ├── lib/
│   │   ├── divination/        # 占卜引擎与提示词拼装
│   │   ├── full-chart-engine/ # 八字、紫微完整排盘入口
│   │   ├── iztro/             # 紫微运行时适配
│   │   ├── public-api/        # 公开 API handler
│   │   └── ziwei-prompts/     # 紫微提示词模块
│   ├── pages/                 # 输入页、结果页、历史页、教程页
│   ├── types/                 # 领域类型定义
│   ├── utils/                 # 页面层工具，核心算法统一来自 mingyu-core
│   └── workers/               # 紫微相关 Web Worker
└── tests/                     # 单元测试与集成测试

本项目使用 pnpm workspace 管理应用层与 mingyu-core 算法包，需先安装 pnpm：

npm install -g pnpm

安装依赖：

pnpm install

启动网页开发服务：

pnpm dev

启动 MCP Server：

pnpm mcp

构建生产版本：

pnpm build

运行测试：

pnpm test

单独构建 mingyu-core 算法包：

pnpm --filter mingyu-core build

类型检查 MCP 与共享源码：

npx tsc --project mcp/tsconfig.json --noEmit

推荐部署到 Cloudflare Pages，静态页面由 Pages 托管，/api/v1/* 由 Pages Functions 处理。

Pages 构建设置：

如果 Cloudflare 没有自动启用 pnpm，可在环境变量中添加：

PNPM_VERSION=11

公开 API 路由来自 functions/api/v1/[[path]].ts，部署后可访问：

https://你的域名/api/v1/manifest
https://你的域名/api/v1/openapi.json
https://你的域名/.well-known/aov-mingyu-api.json

如果绑定的域名是 aov.cc，上线后检查：

https://aov.cc/api/v1/manifest
https://aov.cc/api/v1/openapi.json
https://aov.cc/.well-known/aov-mingyu-api.json
https://aov.cc/mingyu-runtime-config.js

Cloudflare Pages 的环境变量在 Dashboard → Settings → Environment variables 中配置。密钥不要写进代码仓库。

启用内置 AI 时，Production 环境至少配置：

AI_BUILTIN_ENABLED=true
AI_DEFAULT_ENABLED=false
AI_API_KEY=你的模型密钥
AI_BASE_URL=https://api.deepseek.com/v1
AI_MODEL=deepseek-chat
AI_PROVIDER_NAME=DeepSeek

如果同时启用了 Preview 部署，也需要在 Preview 环境配置同一组变量。保存环境变量后重新部署一次，/mingyu-runtime-config.js 会从 Pages Functions 读取当前环境变量，并返回 Cache-Control: no-store，避免旧配置被缓存。

Docker 镜像会构建前端页面，并在容器内启动一个 Node 服务，同时提供：

• 网页访问
• /api/v1/* 公开 API
• /api/v1/ai/analyze 流式 AI 解读
• /api/v1/ai/models 模型列表获取

构建镜像：

docker build -t mingyu .

启动基础服务：

docker run --rm -p 3000:3000 mingyu

访问：

http://localhost:3000

带服务端 AI 启动：

docker run --rm -p 3000:3000 \
  -e AI_API_KEY=your-api-key \
  -e AI_BASE_URL=https://api.deepseek.com/v1 \
  -e AI_MODEL=deepseek-chat \
  -e AI_PROVIDER_NAME=DeepSeek \
  -e AI_BUILTIN_ENABLED=true \
  -e AI_DEFAULT_ENABLED=false \
  mingyu

也可以使用 Docker Compose：

docker compose up --build

Compose 会读取本地 .env。可以在本地 .env 中填写下面内容，但不要提交这个文件：

AI_API_KEY=your-api-key
AI_BASE_URL=https://api.deepseek.com/v1
AI_MODEL=deepseek-chat
AI_PROVIDER_NAME=DeepSeek
AI_BUILTIN_ENABLED=true
AI_DEFAULT_ENABLED=false
VITE_ENABLE_DONATION_BOX=false

默认端口是 3000。如需修改容器内端口，可设置 PORT；如需修改宿主机端口，调整 compose 或 docker run 的 -p 左侧端口。

VITE_ENABLE_DONATION_BOX=true 时，首页上方会显示功德箱按钮；不设置或设为 false 时默认不显示。这个变量只影响前端构建，Cloudflare Pages 需要配置在构建环境变量中，Docker 部署需要在构建时传入。

命语支持两种 AI 使用方式：

• 用户在首页顶部齿轮中自行填写 OpenAI 兼容接口，API Key 只保存在用户自己的浏览器。
• 站点部署者在服务端配置 AI，前端会显示一个可选服务商。这个能力也可以理解为“内置 AI”。

服务端 AI 环境变量：

只配置 AI_API_KEY 不会自动显示服务端 AI；必须同时设置 AI_BUILTIN_ENABLED=true。如果想提供公益内置 AI，但默认仍让用户复制提示词，可设置 AI_BUILTIN_ENABLED=true、AI_DEFAULT_ENABLED=false。用户仍可通过齿轮自行填写自己的接口。

AI 代理会对上游临时错误自动重试 2 次。只重试网络异常、408、429 和 5xx；鉴权失败、模型名错误等确定性问题不会重试。常见错误码：

.dev.vars.example 提供了本地和 Cloudflare 可参考的变量模板。公开站点启用服务端 AI 会产生调用成本，也可能受上游模型稳定性影响，建议先确认额度、限流和可用性。

交互式运行：

npm run contest:evaluate

脚本会依次询问接口 URL、API Key 和模型名称，自动读取 8 份提示词与 正确答案.md。每个命例只要求模型输出 5 个 A/B/C/D 答案字母，减少长理由导致的截断和解析错误；调用完成后输出 100 分制总分、准确率、分命例得分和逐题明细。

也可以直接传参：

npm run contest:evaluate -- --format chat --url https://api.openai.com/v1 --key your-api-key --model gpt-4.1-mini

批量并发评测：

npm run contest:evaluate -- --format chat --url https://openrouter.ai/api/v1 --key your-api-key --concurrency 3 --models "GPT-5.4=openai/gpt-5.4,Claude Sonnet 4.6=anthropic/claude-sonnet-4.6"

--concurrency 控制同时评测的模型数量，默认批量为 3；--caseConcurrency 控制同一模型内命例并发数量，默认 1。批量模式会合并更新比赛目录下的 模型评测排名报告.md 和 评测结果/本次排名原始结果.json。

使用 OpenRouter 测 reasoning 模型时，可以加 --reasoningEffort none --excludeReasoning --maxTokens 256，让模型尽量只返回最终答案。若某个命例没有解析满 5 个答案，脚本会把该模型标为失败，不会把 ????? 当作 0 分答案计入排名。

支持的 --format：

不传 --format 时会自动识别；评测报告会保存到比赛资料目录下的 评测结果/。