用途：面向提供生辰（阳历或农历日期、时辰、性别）并询问八字、紫微、命理、命盘、流年大运的用户，做排盘与解读。不处理星座、塔罗、周公解梦、风水、姓名学。
主要能力：八字独立分析（事业、财运、婚恋、子女、六亲、健康，按格局推演）；紫微独立分析（十二宫、大限、生年四化、流年）；八字加紫微综合印证，可输出 Markdown 长文或单文件 HTML 海报。排盘由算法层完成，输出四柱、十神、藏干、大运，以及格局、旺衰、调候、五行统计、干支关系等补全信息。
使用方式：先做决策门，询问用户要哪种分析；若选综合印证，再问呈现形态。排盘命令：cd calculator 后运行 npx tsx run-chart.ts --year=YYYY --month=MM --day=DD --hour=HH --minute=MM --gender=male > chart.json，注意只重定向 stdout。再用 npx tsx dump-text.ts --input=chart.json --output=chart.txt 转成可读文本，连同对应提示词交给 LLM 分析。海报版需 LLM 输出严格 JSON，保存为 analysis.json 后运行 render.ts 渲染 HTML。
限制：必需公历或农历日期、出生时刻（24 小时制）、性别；缺时辰须主动询问，不默认子时。不使用出生地，不做真太阳时校正。HTML 海报仅支持综合印证模式。不引入风水、姓名、阳宅等命盘外变量。边界情况需标注低置信度，不替用户做决策，敏感问题拒答，输出末尾附仅供文化研究与娱乐参考的免责声明。安装后不主动自检或跑示例，依赖报错时再执行 npm install。日期超出 1900-2100 或时辰格式错误需请用户校正。