Skip to content
Back to search

mingyu

八字、紫微、星盘、六爻、梅花、奇门、大六壬、小六壬、塔罗、雷诺曼、灵签、择日一站式玄学算命占卜工具包,输出结构化提示词与数据。提供公开 API、MCP Server 与 skill。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Brhiza/mingyu with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Brhiza/mingyu'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/brhiza--mingyu/badge.svg)](/listings/brhiza--mingyu)

HTML

<a href="/listings/brhiza--mingyu"><img src="/api/listings/brhiza--mingyu/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 178 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <a href="https://linux.do" alt="LINUX DO"><img src="https://img.shields.io/badge/LINUX-DO-FFB003.svg" /></a>
  3. <a href="https://www.npmjs.com/package/mingyu-core" alt="mingyu-core on npm"><img src="https://img.shields.io/npm/v/mingyu-core?label=mingyu-core&color=CB3837" /></a>
  4. <a href="https://github.com/Brhiza/mingyu/actions/workflows/ci.yml" alt="CI"><img src="https://github.com/Brhiza/mingyu/actions/workflows/ci.yml/badge.svg" /></a>
  5. </p>
  6. # 命语 (Mingyu)
  7. 命语是一套免费开源的在线算命、占卜排盘与 AI 解读提示词工具。输入出生时间或所问之事,即可完成高精度排盘,并生成可直接交给任意大模型解读的完整提示词。
  8. ### ⚡ 一键接入(Agent 技能 & 在线 MCP)
  9. - **Agent Skill(推荐 · 免配置一句话安装)**:
  10. ```bash
  11. npx skills add Brhiza/mingyu --skill mingyu -g -y
  12. ```
  13. - Skill 安装不会自动注册 MCP 服务。需要连接 MCP 时,如果客户端能启动本地进程,优先单独配置 `npx -y mingyu-mcp` stdio;默认 `full`,请求在本机处理,不占用 Cloudflare Pages Functions 配额。
  14. - **在线 Remote MCP(本地进程不可用或需要远程免安装时)**:
  15. - 在支持 Remote MCP 的客户端添加 **Streamable HTTP** 类型的 Server URL:`https://aov.cc/mcp`
  16. - **QQ 交流群**:命语 Mingyu 技术交流群(1080947018)
  17. ---
  18. ## 📿 功德箱
  19. 命语与时月东方均为个人业余维护的免费开源项目。
  20. **为什么叫“功德箱”?**
  21. 本项目收到的全部赞助款项目前均定期**全额捐赠给社会正规慈善与公益事业**(用于爱心助学、困境老人救助与乡村公益等)。感谢每一位支持者的善意!
  22. <p align="center">
  23. <a href="https://lk.sydf.cc/"><strong>👉 前往功德箱(赞助与爱心支持)</strong></a>
  24. </p>
  25. ---
  26. <p align="center">
  27. <a href="https://aov.cc"><strong>🌐 在线使用</strong></a> ·
  28. <a href="https://aov.cc/tutorial">📖 新手教程</a> ·
  29. <a href="docs/README.md">📚 完整文档</a> ·
  30. <a href="https://aov.cc/api/v1/openapi.json">🔌 OpenAPI</a> ·
  31. <a href="https://www.npmjs.com/package/mingyu-core">📦 mingyu-core (npm)</a>
  32. </p>
  33. ---
  34. ## 🔮 支持功能
  35. | 分类 | 术数方法 | 主要功能 |
  36. | :----------- | :--------------------------------------------------- | :--------------------------------------------------------------------------------------------- |
  37. | **命理运势** | 八字命理、紫微斗数、八字紫微合参、西方星盘、七政四余 | 支持真太阳时换算、大运流年流月流日细盘、三方四正、庙旺四化、神煞、合盘分析,以及七政行限与流曜 |
  38. | **周易占卜** | 六爻纳甲、梅花易数 | 支持手摇/指定卦象、京房八宫纳甲、六亲六神、世应动变、体用生克与四时旺衰 |
  39. | **三式绝学** | 奇门遁甲、大六壬、金口诀、太乙神数、皇极经世 | 支持时家转盘/飞盘奇门、月将天地盘四课三传、阴阳五用、年计七十二局与元会运世 |
  40. | **牌卡灵签** | 西方塔罗牌、雷诺曼牌、三山国王灵签、小六壬 | 包含 78 张塔罗全牌阵、36 张雷诺曼及大 Tableau、揭西祖庙 92 签全篇签谱 |
  41. | **择日风水** | 黄历择吉、八宅明镜、玄空飞星、五运六气 | 建除十二神与宜忌排查、东四西四命卦、三元九运飞星排盘、流年流月紫白加临与客主加临 |
  42. ---
  43. ## 🛠️ 开发者接入
  44. ### 1. 核心算法包 `mingyu-core`
  45. ```bash
  46. npm install mingyu-core
  47. ```
  48. ```typescript
  49. import { generateBazi, generateLiuyao, drawTarotSpread } from 'mingyu-core';
  50. // 八字排盘
  51. const bazi = generateBazi({ solarDate: '1995-08-18', solarTime: '09:30', gender: '男' });
  52. // 六爻起卦
  53. const liuyao = generateLiuyao(new Date());
  54. // 抽塔罗牌
  55. const tarot = drawTarotSpread('celtic');
  56. ```
  57. 详见 [mingyu-core 文档](packages/core/README.md)。
  58. ### 2. 公开 REST API
  59. 基础地址:`https://aov.cc/api/v1`
  60. - [API 接口文档](docs/api.md) · [OpenAPI 规范](https://aov.cc/api/v1/openapi.json) · [LLMs.txt](https://aov.cc/llms.txt)
  61. - 要把资料交给 AI 解读时,只调用一次对应的 `/prompt`;服务端会同时完成排盘并返回任务书。只有需要展示或继续计算结构化盘面时才调用 `/calculate`。
  62. ### 3. MCP Server
  63. - **本地 npx CLI(Agent/Skill 首选;开箱即用)**:
  64. ```bash
  65. npx -y mingyu-mcp
  66. ```
  67. 本地 CLI 默认采用 `full` 预设,返回完整结构化结果并默认计算当前年度星盘行运;请求在本地处理,不走 Cloudflare Pages Functions。
  68. - **在线 Remote MCP(本地进程不可用或需要远程免安装时)**:在 Cursor、Windsurf、Claude Desktop 等客户端中配置 **Streamable HTTP** 远程端点:`https://aov.cc/mcp`(不要按旧版 SSE 类型配置)。在线提示词通常默认 `summary`,非幂等的一次性起卦、抽牌、求签提示词默认 `full`;显式 `responseMode` 优先。`summary` 不缩小算法计算范围;星盘默认本命 `natal`。在线范围限制见 [API 文档](docs/api.md#官方在线请求范围)。
  69. - 需要 AI 解读时只调用一次 `*_prompt`;遇到 `RESOURCE_LIMIT` 先缩小或拆分参数,不要原样自动重试。在线 MCP 每条 JSON-RPC 消息单独发送一次 HTTP `POST`,不接受 batch;单条请求体最多 512 KiB。每次请求计入 Cloudflare 请求用量,避免轮询和紧密重试。在线 REST 的范围保护见 [API 文档](docs/api.md#官方在线请求范围)。
  70. (本地源码开发也可通过 `pnpm mcp` 启动,详见 [MCP 服务文档](mcp/README.md))
  71. ### 4. Agent Skill
  72. ```bash
  73. npx skills add Brhiza/mingyu --skill mingyu -g -y
  74. ```
  75. ---
  76. ## 📱 Android 原生应用
  77. 提供适配移动端的 Android 原生 APK,支持在生成排盘后**一键唤起已安装的 AI 应用**(如 ChatGPT、Claude、Kimi 等)直接对话,API Key 仅保存在本地设备。
  78. 正式 APK 发布后会同步到 `download.aov.cc` 并由 Cloudflare CDN 分发;应用默认使用官方下载,失败时回退到 GitHub Release。
  79. ```bash
  80. # 同步 Web 资源到 Android 工程
  81. pnpm android:sync
  82. ```
  83. ---
  84. ## 🚀 本地开发与构建
  85. ```bash
  86. # 克隆仓库并安装依赖
  87. git clone https://github.com/Brhiza/mingyu.git
  88. cd mingyu
  89. pnpm install
  90. # 启动开发服务器
  91. pnpm dev
  92. # 运行测试
  93. pnpm test
  94. # 打包构建
  95. pnpm build
  96. ```
  97. ---
  98. ## ⛩️ 关于三山国王灵签
  99. 三山国王是潮汕与客家地区重要的民间信仰,祖庙位于广东省揭西县河婆街道。作者整理并保留了祖庙传承的 92 签灵签体系,每签保留签号、签题、签诗原文与典故。
  100. ---
  101. ## 🌟 基于命语构建
  102. ### 时月东方
  103. 时月东方是一款基于命语核心能力构建的东方术数工具,使用 Vue 3 与 Vite 实现,也可以作为 `mingyu-core` 在独立产品中接入和使用的实际参考。
  104. - 在线体验:[https://sydf.cc](https://sydf.cc)
  105. - 项目源码:[https://github.com/Brhiza/sydf](https://github.com/Brhiza/sydf)
  106. ---
  107. ## 📚 文档目录
  108. - [文档总览](docs/README.md)
  109. - [术数能力与适用范围](docs/capabilities.md)
  110. - [公开 API 文档](docs/api.md)
  111. - [MCP Server 配置指南](mcp/README.md)
  112. - [mingyu-core 算法包说明](packages/core/README.md)
  113. - [开发、部署与环境配置](docs/development-and-deployment.md)
  114. ---
  115. ## ⚖️ 免责声明
  116. 本工具提供的排盘结果与 AI 解读提示词仅供传统文化研究与休闲娱乐参考,不构成且不可替代医疗、心理、法律、投资等专业建议。
  117. ---
  118. ## 📄 开源协议
  119. 本项目基于 [AGPL-3.0-only](LICENSE) 协议开源。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.