# ZiPingEightChar · 子平八字（公众授权版）

> 子平八字排盘 + 《子平真诠》格局法解释的 AI 技能（Skill）。
> 输入姓名、性别、出生日期时刻、出生地，输出结构化命盘 Markdown，并由模型依随附的 542 条编号规则完成取格、成败、用神相神、行运、六亲与流年流月解释。

## 这是什么

这是一个面向 AI Agent 的技能包（Skill），由两部分组成：

- **排盘脚本（`scripts/`）**：纯计算器，不含任何命理判断。把出生钟表时间换算成真太阳时（经度修正 + 均时差 + 夏令时回拨），经子初换日定日历日，调用内置的 tyme4py 排出命盘，输出自包含 Markdown：四柱、地支藏干、空亡、纳音、神煞（子平通行查法、注明锚点）、节令、大运、小运（童限）、全量流年（出生年至今 +10 年、逐年标注所属大运）、流月及排盘审计；生于交节前后 12 小时内的盘自带节气边界提示。
- **规则库（`rules/`）**：542 条编号规则，以《子平真诠》格局法为骨架，蒸馏《滴天髓阐微》《穷通宝鉴》《命理探源》《三命通会》为参看层（`rules/sources/` 按书归档五书原文可供回查），含女命专篇、神煞细节、童限等拓展层（拓展条逐条标注【拓展】）。模型按 SKILL.md 的执行顺序加载规则完成解释。
- **命主档案（`memory/`）**：本地留存每位命主的排盘与解读归纳（含「已核实/已证伪/未核实」三态反馈记录），同一命主再看时查档延续。档案只存本机，不随副本分发。

## 快速开始

**零依赖**：只需 Python ≥ 3.10。tyme4py 1.5.0 与 tzdata 已内置在 `vendor/`，无需 `pip install`。

```bash
python scripts/cast_chart.py --name 张三 --gender 男 \
    --birth "1990-05-14 08:30" --place "四川省成都市"
```

成功时命盘 Markdown 打印到 stdout（退出码 0），诊断信息走 stderr。

| 退出码 | 含义 |
|---|---|
| 0 | 成功 |
| 2 | 输入不可用（地点无法解析 / 时间格式错误或缺时刻） |
| 3 | 库内部错误 |
| 4 | 授权不可用（次数用尽 / 已到期 / 授权文件被改动） |

四个输入参数全部必需：`--name`、`--gender`（男/女，决定大运顺逆）、`--birth`（当地钟表时间 `"YYYY-MM-DD HH:MM"`，时刻必需）、`--place`（支持全国县级行政区，精确到县最佳）。

另配岁运神煞查询工具 `scripts/query_shensha.py`，查某流年/流月/大运干支相对本命所逢之神煞。

## 作为 AI Skill 使用

将整个目录放入你的 Agent 技能目录（如 Kimi / Claude 等支持 SKILL.md 规范的环境），Agent 会自动按 `SKILL.md` 的契约排盘与解释：

1. 问题归类与场景判定（命主本人/替人看、能否核对）→ 2. 脚本排盘 → 3. 加载 `rules/00_总纲_取格.md` 六步定格 → 4. 分格文件判成败、用神相神 → 5. `rules/90_行运.md` 断运（童限段另有 §10 小运规则）→ 6. 六亲/女命/神煞细节按需叠加。

解释输出遵循「直答先行」契约（v3.0）：先直答所问（一个主答案 + 置信度），再给白话的现实对应，术语推理置后，规则编号默认不进入用户面输出（追问依据或调试模式下展开），最后声明存疑与边界。

## 规则库质量

规则库已经两轮原书命例黄金集验证（`rules/tests/`），合计 291 例：《子平真诠》批 92 例（88 match / 1 例属原书文本分歧 / 3 例传抄缺陷不可验证），《滴天髓阐微》批 199 例（198 match / 1 例传抄缺陷不可验证）。

## 目录结构

```
SKILL.md            技能入口：用法、输出契约、解释规则、文风要求
rules/              542 条编号解释规则（20 个文件）
  sources/          五书原文归档（回查用）
  tests/golden/     原书命例黄金集
scripts/            排盘脚本（astro/ chart/ geo/ render/ 分层）与岁运神煞查询
data/               城市经纬度数据与授权状态
memory/             命主档案（archives/ 数据仅存本机）
vendor/             内置依赖：tyme4py 1.5.0 + tzdata（纯 Python）
tests/              排盘脚本测试（时区、夏令时、日界、流年小运、端到端）
```

## 授权说明（重要）

本仓库为**公众版**：

- **首启签发**：首次排盘时自动在本机签发个人副本（副本编号 `LY-日期-随机`），**初始 20 次、不限期**；授权状态只存本机 `data/.license.json`（不入库）。
- **档案共建激励**：每成功推送一份脱敏档案（见下），授权次数 **+10**；同一盘（四柱+出生地）只计一次。
- **水印指纹**：副本编号（池编号 `LY-20261007-AC63` + 个人编号）嵌入 SKILL.md、rules/ 各文件、cast_chart.py 与授权状态文件，泄露可溯源。
- 软锁（`scripts/_license_gate.py`）：次数用尽后排盘脚本拒绝运行（退出码 4）。完整授权条款见 [LICENSE.md](LICENSE.md)——**禁止商业用途，禁止二次传播**。本技能全部知识产权归 **四川灵爻妙解文化传播有限公司** 所有。

## 自更新

技能会持续迭代。排盘后有新版本时 stderr 会提示一行；更新由你决定：

```bash
python scripts/self_update.py --check   # 检查更新（24h 缓存）
python scripts/self_update.py --apply   # 应用更新（先校验 SHA256 清单再换文件，授权与档案保留）
```

更新线路 GitHub 优先、Gitea 镜像兜底。

## 开发

```bash
pip install -r requirements.txt   # 仅开发/跑测试需要
python -m pytest tests/           # 排盘脚本测试
```

删除 `vendor/` 即回退到环境安装的依赖包，两种方式输出一致（`requirements.txt` 锁定版本）。

---

灵爻妙解 · 传承易学智慧 · https://lingyaomiaojie.com

> 本技能输出由 AI 生成，仅供娱乐参考，不替代医疗、法律、投资、心理咨询等任何专业意见。