convez.ai
Skill
yuduanliao-pixel

Book-of-Prophecy

yuduanliao-pixel/Book-of-Prophecy

Ver no GitHub
InicialPluginScore · de 0 a 100

京房納甲六爻卜卦:Claude skill + 離線排盤執行檔(窺天鏡 Book of Prophecy)。規則經 Claude+Codex 雙重查證。

Instalação

$npx convez-ai yuduanliao-pixel/Book-of-Prophecy

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v1.0.0
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

窺天鏡 Book of Prophecy — 京房納甲六爻卜卦

Skill 識別名:jingfang-liuyao

以京房納甲六爻(文王卦)體系打造的卜卦工具,提供兩種前端:

  1. Claude Skill — 在 Claude 中完成「問題精練 → 起卦 → 裝卦 → 斷卦解說」全流程。
  2. 離線排盤執行檔 — 單一 .exe,離線、雙擊即用,只做「起卦 + 裝卦 + 排盤顯示」,不含斷卦。

體系依據:《增刪卜易》《卜筮正宗》《火珠林》。所有起卦/裝卦規則均經 獨立雙重網路查證(Claude + codex)後定稿,並以單元測試對權威萬年曆與排盤驗證。

特色

  • 確定性引擎 + 彈性解說分離:隨機與查表交給可驗證的純函式引擎;取象與斷卦解說交給 LLM。
  • 密碼學等級亂數:擲幣使用 secrets,杜絕「腦補」結果。
  • 天文節氣計算:以截斷式 VSOP87 即時計算 24 節氣(精度約 ±1–2 分鐘,對照 timeanddate 天文金標準),完全離線、支援寬廣年份。
  • 完整裝卦:八宮世應、納甲納支、六親、六獸、伏神、旬空、月破、進退神、回頭生剋、互/錯/綜/變卦。
  • 學派可設定:換日策略(子初 23 時 / 子正 00 時 / 夜子時分日)可選。

重要的考據修正

  • 日柱基準:常見錯誤「2000-01-01 = 甲辰」,正確為 2000-01-01 = 戊午(乾淨錨點 2000-01-07 = 甲子)。雙方獨立查證一致,並以萬年曆與今日干支交叉驗證。
  • 擲幣語義:採火珠林計數法「字面 = 2(陰)、背面 = 3(陽)」,避免「正/反」歧義。1背=少陽、2背=少陰、3背=老陽、0背=老陰。

專案結構

jingfang-liuyao/
├── SKILL.md              # Claude skill 主指令
├── engine/               # 共用核心(純標準庫、確定性、可測)
│   ├── constants.py      # 干支/納甲納支/八卦/64卦/六獸/旬空/進退神…
│   ├── solar_terms.py    # 24 節氣天文計算(VSOP87)
│   ├── ganzhi.py         # 四柱干支 + 月令 + 旬空 + 旺相
│   ├── bagua.py          # 卦名/互錯綜變/八宮生成
│   ├── cast.py           # secrets 擲幣 + 成卦 + 手動輸入
│   ├── zhuanggua.py      # 定宮/世應/納甲/六親/六獸/伏神
│   ├── divination.py     # 排盤組裝
│   └── render.py         # 文字渲染(CJK 對齊)
├── scripts/cast.py       # skill 工具:輸出 JSON 排盤
├── app/paipan.py         # 離線執行檔進入點
├── references/           # 速查表、八宮 64 卦對照、節氣權威覆蓋表
├── tests/test_engine.py  # 驗收測試
└── build/build_exe.ps1   # PyInstaller 打包腳本

使用方式一:Claude Skill

將本 repo 放入 Claude Code 的 skills 目錄(或作為 plugin),即可由「卜一卦/占卜/起卦/六爻」等語境觸發。流程見 SKILL.md。

使用方式二:離線排盤執行檔

下載 jingfang-liuyao-paipan.exe(見 GitHub Releases,或自行建置),雙擊執行進入互動選單:

  1. 輸入占問
  2. 選擇起卦時間(系統時間 / 手動指定)
  3. 選擇換日策略
  4. 選擇起卦方式(自動擲幣 / 手動輸入錢面)
  5. (可選)選擇占問類別以標示用神候選

也支援命令列:

# 自動擲幣、系統時間
jingfang-liuyao-paipan.exe -q "面試能否錄取" -c "求職/官司/疾病/功名"

# 指定時間 + 手動錢面(由下而上,每組三枚;字=2陰、背=3陽)
jingfang-liuyao-paipan.exe -q "面試" -t "2026-06-13 14:32" -m "背背字;背背背;背字字;背字字;背字字;背字字"

# 輸出 JSON(可交給 skill 做斷卦)
jingfang-liuyao-paipan.exe -q "今日運勢" --no-interactive -e json

輸出包含:占問、起卦時間(天干地支、月令、旬空、節氣)、擲幣過程(由下而上)、卦象(條列)、裝卦表(由上而下,含六獸/伏神/六親/納甲/旺衰/世應/動/變爻/旬空月破),以及世應、動爻摘要、日辰關係等補充。不含斷卦與結論。

從原始碼建置執行檔

需要一個安裝了 PyInstaller 的 Python(建議 3.11):

pip install pyinstaller
# 在 repo 根目錄
powershell -ExecutionPolicy Bypass -File build/build_exe.ps1
# 產物:dist/jingfang-liuyao-paipan.exe

開發與測試

引擎僅用標準庫,任何 Python 3.8+ 皆可:

python tests/test_engine.py        # 或 python -m pytest

測試涵蓋:日柱錨點、立春換年/換月邊界、換日策略、旬空、八宮 64 卦唯一性、天風姤完整裝卦與伏神、互錯綜變、擲幣機率分布、字背計數法。

references/solar_terms_2020_2040.csv 可覆蓋特定節氣權威時刻;未列入的節氣會自動回落到內建天文演算法。

免責聲明

本工具為傳統術數之文化與程式實作,占卜結果僅供參考與自省,不構成醫療、法律、投資或任何專業建議。涉及健康、安全、重大決策請尋求專業協助。

授權

MIT License

Ver o original no GitHub

Bom para

Relacionados