moxiaonian
d9da4301cd
副本编号 LY-20261007-AC63（水印指纹已嵌入） 含 README、.gitignore；排除 .DS_Store / __pycache__ / .pytest_cache
83 lines
4.3 KiB
Markdown
83 lines
4.3 KiB
Markdown
# 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 生成，仅供娱乐参考，不替代医疗、法律、投资、心理咨询等任何专业意见。
|