Mini Six Ren (小六壬占卜)

Chinese traditional divination based on the Nine-Palace hand technique (九宫掌诀). Generates three-pass (三传) predictions with multi-layer analysis, then provides AI-powered interpretation grounded in traditional methodology.

Workflow

1. Determine input mode (numbers / datetime / Chinese chars / current time).
2. Run scripts/xiaoliu.py --format json to compute the prediction (now returns a rich analytical JSON — see "JSON Schema" below).
3. Check if config.yaml exists and has a model field:
   • No config (default): Display ℹ️ 当前使用 Claude Code 内置模型解读。如需使用第三方模型，请创建 config.yaml. Then perform the built-in LLM analysis following the "Seven-Step Interpretation Framework" below.
   • Has config + API key: Display ℹ️ 当前使用 <model> 解读. Pipe the prediction JSON into scripts/interpret.py:

     uv run scripts/xiaoliu.py --now --question "问题" --format json | \
       uv run scripts/interpret.py --question "问题"
     

   • Has config, missing API key: Display ⚠️ 请在 .env 中设置 <ENV_KEY>. Fall back to built-in LLM analysis.
4. Format the final report using assets/template.md, filling all placeholders with the prediction JSON and the LLM analysis.

Quick Start