Skip to content

Latest commit

 

History

1,049 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

命语 (Mingyu)

命语是一套免费开源的在线算命、占卜排盘与 AI 解读提示词工具。输入出生时间或所问之事,即可完成高精度排盘,并生成可直接交给任意大模型解读的完整提示词。

⚡ 一键接入(Agent 技能 & 在线 MCP)

  • Agent Skill(推荐 · 免配置一句话安装)
    npx skills add Brhiza/mingyu --skill mingyu -g -y
  • 在线 Remote MCP(云端直连 · 零依赖)
    • Claude Codeclaude mcp add mingyu --transport sse https://aov.cc/mcp
    • Cursor / Windsurf / VS Code:直接添加 SSE 类型的 Server URL:https://aov.cc/mcp
  • QQ 交流群:命语 Mingyu 技术交流群(1080947018)

📿 功德箱

命语与时月东方均为个人业余维护的免费开源项目。

为什么叫“功德箱”?
本项目收到的全部赞助款项目前均定期全额捐赠给社会正规慈善与公益事业(用于爱心助学、困境老人救助与乡村公益等)。感谢每一位支持者的善意!

👉 前往功德箱(赞助与爱心支持)


🌐 在线使用 · 📖 新手教程 · 📚 完整文档 · 🔌 OpenAPI · 📦 mingyu-core (npm)


🔮 支持功能

分类 术数方法 主要功能
命理运势 八字命理、紫微斗数、八字紫微合参、西方星盘、七政四余 支持真太阳时换算、大运流年流月流日细盘、三方四正、庙旺四化、神煞、合盘分析,以及七政行限与流曜
周易占卜 六爻纳甲、梅花易数 支持手摇/指定卦象、京房八宫纳甲、六亲六神、世应动变、体用生克与四时旺衰
三式绝学 奇门遁甲、大六壬、金口诀、太乙神数、皇极经世 支持时家转盘/飞盘奇门、月将天地盘四课三传、阴阳五用、年计七十二局与元会运世
牌卡灵签 西方塔罗牌、雷诺曼牌、三山国王灵签、小六壬 包含 78 张塔罗全牌阵、36 张雷诺曼及大 Tableau、揭西祖庙 92 签全篇签谱
择日风水 黄历择吉、八宅明镜、玄空飞星、五运六气 建除十二神与宜忌排查、东四西四命卦、三元九运飞星排盘、流年流月紫白加临与客主加临

🛠️ 开发者接入

1. 核心算法包 mingyu-core

npm install mingyu-core
import { generateBazi, generateLiuyao, drawTarotSpread } from 'mingyu-core';

// 八字排盘
const bazi = generateBazi({ solarDate: '1995-08-18', solarTime: '09:30', gender: '男' });

// 六爻起卦
const liuyao = generateLiuyao(new Date());

// 抽塔罗牌
const tarot = drawTarotSpread('celtic');

详见 mingyu-core 文档

2. 公开 REST API

基础地址:https://aov.cc/api/v1

3. MCP Server

  • 在线 Remote MCP(免安装直接接入):支持在 Cursor、Windsurf、Claude Desktop 中直接配置 Streamable HTTP 远程端点:https://aov.cc/mcp
  • 本地 npx CLI(开箱即用)
    npx -y mingyu-mcp

(本地源码开发也可通过 pnpm mcp 启动,详见 MCP 服务文档

4. Agent Skill

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

📱 Android 原生应用

提供适配移动端的 Android 原生 APK,支持在生成排盘后一键唤起已安装的 AI 应用(如 ChatGPT、Claude、Kimi 等)直接对话,API Key 仅保存在本地设备。

正式 APK 发布后会同步到 download.aov.cc 并由 Cloudflare CDN 分发;应用默认使用官方下载,失败时回退到 GitHub Release。

# 同步 Web 资源到 Android 工程
pnpm android:sync

🚀 本地开发与构建

# 克隆仓库并安装依赖
git clone https://github.com/Brhiza/mingyu.git
cd mingyu
pnpm install

# 启动开发服务器
pnpm dev

# 运行测试
pnpm test

# 打包构建
pnpm build

⛩️ 关于三山国王灵签

三山国王是潮汕与客家地区重要的民间信仰,祖庙位于广东省揭西县河婆街道。作者整理并保留了祖庙传承的 92 签灵签体系,每签保留签号、签题、签诗原文与典故。


🌟 基于命语构建

时月东方

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


📚 文档目录


⚖️ 免责声明

本工具提供的排盘结果与 AI 解读提示词仅供传统文化研究与休闲娱乐参考,不构成且不可替代医疗、心理、法律、投资等专业建议。


📄 开源协议

本项目基于 AGPL-3.0-only 协议开源。

About

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

Topics

Resources

Stars

406 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages