用途：基于中国传统九宫掌诀的小六壬占卜与命理分析，用于按用户提问生成三传（初传、中传、末传）预测并输出结构化解读报告。
主要能力：支持三种以上输入模式——三个数字（--numbers）、日期时间（--datetime，自动换算农历月/日/时支）、汉字（--chars，按笔画）、当前时间（--now）。脚本 scripts/xiaoliu.py 以 JSON 输出丰富分析字段，包括 input、input_numbers、passes、relations、subject_object、flow、patterns、combinations、timing_guidance、question 等。解读按七步框架展开：识别问题类别（财运/情感/事业/健康/学业/家庭/官非/出行八类）、体用定位、三传时序分析、五行整体流转、特殊组合识别、应期与方位、综合判断与建议。报告按固定小节顺序输出：卦象总览、时间脉络、体用与五行、关键组合、应期与方位、行动建议、结论。
使用方式：例如 uv run scripts/xiaoliu.py --numbers 1,2,3 --question "今日运势" --format json；时间、汉字、当前时间对应 --datetime、--chars、--now。默认使用内置模型解读；如需第三方模型，创建 config.yaml（格式 provider:model_name）并在 .env 设置对应 API Key，再通过 scripts/interpret.py 传入预测 JSON。支持 openai、anthropic、google-gla、deepseek、kimi、qwen、glm 等提供商前缀及对应环境变量。
适用场景：需要按具体问题（如面试、感情、出行等）获取小六壬占卜解读时使用；也可作为传统命理方法的演示与研究工具。
限制：属于传统占卜方法，结果不具科学必然性；使用第三方模型需要自行配置 API Key；资料未提供价格、收费或效果保证等信息。