zhiji-bazi

八字排盘的核心算法，TypeScript 写的。输入出生时间，输出四柱、身强弱、格局、用神。

English

这是知己排盘的计算引擎，从生产环境里拆出来开源的部分。它只做计算，不生成解读文案，也不做任何预测。

npm install zhiji-bazi     # 或者 bun add zhiji-bazi

包里带编译好的 ESM JavaScript 和类型声明，Node 和 Bun 都能直接用。TypeScript 源码也一起打进去了。

import { computeChart, displayString } from "zhiji-bazi";

const r = computeChart({
  birthDate: new Date("2000-01-01T04:00:00Z"), // 北京时间 2000-01-01 12:00
  timeZone: "Asia/Shanghai",
  isMale: true,
});

console.log(displayString(r.bazi));   // 己卯 丙子 戊午 戊午
console.log(r.strength.level);        // strong
console.log(r.pattern.pattern);       // zhengCai
console.log(r.yongShen.yongShen);     // metal

四层，可信度不一样

这个仓库里的四层东西性质不同，用之前建议分清楚。

第一层，历法与四柱。 公历、农历、节气、干支的换算。有唯一正确答案，可以拿天文数据核对。年柱以立春换年不以元旦，月柱以节气分界不以农历月，晚子时的日柱归属提供三种规则。

第二层，真太阳时。 经度校正加时差方程。也有唯一正确答案。

很多排盘实现只做了经度校正，漏掉时差方程，而时差方程全年在 -14 到 +16 分钟之间波动，时柱以两小时为一界，这十几分钟足以让时柱错一位。

import { correctToTrueSolarTime, equationOfTime } from "zhiji-bazi";

// 乌鲁木齐用北京时间，真太阳时比钟表早两小时以上
const corrected = correctToTrueSolarTime({
  date: new Date("2000-01-01T04:00:00Z"),
  longitude: 87.6,
  tzOffsetMinutesStandard: 480,  // 必须是剥离夏令时之后的标准偏移
});
// 校正前时柱戊午，校正后丁巳，差一柱

tzOffsetMinutesStandard 必须先剥离夏令时。夏令时只是把钟拨快了，不改变太阳的位置，用带夏令时的偏移会让标准子午线整体算错一个时区。

第三层，身强弱。 按得令、得地、得势三要素打分。这一层开始有立场了。

第四层，格局与用神。 定格、判成败、取用神。各流派口径差别很大，这里给的是一种算法口径。

MCP server

包里带一个 MCP server，AI agent 可以直接连上算盘。

Claude Desktop、Cursor 这类启动子进程、走标准输入输出的客户端，配置里这样写：

{
  "mcpServers": {
    "zhiji-bazi": {
      "command": "npx",
      "args": ["-y", "zhiji-bazi-mcp"]
    }
  }
}

想要 HTTP 而不是标准输入输出，跑 bun run mcp/server.ts，默认监听 8787，每个 IP 每分钟限 60 次，用 MCP_CALLS_PER_MIN 改。

两个入口都只有一个工具 bazi_compute，输入支持公历、农历、直接给四柱三种方式，给了 longitude 就按真太阳时校正。initialize 返回的 instructions 字段里写了转述结果时该守的边界，客户端会把它放进模型的上下文。

不想自己跑的话，知己排盘有托管的端点，后面是完整引擎：

https://zhijipaipan.com/bazi-api/mcp
https://api.szxishe.cn/mcp

已知局限

格局判定有已知的假阳性。 内部审计发现从格判得偏松，会把一些本该按正格论的盘判成从格，找到六个根因，代码里 R1、R2严、R5 几处注释就是那轮修正留下的。现在比审计前收紧了，但不能说已经解决。

身强弱、格局、用神是有争议的判定。 同一张盘，格局派、旺衰派、盲派会给出不同甚至相反的结论。这个仓库实现的是一种口径，不是标准答案。拿它的输出对用户说话时，建议说明这一点。

阈值是调出来的，不是推导出来的。 强弱分档、成格败格的边界都来自实践校准，换一批盘重调，结果会变。

没有跨实现的一致性保证。 跟其他排盘软件对不上是常态，尤其在晚子时、闰月、节气交界这几个地方。这里的选择在代码注释里都写了理由。

不在这个仓库里的

神煞、大运流年、关系合盘、纳音、地理五行、AI 解读文案，这些都不在。想要完整结果去 zhijipaipan.com，或者连上面那个托管的 MCP 端点。

免责

八字属于传统文化范畴，不构成任何形式的决策依据。这个仓库提供的是符号系统的计算，不预测事件，不给投资、医疗、法律建议。

出生时间是个人数据。仓库里的测试和示例一律用合成盘或者历法边界日期，不含任何真实个人信息，建议你也这么做。

开发

bun install
bun test          # 15 个测试，覆盖历法、立春换年、晚子时、时差方程、端到端
bun run typecheck
bun run build

License

Apache-2.0。见 LICENSE 和 NOTICE。