🌐 在线使用 · 📖 新手教程 · 📚 完整文档 · 🔌 OpenAPI · 📦 mingyu-core (npm)
--- ## 🔮 支持功能 | 分类 | 术数方法 | 主要功能 | | :----------- | :--------------------------------------------------- | :--------------------------------------------------------------------------------------------- | | **命理运势** | 八字命理、紫微斗数、八字紫微合参、西方星盘、七政四余 | 支持真太阳时换算、大运流年流月流日细盘、三方四正、庙旺四化、神煞、合盘分析，以及七政行限与流曜 | | **周易占卜** | 六爻纳甲、梅花易数 | 支持手摇/指定卦象、京房八宫纳甲、六亲六神、世应动变、体用生克与四时旺衰 | | **三式绝学** | 奇门遁甲、大六壬、金口诀、太乙神数、皇极经世 | 支持时家转盘/飞盘奇门、月将天地盘四课三传、阴阳五用、年计七十二局与元会运世 | | **牌卡灵签** | 西方塔罗牌、雷诺曼牌、三山国王灵签、小六壬 | 包含 78 张塔罗全牌阵、36 张雷诺曼及大 Tableau、揭西祖庙 92 签全篇签谱 | | **择日风水** | 黄历择吉、八宅明镜、玄空飞星、五运六气 | 建除十二神与宜忌排查、东四西四命卦、三元九运飞星排盘、流年流月紫白加临与客主加临 | --- ## 🛠️ 开发者接入 ### 1. 核心算法包 `mingyu-core` ```bash npm install mingyu-core ``` ```typescript 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 文档](packages/core/README.md)。 ### 2. 公开 REST API 基础地址：`https://aov.cc/api/v1` - [API 接口文档](docs/api.md) · [OpenAPI 规范](https://aov.cc/api/v1/openapi.json) · [LLMs.txt](https://aov.cc/llms.txt) - 要把资料交给 AI 解读时，只调用一次对应的 `/prompt`；服务端会同时完成排盘并返回任务书。只有需要展示或继续计算结构化盘面时才调用 `/calculate`。 ### 3. MCP Server - **本地 npx CLI（Agent/Skill 首选；开箱即用）**： ```bash npx -y mingyu-mcp ``` 本地 CLI 默认采用 `full` 预设，返回完整结构化结果并默认计算当前年度星盘行运；请求在本地处理，不走 Cloudflare Pages Functions。 - **在线 Remote MCP（本地进程不可用或需要远程免安装时）**：在 Cursor、Windsurf、Claude Desktop 等客户端中配置 **Streamable HTTP** 远程端点：`https://aov.cc/mcp`（不要按旧版 SSE 类型配置）。在线提示词通常默认 `summary`，非幂等的一次性起卦、抽牌、求签提示词默认 `full`；显式 `responseMode` 优先。`summary` 不缩小算法计算范围；星盘默认本命 `natal`。在线范围限制见 [API 文档](docs/api.md#官方在线请求范围)。 - 需要 AI 解读时只调用一次 `*_prompt`；遇到 `RESOURCE_LIMIT` 先缩小或拆分参数，不要原样自动重试。在线 MCP 每条 JSON-RPC 消息单独发送一次 HTTP `POST`，不接受 batch；单条请求体最多 512 KiB。每次请求计入 Cloudflare 请求用量，避免轮询和紧密重试。在线 REST 的范围保护见 [API 文档](docs/api.md#官方在线请求范围)。 （本地源码开发也可通过 `pnpm mcp` 启动，详见 [MCP 服务文档](mcp/README.md)） ### 4. Agent Skill ```bash 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。 ```bash # 同步 Web 资源到 Android 工程 pnpm android:sync ``` --- ## 🚀 本地开发与构建 ```bash # 克隆仓库并安装依赖 git clone https://github.com/Brhiza/mingyu.git cd mingyu pnpm install # 启动开发服务器 pnpm dev # 运行测试 pnpm test # 打包构建 pnpm build ``` --- ## ⛩️ 关于三山国王灵签 三山国王是潮汕与客家地区重要的民间信仰，祖庙位于广东省揭西县河婆街道。作者整理并保留了祖庙传承的 92 签灵签体系，每签保留签号、签题、签诗原文与典故。 --- ## 🌟 基于命语构建 ### 时月东方 时月东方是一款基于命语核心能力构建的东方术数工具，使用 Vue 3 与 Vite 实现，也可以作为 `mingyu-core` 在独立产品中接入和使用的实际参考。 - 在线体验：[https://sydf.cc](https://sydf.cc) - 项目源码：[https://github.com/Brhiza/sydf](https://github.com/Brhiza/sydf) --- ## 📚 文档目录 - [文档总览](docs/README.md) - [术数能力与适用范围](docs/capabilities.md) - [公开 API 文档](docs/api.md) - [MCP Server 配置指南](mcp/README.md) - [mingyu-core 算法包说明](packages/core/README.md) - [开发、部署与环境配置](docs/development-and-deployment.md) --- ## ⚖️ 免责声明 本工具提供的排盘结果与 AI 解读提示词仅供传统文化研究与休闲娱乐参考，不构成且不可替代医疗、心理、法律、投资等专业建议。 --- ## 📄 开源协议 本项目基于 [AGPL-3.0-only](LICENSE) 协议开源。