核心用法
Ziwei-doushu 是一款专业级紫微斗数排盘与解读工具，核心功能是将出生日期时间转换为完整的紫微命盘结构。用户需提供准确的出生年月日时（精确到分钟）及性别，系统基于 Asia/Shanghai 时区与东经 120 度标准进行离线计算，生成包含命宫、身宫、十二宫位、主星组合、三方四正、四化飞星、大限（十年运程）及流年触发的完整报告。
推荐调用方式为命令行脚本 ziwei_chart.py，支持多种参数配置：--engine 可选择纯 Python、JavaScript 或双引擎交叉验证；--template 提供精简版、专业版与高管摘要三种输出密度；--format 支持 Markdown 或 JSON 格式导出。图表渲染可选 SVG 或 JPG，采用 CairoSVG 等离线后端，确保完全脱离网络依赖。
显著优点
方法论透明：明确区分「命盘事实」（星曜位置、宫位结构）与「传统解读框架」（性格倾向、运势趋势），避免神秘化措辞，呈现风格更接近数据分析师而非命理师。
计算严谨性：采用北京标准时间统一时区，消除真太阳时争议；双引擎模式可自动标记计算差异，提升结果可信度。
输出结构化：强制包含职业、感情、财务、健康四大生活领域的实用摘要，并标注「当前年度焦点与风险边界」，直接服务于决策参考而非玄学消费。
完全离线：无网络依赖，无云端数据传输，适合隐私敏感场景。
潜在局限
输入敏感性：紫微斗数对出生时间精度要求极高（误差 2 小时可能导致命宫错位），工具本身无法验证用户提供的出生时间准确性。
解释框架边界：虽然强调「趋势而非定数」，但传统命理符号系统本身带有宿命论色彩，用户可能过度解读确定性结论。
可视化限制：图表导出依赖本地 CairoSVG 等库，若环境缺失则退化为纯文本输出，阅读体验下降。
双引擎差异处理：当 Python 与 JavaScript 计算结果不一致时，工具仅「呈现差异」而非仲裁，需用户自行判断，对新手不够友好。
适合人群
- 希望以结构化、低神秘化方式了解自我特质的理性用户
- 需要离线运行、保护隐私的命理研究者
- 将紫微斗数作为「趋势参考工具」而非决策唯一依据的职场人士
常规风险
心理暗示风险：命盘解读可能触发自我实现预言效应，建议用户明确「参考框架」定位。
时间换算争议：部分流派主张使用真太阳时，工具固定采用东经 120 度标准，可能与用户预期冲突。
健康/财务建议边界：工具明确声明不提供医疗、法律或投资建议，但用户可能在焦虑状态下过度依赖运势解读。
文化敏感性：紫微斗数涉及传统命理信仰，输出内容需注意避免对特定群体造成冒犯。