紫微斗数专家包（ziwei-doushu）
本包提供紫微斗数的完整可核对链路：从出生信息到结构化命盘，经确定性分析，产出可交付报告。
何时使用
| 用户意图 | 触发表述示例 |
|---|---|
| 排盘起盘 | 「帮我排个紫微命盘」「起个盘」 |
| 看命格命盘 | 「我是什么命格」「看一下紫微盘」「命盘怎么样」 |
| 指定宫位 | 「我事业宫怎么样」「夫妻宫看什么」 |
| 飞星专项 | 「按北派飞星看」「来因宫在哪」「四化怎么飞」 |
| 运限查询 | 「今年运势如何」「现在在哪个大限」 |
| 口径追问 | 「为什么两个盘不一样」「子时怎么算的」 |
不适用场景
以下情况不要调用本包：
- 八字命理、四柱排盘 → 另有对应体系
- 塔罗占卜、星座运势、卜卦起卦 → 另有对应体系
- 姓名学、风水选址、八宅阳宅 → 另有对应体系
- 求医问药、投资理财、诉讼决策 → 本包仅供文化参考，不构成任何专业建议
- 「帮我算一下我能不能成功」「他会不会出轨」这类要求绝对化断语的问题 → 本包不做宿命论断
快速开始
# 完整链路：排盘 → 分析 → 报告
echo '{"birth_time":"1993-05-03T11:55:00","gender":"男","birth_place":"宁波市"}' \
| python3 lib/pipeline.py run
首次使用请先执行环境自检：
echo '{"action":"selftest"}' | node lib/chart-cli.js
三层架构
┌─────────────────────────────┐
出生信息 ─────▶ │ zwds-chart （事实层） │ 唯一排盘源
│ iztro 2.6.2 精确锁定 │ → canonical chart v2
└──────────────┬──────────────┘
│ 携带 calibration 口径声明
┌──────────────▼──────────────┐
│ zwds-analysis（分析层） │ 飞化链 / 一致性自审 / 覆盖率
│ authoritative=false │
└──────────────┬──────────────┘
│
┌──────────────▼──────────────┐
│ zwds-report （交付层） │ 单文件 HTML / 命盘图 / 口径声明
│ 零计算 │
└─────────────────────────────┘
依赖铁律：其它模块收到生辰字符串时必须拒绝并要求先产出 canonical chart v2；分析层输出不得作为出盘依据；交付层不得做任何排盘或解读计算。
本包的核心设计：口径可见
紫微斗数的子时归属、早晚子换日、流年换日属于各派真实存在的教义分歧。本包不做「消灭差异」，做「差异可见可解释」——每份命盘都随附 calibration 口径声明块，报告第 7 章明确告知：
- 排盘引擎与锁定版本
- 所用子时口径及该口径的说明
- 时辰来源（真太阳时校正后／钟表时间）
- 真太阳时校正的具体分钟数，跨时辰时显著标注
- 经度值、来源（用户提供／离线表／降级估算）
若同一生辰在不同口径下命宫不同，这是流派差异而非缺陷。报告顶部会主动提示，不静默吞掉。
子时三档策略
| 策略 | 23:00–23:59 | 适用 |
|---|---|---|
early_zi（默认） |
当日早子，日期不进位 | 保持向后兼容；不确定时用此档 |
late_zi_split |
晚子分离，日柱不变 | 晚子分离派 |
true_solar_zi |
真太阳时定子 | 强调真实太阳时的流派 |
用户出生时间在 23:00–00:59 时，必须主动询问口径选择，而非默认静默套用。
数据与隐私
- 出生信息属敏感个人信息，本地处理、不上传、不默认存档
- 如需存档，由用户明示同意后写入
profiles/ - 档案目录支持彻底删除，删除须用户显式确认
高风险动作与确认规则
本包仅在本地处理数据，以下动作必须先获得用户显式确认，不得自动执行：
| 动作 | 确认要求 | 不可自动执行的原因 |
|---|---|---|
删除档案（profile delete） |
必须用户显式指定 user_id 并确认 |
档案含出生信息，属不可恢复的个人数据 |
覆盖既有档案（profile save 同 id） |
须提示将覆盖并确认 | 避免误删已有解读记录 |
覆盖 golden 回归基准（manage-fixtures.js save） |
须提示基准将变更并确认 | 基准是回归保护基线，静默覆盖会掩盖排盘漂移 |
| 升级排盘引擎版本 | 须提示将改变排盘结果并确认 | 引擎升级可能改变命盘，属用户可感知的行为变更 |
| 写入包目录以外的路径 | 拒绝执行并说明 | 越界写入可能污染用户工作区 |
以下动作无需确认，可自动执行：排盘、分析、置信度评估、报告渲染、golden 基准校验（只读比对）。
若用户未确认，一律停在确认环节并说明将要发生什么，不得「先做后问」。
目录结构
ziwei-doushu-v2/
├── manifest.json 包元信息与口径默认值
├── lib/pipeline.py 编排层：链路 / 档案 / 上传前审核
├── skills/
│ ├── zwds-chart/ 事实层（唯一排盘源）
│ ├── zwds-analysis/ 分析层（飞化 / 自审 / 覆盖率）
│ └── zwds-report/ 交付层（HTML 渲染）
├── profiles/ 档案层（运行时生成，不入包）
└── docs/ 使用与契约文档
边界与免责
本包属传统文化研究工具，输出仅供自我认知与学习参考，不构成医疗、法律、投资、婚姻或其他专业建议。命盘反映的是倾向与可能性，而非既定结局。重大决策请基于理性判断并咨询相应领域专业人士。
版本与兼容性
- 排盘引擎
iztro锁定 2.6.2 精确版本；升级须重跑回归基准 canonical_chart_version独立演进，当前 2.0；过渡期输出含legacy兼容块- v3.0.0 将移除 legacy 块，届时消费方需按版本字段分支
更多文档
| 文档 | 内容 |
|---|---|
docs/CANONICAL-CHART.md |
命盘契约字段说明 |
docs/CALIBRATION.md |
口径体系与流派差异 |
README.md |
使用指南与常见问题 |
docs-source-map.md |
源材料继承映射（规划依据 → 包内资产） |
