命语

命语是一套面向用户和开发者的命理、占卜与择日工具。它把排盘、起卦、抽牌、结构化结果和 AI 提示词连接成清晰流程，让用户得到可核对的盘面资料，也让开发者能够直接复用同一套核心算法。

网页端适合快速排盘、调整并复制提示词；公开 API、MCP Server、skill 和独立 npm 包 mingyu-core 适合接入应用、工作流与智能体。默认输出只保留盘面和有效解读资料，来源、规则与计算过程按需提供，避免把冗长证据链混入用户界面和 AI 任务书。

项目网页按“排盘、合盘、占卜、择日”组织，覆盖八字、紫微斗数、星盘、七政四余、住宅风水、六爻、梅花易数、奇门遁甲、大六壬、太乙神数、皇极经世、五运六气、塔罗牌、灵签与黄历择日等能力。

在线体验 · 公开 API · OpenAPI · mingyu-core · 公开 skill

aov.cc 是本项目的官方线上实例；fork 后部署到自己的 Cloudflare Pages 或其他域名时，公开 API 会按实际访问域名生成元数据和 OpenAPI 地址。

功德箱：https://lk.sydf.cc/

基于命语构建

时月东方

时月东方是一款基于命语核心能力构建的东方术数工具，使用 Vue 3 与 Vite 实现，也可以作为 mingyu-core 在独立产品中接入和消费的实际参考。

• 在线体验：https://sydf.cc
• 项目源码：https://github.com/Brhiza/sydf

快速导航

• 基于命语构建
• 核心能力
• 集成方式
• 核心算法包
• 运行与部署方式
• 模型评测

核心能力

以下条目描述核心计算可提供的完整资料。网页、提示词、公开 API 和 MCP 默认采用精简输出；只有审计、研究或二次计算时才显式请求完整证据。

集成方式

命语提供公开 API、MCP Server、公开 skill 和 mingyu-core npm 包四种集成方式。提示词接口默认只返回 prompt；排盘接口默认返回精简结构，需要审计资料时再请求完整结果。六爻、梅花易数、奇门遁甲和大六壬还支持通过 customDate 指定起卦时间。README 只保留快速入口，完整参数和调用示例请查看对应文档。

https://aov.cc/api/v1

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

pnpm mcp

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

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

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

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"

核心算法包 mingyu-core

命语的所有命理排盘与占卜算法已抽取为独立 npm 包 mingyu-core，本仓库以 pnpm workspace 形式同时维护应用与算法包。

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 { createConsumptionView } from 'mingyu-core/consumption';

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

技术栈

项目结构

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/                     # 单元测试与集成测试

运行与部署方式

本项目支持本地开发、Cloudflare Pages 和 Docker 三种常用运行方式。AI 相关变量也放在这里，部署时可以一起配置。

npm install -g pnpm

pnpm install

pnpm dev

pnpm mcp

pnpm build

pnpm test

pnpm --filter mingyu-core build

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

PNPM_VERSION=11

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

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

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

docker build -t mingyu .

docker run --rm -p 3000:3000 mingyu

http://localhost:3000

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 up --build

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

模型评测

比赛资料位于：docs/2025第十六届全球算命师比赛

pnpm contest:evaluate

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

pnpm 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"

适合贡献的方向

• 补充更多命理、占卜与提示词测试样例。
• 优化公开 API 的字段文档和返回示例。
• 增加更多 AI 客户端的 MCP 配置示例。
• 扩展 skill，使更多代理能自动发现并调用命语。
• 增强移动端体验、可访问性和教程说明。

关于三山国王

三山国王是粤东潮汕与客家地区极具影响力的民间信仰，祖庙位于广东揭西县河婆街道。这座有着千年历史的庙宇供奉着巾山、明山、独山三位山神，自隋代至今香火不断，影响远播东南亚。

项目作者来自揭西，自幼祭拜三山国王。这套92 签灵签体系以祖庙传承的签诗为本：

• 每签保留签号、签题与签诗原文
• 不同庙本可能存在签序、题名和字句差异，解读以本次签文为准

我们希望这套签文能成为一本"人生操作手册"——迷茫时翻开，总有一支签、一句诗，能让人豁然开朗。

免责声明

命语提供的是命理、占卜与 AI 提示词辅助工具，结果仅供参考和娱乐学习使用，不应替代医疗、法律、投资、心理咨询等专业建议。

项目关键词

算命、AI 算命、在线算命、免费算命、智能算命、八字算命、八字排盘、紫微斗数、紫微排盘、星盘、占星排盘、六爻起卦、梅花易数、奇门遁甲、大六壬、塔罗占卜、塔罗抽牌、抽签、灵签、三山国王灵签、择日、黄道吉日、命理工具、占卜工具、运势分析、婚姻算命、事业运势、财运分析。