--- id: gh-mingyu name: "mingyu" url: https://skills.yangsir.net/skill/gh-mingyu author: Brhiza domain: lifestyle tags: ["fortune-telling", "divination", "astrology", "ai-prompts", "api"] install_count: 106 rating: 4.00 (20 reviews) github: https://github.com/Brhiza/mingyu --- # mingyu > 命语将八字、紫微、星盘等复杂命理排盘结果结构化为数据和AI提示词，赋能AI应用和智能体系统，实现专业可靠的AI占卜。 **Stats**: 106 installs · 4.0/5 (20 reviews) ## Before / After 对比 ### AI 占卜效率与专业度 **Before**: 传统 AI 占卜往往需要用户手动输入大量专业术语和排盘信息，耗时费力，且生成的提示词质量参差不齐，导致 AI 解读结果不够精准和专业。 **After**: 命语自动将复杂排盘结果结构化为数据和高质量 AI 提示词，用户只需一键复制，即可让 AI 快速生成专业可靠的命理分析，大幅提升效率和准确性。 | Metric | Before | After | Change | |---|---|---|---| | AI 提示词生成时间 | 30分钟 | 1分钟 | -96.67% | | AI 解读专业度 | 50分 | 90分 | +80% | ### 命理应用集成 **Before**: 开发者在构建 AI 占卜应用时，需要投入大量时间研究命理算法、排盘逻辑，并自行设计数据结构和提示词模板，开发周期长，维护成本高。 **After**: 命语提供标准化的 API 和 MCP Server，开发者可直接调用，快速集成八字、紫微、星盘等多种排盘能力，将开发周期缩短，专注于应用层创新。 | Metric | Before | After | Change | |---|---|---|---| | 开发集成周期 | 60天 | 7天 | -88.33% | | 支持命理术数种类 | 1种 | 10种 | +900% | ### 复杂命盘理解 **Before**: 面对八字、紫微等复杂命盘，非专业人士往往难以理解其中蕴含的深层信息，即使有排盘工具，也只能看到一堆专业术语，无法获得清晰的解读。 **After**: 命语不仅提供精准排盘，更将结果结构化为易懂的数据和摘要，结合 AI 提示词，让用户能轻松获取专业级的命理分析，深入理解自身运势。 | Metric | Before | After | Change | |---|---|---|---| | 命盘理解难度 | 8分 (1-10分，10最难) | 3分 (1-10分，10最难) | -62.5% | | 获取专业解读时间 | 120分钟 | 5分钟 | -95.83% | ### 多术数占卜体验 **Before**: 用户需要进行八字、塔罗、六爻等多种占卜时，往往需要切换不同的网站或应用，操作繁琐，数据不互通，体验割裂且效率低下。 **After**: 命语提供一站式多术数排盘与占卜功能，用户可在同一平台完成所有操作，结果统一管理，并能生成跨术数的 AI 提示词，极大提升占卜效率和便捷性。 | Metric | Before | After | Change | |---|---|---|---| | 占卜工具切换次数 | 5次 | 1次 | -80% | | 占卜准备时间 | 20分钟 | 2分钟 | -90% | ## Readme

# 命语 命语是一个算命、占卜、择日的提示词生成项目，目标是把排盘、起卦、抽牌、结构化数据和 AI 提示词连接成一条清晰可复用的流程。让所有人都可以快速的生成专业可靠的排盘信息，而不是依靠模糊的关键词和无脑堆叠专业词汇，让AI占卜相对更加可靠，享受术数的神秘智慧。 你可以在网页端快速完成排盘或占卜，并复制提示词给你常用的所有 AI 工具继续解读，对于移动端用户还可以使用分享功能快速跳转；也可以通过公开 API、MCP Server 或 skill，把命语的排盘与提示词能力接入自己的应用、工作流和智能体系统。 项目目前覆盖八字排盘、紫微斗数、星盘、六爻、梅花易数、奇门遁甲、大六壬、小六壬、塔罗牌、雷诺曼、三山国王灵签、择日等场景，并尽量将结果拆分为机器可读的数据、用户可理解的摘要和适合大模型继续分析的提示词。 线上体验：[https://aov.cc](https://aov.cc) 公开 API：[https://aov.cc/api/v1/manifest](https://aov.cc/api/v1/manifest) OpenAPI：[https://aov.cc/api/v1/openapi.json](https://aov.cc/api/v1/openapi.json) 公开 skill：[https://aov.cc/skills/aov-mingyu-api/SKILL.md](https://aov.cc/skills/aov-mingyu-api/SKILL.md) ## 核心能力 ### 命理排盘 - 八字排盘：四柱、十神、藏干、纳音、神煞、大运、流年、旺衰、格局、用神与调候分析。 - 紫微斗数：基于 `iztro` 的完整命盘，支持本命、大限、流年、流月、流日、流时等数据范围。 - 星盘排盘：西方占星完整排盘，包含太阳、月亮、上升星座与宫位、十大行星、逆行提示与主要相位分析。 - 合盘与关系分析：支持双方盘面结构化提示词，适配婚恋、合作、友情、亲子、父母、兄弟等场景。 - 时辰反推：在用户不确定出生时辰时，生成保守的三柱分析与互动式反推提示词。 ### 占卜术数 - 六爻：京房八宫法排盘，包含纳甲、六亲、六神、世应、动变、空亡等信息。 - 梅花易数：支持时间起卦、数字起卦、随机起卦、外应起卦，包含体用生克与四时旺衰。 - 奇门遁甲：时家奇门转盘法，包含天地人神四盘、值符值使、格局标签与宫位洞察。 - 大六壬：天盘、四课、三传、月将、贵人、旬空、课体与断课模板。 - 小六壬：大安、留连、速喜、赤口、小吉、空亡六宫起课，支持时间起课与随机起课，输出起因、过程、结果三宫提示词。 - 塔罗牌：78 张塔罗牌，支持单牌、时间流、爱情、事业、选择等牌阵。 - 雷诺曼：36 张雷诺曼牌，支持单牌、时间流、爱情、事业、选择等牌阵。 - 三山国王灵签：100 签灵签，包含签题、签诗、典故故事与分类解签。 ### 择吉择日 - 黄历择日：支持搬家入宅、订婚结婚、开业启动、签约合作、出行赴任、就医手术、考试学习等事项，按参与人生辰与事项类型推荐最佳日期并给出评分。 ### 模型评测 - 内置 `2025年第十六届全球算命师比赛` 评测资料，包含原题、8 份提示词和 40 题正确答案。 - 提示词已补入题目涉及年份、年龄段对应的大运、流年、年龄、十神和小运信息，方便直接评测不同模型的命理选择题表现。 - 提供快速评测脚本，支持 OpenAI Chat Completions、OpenAI Responses、Claude Messages、Gemini generateContent 四种接口格式。 - 评测结果按 100 分制输出，并同时给出准确率和逐题明细。 ## 给开发者 命语提供三种集成方式：公开 API、MCP Server、公开 skill。API 和 MCP 都支持一站式返回 `result` 与 `prompt`，README 只保留快速入口和安装方式，接口参数、客户端配置和调用示例请跳转到对应文档。 ### 公开 API 无需安装，直接调用线上接口： ```text https://aov.cc/api/v1 ``` 详细文档：[docs/api.md](docs/api.md) OpenAPI：[https://aov.cc/api/v1/openapi.json](https://aov.cc/api/v1/openapi.json) ### MCP Server 命语内置 MCP Server，让支持 MCP 的 AI 客户端直接调用本地排盘引擎，不需要用户手动复制 JSON 或提示词。 快速安装： ```bash git clone https://github.com/Brhiza/mingyu.git cd mingyu npm install ``` 启动命令： ```bash npm run mcp ``` 详细文档：[mcp/README.md](mcp/README.md) ### 公开 skill 这个 skill 面向 AI 代理和开发者，说明如何通过 `aov.cc` 公开 API 完成排盘、占卜和提示词生成。 快速安装： ```bash npx skills add Brhiza/mingyu --skill aov-mingyu-api -g -y ``` 快速读取： ```text 让你的 AI 代理读取这个 skill： https://aov.cc/skills/aov-mingyu-api/SKILL.md ``` 如果当前环境无法使用 `npx skills`，也可以手动创建目录后保存： ```bash 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： ```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](public/skills/aov-mingyu-api/SKILL.md) 元数据发现：[https://aov.cc/.well-known/aov-mingyu-api.json](https://aov.cc/.well-known/aov-mingyu-api.json) ## 技术栈 | 类别 | 技术 | | --- | --- | | 前端 | React 19、TypeScript 5.9 | | 构建 | Vite 7 | | 路由 | React Router 7 | | 部署 | Cloudflare Pages、Pages Functions | | 历法与星盘 | `tyme4ts`、`iztro` | | 数据校验 | `zod` | | 测试 | Node.js 原生测试运行器 | | AI 集成 | MCP Server、OpenAPI、skill 文档 | ## 项目结构 ```text mingyu/ ├── functions/ # Cloudflare Pages Functions 公开 API ├── mcp/ # MCP Server ├── public/ │ ├── .well-known/ # 公开发现元数据 │ └── skills/ # 公开 skill 文档 ├── src/ │ ├── components/ # 页面组件与通用 UI │ ├── lib/ │ │ ├── divination/ # 占卜引擎与提示词拼装 │ │ ├── full-chart-engine/ # 八字、紫微完整排盘入口 │ │ ├── iztro/ # 紫微运行时适配 │ │ ├── public-api/ # 公开 API handler │ │ └── ziwei-prompts/ # 紫微提示词模块 │ ├── pages/ # 输入页、结果页、历史页、教程页 │ ├── types/ # 领域类型定义 │ ├── utils/ # 八字、塔罗、历法、灵签等工具 │ └── workers/ # 紫微相关 Web Worker └── tests/ # 单元测试与集成测试 ``` ## 本地开发 安装依赖： ```bash npm install ``` 启动网页开发服务： ```bash npm run dev ``` 启动 MCP Server： ```bash npm run mcp ``` 构建生产版本： ```bash npm run build ``` 运行测试： ```bash npm test ``` 类型检查 MCP 与共享源码： ```bash npx tsc --project mcp/tsconfig.json --noEmit ``` ## 模型评测 比赛资料位于：[docs/2025第十六届全球算命师比赛](docs/2025第十六届全球算命师比赛) 交互式运行： ```bash npm run contest:evaluate ``` 脚本会依次询问接口 URL、API Key 和模型名称，自动读取 8 份提示词与 `正确答案.md`。每个命例只要求模型输出 5 个 A/B/C/D 答案字母，减少长理由导致的截断和解析错误；调用完成后输出 100 分制总分、准确率、分命例得分和逐题明细。 也可以直接传参： ```bash npm run contest:evaluate -- --format chat --url https://api.openai.com/v1 --key sk-xxx --model gpt-4.1-mini ``` 批量并发评测： ```bash npm run contest:evaluate -- --format chat --url https://openrouter.ai/api/v1 --key sk-xxx --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`： | 格式 | 说明 | URL 示例 | | --- | --- | --- | | `chat` | OpenAI Chat Completions 或兼容接口 | `https://api.openai.com/v1` | | `responses` | OpenAI Responses | `https://api.openai.com/v1` | | `claude` | Claude Messages | `https://api.anthropic.com/v1` | | `gemini` | Gemini generateContent | `https://generativelanguage.googleapis.com/v1beta` | 不传 `--format` 时会自动识别；评测报告会保存到比赛资料目录下的 `评测结果/`。 ## 适合贡献的方向 - 补充更多命理、占卜与提示词测试样例。 - 优化公开 API 的字段文档和返回示例。 - 增加更多 AI 客户端的 MCP 配置示例。 - 扩展 skill，使更多代理能自动发现并调用命语。 - 增强移动端体验、可访问性和教程说明。 ## 免责声明 命语提供的是命理、占卜与 AI 提示词辅助工具，结果仅供参考和娱乐学习使用，不应替代医疗、法律、投资、心理咨询等专业建议。 ## 项目关键词 算命、AI 算命、在线算命、免费算命、智能算命、八字算命、八字排盘、紫微斗数、紫微排盘、星盘、占星排盘、六爻起卦、梅花易数、奇门遁甲、大六壬、小六壬、塔罗占卜、塔罗抽牌、雷诺曼、抽签、灵签、三山国王灵签、择日、黄道吉日、命理工具、占卜工具、运势分析、婚姻算命、事业运势、财运分析。 --- *Source: https://skills.yangsir.net/skill/gh-mingyu* *Markdown mirror: https://skills.yangsir.net/api/skill/gh-mingyu/markdown*