核心功能
cantian-bazi 是一款专注于中国传统历法与命理学的专业工具，主要提供三大核心能力：
1. 八字排盘：根据阳历或农历出生时间生成四柱八字（年柱、月柱、日柱、时柱），支持 ISO 8601 标准时间格式输入
2. 农历日期转换：将公历日期转换为对应的农历日期、干支纪年及节气信息
3. 黄历查询：提供传统宜忌信息（如嫁娶、出行、动土等），满足日常择吉需求
显著优点
- 历法精度高：基于标准天文算法计算干支历法，正确处理闰月、节气交界等复杂情况
- 子时处理灵活：支持两种子时划分方案（23:00-23:59 归属当天或次日），符合不同流派习惯
- 接口简洁：纯命令行调用，输出为结构化 Markdown，便于集成到自动化工作流
- 双语支持：文档与错误提示均提供中英文，降低使用门槛
局限性与注意事项
- 无图形界面：需通过命令行操作，对非技术用户不够友好
- 命理解读缺失：仅输出干支排盘结果，不包含十神、大运、流年等进阶命理分析
- 时区敏感：要求输入时间不带时区后缀，跨境使用时需注意本地时间换算
- 文化场景限制：核心功能聚焦东亚文化圈，对无农历背景的用户价值有限
适用人群
- 命理学研究者与爱好者
- 需要批量生成八字数据的开发者
- 传统文化相关应用的系统集成方
- 对黄历宜忌有查询需求的普通用户
风险等级评估
技术风险：低 —— 纯本地计算，无网络依赖与数据外泄风险
内容风险：中 —— 输出内容涉及命理预测，需明确标注娱乐/文化参考性质，避免被误解为科学建议
合规建议：在商业场景中使用时，应添加"仅供传统文化研究参考"等免责声明