Awesome Bazi Calculator - Cantian AI

核心用法

参天 AI 八字排盘（cantian-bazi）是一款基于 Node.js 的命理计算工具，通过命令行脚本将阳历出生时间转换为传统四柱八字系统。用户只需提供 ISO 8601 格式的出生时间，即可自动生成天干地支、五行属性、十神关系及各类神煞信息。

基本命令结构：

node scripts/buildBaziFromSolar.js <solarTime> [gender] [sect]

关键参数解析：

• solarTime：核心输入，要求严格的 YYYY-MM-DDTHH:mm:ss 格式，不含时区
• gender：性别标识（1 为男，0 为女），影响大运排法顺逆
• sect：子时分界配置，23:00-24:00 的临界时间处理存在学术争议，参数 1 将晚子时归为次日，参数 2 则算当日

显著优点

1. 标准化输出：将传统命理数字化，避免人工查万年历的繁琐与误差
2. 学术灵活性：子时分段配置满足不同流派需求（盲派多按次日，传统派有分歧）
3. 轻量集成：纯 Node.js 实现，易于嵌入现有 AI 对话系统或命理平台
4. 双语文档：中英文对照，服务全球华语用户

潜在局限

• 输入格式严格：不支持自然语言时间描述，必须预先转换为 ISO 8601
• 无真太阳时校正：未考虑出生地经度与北京时间差异，高精度命理分析需手动换算
• 无大运流年计算：当前版本仅输出静态命盘，动态运势推演需额外开发
• 神煞算法黑盒：文档未公开神煞判定规则，难以验证与学术标准的符合度

适合人群

• 命理爱好者快速排盘自查
• AI 产品经理集成东方命理功能
• 命理师批量处理客户基础信息
• 传统文化研究者进行八字数据化研究

常规风险提示

命理分析属文化娱乐范畴，输出内容仅供参考，不应作为人生重大决策的唯一依据。部分司法管辖区对命理预测服务有合规要求，商业使用前建议审查当地法规。

核心用法

cantian-bazi 是一款专注于中国传统命理学的八字排盘技能，通过 Node.js 脚本调用本地计算引擎，将阳历出生时间转换为完整的四柱八字命盘。用户只需提供 ISO 8601 格式的出生时间（如 1990-05-15T14:30:00），技能即可自动计算年柱、月柱、日柱、时柱，并输出五行属性、十神关系、神煞信息等核心命理数据。

技能支持性别参数（影响大运排列方向）和子时配置（处理 23:00-23:59 的边界争议），满足不同流派的排盘需求。执行方式为本地 CLI 脚本调用，结果通过标准输出返回，便于集成到自动化工作流或进一步分析处理。

显著优点

算法专业性：依托 cantian-tymext 专用命理计算库，内置完整的干支历转换、节气判定、真太阳时校正等传统命理算法，排盘精度达到专业命理软件水准。

完全离线运行：无任何网络请求，所有计算在本地完成，用户敏感的出生信息不会外传，隐私安全性极高。

轻量化设计：代码结构简洁（仅 105 行、5 个文件），依赖单一，启动速度快，适合嵌入式场景或批量处理需求。

参数灵活配置：支持子时早晚争议设置（sect 参数），兼容不同命理流派的计算习惯；性别参数影响大运顺逆排列，满足个性化分析需求。

双语言支持：SKILL.md 提供完整的中英文文档，便于国际用户理解和使用。

潜在缺点与局限性

来源可信度局限：Skill 及核心依赖均为个人开发者（T3 级别）维护，无企业或组织背书，长期维护持续性存在一定不确定性。

开源协议模糊：当前标记为 "Proprietary" 专有软件，但未提供详细许可证文件，商业使用可能存在合规风险。

功能边界清晰：仅提供基础排盘数据输出，不包含 AI 解读、运势分析、大运流年推算等进阶功能，需用户自行解读或结合其他工具使用。

生态依赖单一：核心计算逻辑完全依赖 cantian-tymext 单一 npm 包，若该包停止维护或出现安全问题，将直接影响 Skill 可用性。

输入格式严格：强制要求 ISO 8601 格式且不带时区，对非技术用户不够友好；不支持农历直接输入，需先转换阳历。

适合的目标群体

• 命理学研究者与爱好者：需要快速获取标准八字排盘数据，进行命理论证或学术研究
• 传统文化内容创作者：生成命理分析内容时，需要可靠的排盘数据支撑
• 开发者与工具集成者：需要将八字计算能力集成到自有应用、小程序或自动化流程的技术人员
• 隐私敏感型用户：不愿将出生信息提交至在线排盘网站，偏好本地计算方案

使用风险说明

依赖维护风险：核心依赖 cantian-tymext 发布于 2 个月前，虽已有 27 个版本迭代，但属个人项目，建议每月运行 npm audit 关注安全更新，并考虑锁定版本防止意外升级。

许可证合规风险：专有软件标记缺乏详细授权条款，商业场景使用前建议联系维护者确认授权范围。

算法权威性声明：八字命理属传统文化范畴，计算结果仅供文化研究参考，不构成科学预测依据，使用者需理性看待。

数据输入精度：技能处理精确到秒的出生时间，但实际八字计算仅需小时精度，建议用户了解最小必要原则，避免过度提供个人信息。