开发者接入

通过 Rust、Python、Node.js、WebAssembly、CLI 或 MCP 接入同一套八字与奇门排盘引擎。请求显式指定公历时间，结果保留盘式、规则与各宫元素。

默认使用 UTC+08:00 与子初换日，扩展标注默认关闭。完整参数见时间约定和扩展参数表。

Python

python -m pip install qimen-rs

from qimen_rs import calculate

chart = calculate({"year": 2026, "month": 9, "day": 18, "hour": 18})
print(chart["palaces"])

Python 3.10+，返回字典；calculate_json 接受和返回 JSON 字符串。

完整 Python 接口说明

Node.js

npm install @spensercai/qimen-rs

import { calculate } from '@spensercai/qimen-rs';

const chart = calculate({ year: 2026, month: 9, day: 18, hour: 18 });
console.log(chart.palaces);

Node.js 20+，支持 ESM、CommonJS 和 TypeScript。安装时请保留平台可选依赖。

完整 Node.js 接口说明

浏览器 / WebAssembly

npm install @spensercai/qimen-wasm

import init, { calculate } from '@spensercai/qimen-wasm';

await init();
const chart = calculate({ year: 2026, month: 9, day: 18, hour: 18 });
console.log(chart.palaces);

用于能解析 npm 和 WASM 资源的浏览器打包器。须先等待初始化完成，并部署包中的 .wasm 文件；批量计算建议放到 Worker。

完整浏览器 / WebAssembly 接口说明

Rust

cargo add qimen-core

use qimen_core::{ChartRequest, calculate};

fn main() -> Result<(), qimen_core::Error> {
    let chart = calculate(&ChartRequest::new(2026, 9, 18, 18))?;
    println!("{:?}", chart.calendar.four_pillars);
    Ok(())
}

库不读取机器时区或当前时间，输入校验与错误通过类型返回。

完整 Rust 接口说明

CLI 与 MCP

从 GitHub Release 下载对应平台程序，或通过 Cargo 安装 CLI 和 MCP 服务。

cargo install qimen-cli qimen-mcp
qimen paipan --year 2026 --month 9 --day 18 --hour 18 --json

MCP 默认使用 stdio，客户端命令填入 qimen-mcp；也可启动 Streamable HTTP，连接本机 /mcp 端点。

qimen-mcp --transport streamable-http
# MCP endpoint: http://127.0.0.1:8080/mcp

工具包括 bazi 与 paipan；后者可接收可选扩展参数。向网络开放 HTTP 服务前请按部署环境配置访问控制。

CLI 与 MCP 参数说明