公众授权版：normal · 1000 次 · 有效期至 2026-12-31

副本编号 LY-20261007-AC63（水印指纹已嵌入）
含 README、.gitignore；排除 .DS_Store / __pycache__ / .pytest_cache

README.md

@@ -0,0 +1,82 @@
+# ZiPingEightChar · 子平八字（公众授权版）
+
+> 子平八字排盘 + 《子平真诠》格局法解释的 AI 技能（Skill）。
+> 输入姓名、性别、出生日期时刻、出生地，输出结构化命盘 Markdown，并由模型依随附的 380 条编号规则完成取格、成败、用神相神、行运、六亲与流年流月解释。
+
+## 这是什么
+
+这是一个面向 AI Agent 的技能包（Skill），由两部分组成：
+
+- **排盘脚本（`scripts/`）**：纯计算器，不含任何命理判断。把出生钟表时间换算成真太阳时（经度修正 + 均时差 + 夏令时回拨），经子初换日定日历日，调用内置的 tyme4py 排出命盘，输出自包含 Markdown：四柱、地支藏干、空亡、纳音、神煞、节令、大运、流年、流月及排盘审计。
+- **规则库（`rules/`）**：380 条编号规则，以《子平真诠》格局法为骨架蒸馏而成（`rules/sources/` 附 50 篇原文可供回查），含女命专篇与神煞细节拓展层（拓展条逐条标注【拓展】）。模型按 SKILL.md 的执行顺序加载规则完成解释。
+
+## 快速开始
+
+**零依赖**：只需 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`（支持全国县级行政区，精确到县最佳）。
+
+## 作为 AI Skill 使用
+
+将整个目录放入你的 Agent 技能目录（如 Kimi / Claude 等支持 SKILL.md 规范的环境），Agent 会自动按 `SKILL.md` 的契约排盘与解释：
+
+1. 脚本排盘 → 2. 加载 `rules/00_总纲_取格.md` 六步定格 → 3. 分格文件判成败、用神相神 → 4. `rules/90_行运.md` 断运 → 5. 六亲/女命/神煞细节按需叠加。
+
+解释输出遵循「白话先行」契约：先说人话（逐条对应现实场景），再附术语备查与规则编号，最后声明存疑与边界。
+
+## 规则库质量
+
+规则库已经《子平真诠》原书 92 个命例黄金集验证（`rules/tests/`）：87 例重推与原书判定一致，2 例 mismatch 暴露的规则措辞问题已回修，3 例因原书传抄缺陷不可验证。
+
+## 目录结构
+
+```
+SKILL.md            技能入口：用法、输出契约、解释规则、文风要求
+rules/              380 条编号解释规则（16 个文件）
+  sources/          《子平真诠》50 篇原文（回查用）
+  tests/golden/     原书命例黄金集
+scripts/            排盘脚本（astro/ chart/ geo/ render/ 分层）
+data/               城市经纬度数据与授权状态
+vendor/             内置依赖：tyme4py 1.5.0 + tzdata（纯 Python）
+tests/              排盘脚本测试（时区、夏令时、日界、端到端）
+```
+
+## 授权说明（重要）
+
+本仓库为**公众授权版**副本：
+
+- **副本编号**：`LY-20261007-AC63`（水印指纹，嵌入 SKILL.md、rules/ 各文件、cast_chart.py 与授权状态文件，泄露可溯源）
+- **授权对象**：normal（公众）
+- **授权额度**：排盘 **1000 次**
+- **有效期至**：**2026-12-31**
+
+副本内置软锁（`scripts/_license_gate.py`）：次数用尽或到期后排盘脚本拒绝运行（退出码 4）。完整授权条款见 [LICENSE.md](LICENSE.md)——**禁止商业用途，禁止二次传播**。本技能全部知识产权归 **四川灵爻妙解文化传播有限公司** 所有。
+
+## 开发
+
+```bash
+pip install -r requirements.txt   # 仅开发/跑测试需要
+python -m pytest tests/           # 排盘脚本测试
+```
+
+删除 `vendor/` 即回退到环境安装的依赖包，两种方式输出一致（`requirements.txt` 锁定版本）。
+
+---
+
+灵爻妙解 · 传承易学智慧 · https://lingyaomiaojie.com
+
+> 本技能输出由 AI 生成，仅供娱乐参考，不替代医疗、法律、投资、心理咨询等任何专业意见。