moxiaonian
433c9b4a41
- 交互契约改对话式询问（禁点选工具、一次1~2问、先铺垫再问），规则库 3.6 - 盘面图默认生成+chart_shot 截图；品牌区、大运/流年小卡信息补全、交流群二维码卡 - day_boundary 子正换日；memory_save --update-chart 换盘留痕；share_export 事件简介+城市级地域 - share_push 失败诊断+代理引导；_runtime_guard；修 STAR_ORDER 三奇贵人 KeyError - README 规则计数 541→542；manifest 重建（1275 文件）；测试 142 项全绿
96 lines
5.9 KiB
Markdown
96 lines
5.9 KiB
Markdown
# 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 生成，仅供娱乐参考，不替代医疗、法律、投资、心理咨询等任何专业意见。
|