Cyber I Ching Master - OpenClaw Skill
概述
Cyber I Ching Master（赛博易经大师）是一个融合三千年周易智慧的数字占卜系统。它不仅是简单的算命工具，而是帮助用户通过卦象观照自身、理解事物发展趋势的智慧向导。
核心哲学
易者不占：真正精通易理之人，遇事观其势即可决断。起卦是为问事者明心，非为占卜未来。
吉凶在人：卦象示势，人事定吉凶。同一卦，君子得之则吉，小人得之则凶。
变易为常：无不变之卦，无不变之事。老阴老阳之变，正是天道好生之机。
核心功能
1. 起卦方式
大衍之数（蓍草法）
传统最正统的起卦方法，通过50根蓍草经过18次演变为六爻。
from scripts import CyberIChingMaster
master = CyberIChingMaster("scripts/data/hexagrams.json")
result = master.milfoil(question="事业发展如何？")
print(master.render(result))
金钱卦
用三枚铜钱抛掷六次，简单易行。
result = master.coin(question="婚姻如何？", seed="123")
print(master.render(result))
数字卦
随意报三个数字起卦，随缘自在。
result = master.number([37, 58, 16], question="财运如何？")
print(master.render(result))
2. 义理生成器（象→数→理三层解读）
from scripts import InterpretationEngine
engine = InterpretationEngine("scripts/data/hexagrams.json")
# 完整三层解读
result = engine.generate_full_interpretation(
"000000", # 卦码
question="事业", # 所问之事
changing_yao=[3] # 变爻列表
)
print(result)
# 单独使用各层解读
print(engine.interpret_xiang("000000")) # 象层
print(engine.interpret_shu("000000", [1, 3])) # 数层
print(engine.interpret_li("000000", "事业", [3])) # 理层
print(engine.interpret_yao_detail("000000", [3])) # 爻辞详解
print(engine.quick_read("000000")) # 快速读卦
3. 八字排盘
from scripts import BaZiMaster
bazi = BaZiMaster()
result = bazi.parse_birth(1990, 8, 15, 10)
print(bazi.render(result))
使用示例
示例1：简单起卦
User: 我想问一下我的事业发展
Bot: 善。吾已联网天地之气，为汝起卦。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
得卦：泽天夬 夬（guài）
变爻：第3爻
之卦：乾为天 乾（qián）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【卦辞】扬于王庭，孚号有厉...
【大象】泽上于天，夬...
示例2：三层解读
User: 详细解读乾卦
Bot: ╔══════════════════════════════════════╗
║ ☯️ Cyber I Ching Master ║
║ 象 → 数 → 理 三层解读 ║
╚══════════════════════════════════════╝
【本卦】乾（qián）乾为天
━━━ 【象层】卦象图像 ━━━
上卦 ☰ 乾 — 天
下卦 ☰ 乾 — 天
象意：刚健纯阳，创造不息
━━━ 【数层】五行数理 ━━━
上卦 乾 属 金
下卦 乾 属 金
同气相求，气势和谐
━━━ 【爻辞详解】 ━━━
【用九】见群龙无首，吉。
【第1爻 初】初九
爻辞：潜龙勿用。
义译：龙潜于渊，宜藏不宜露...
━━━ 【理层】义理哲学 ━━━
【卦辞】元亨利贞。
【大象】天行健，君子以自强不息。
示例3：八字排盘
User: 帮我看看八字，1990年8月15日10点
Bot: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
☯️ Cyber I Ching Master · 八字排盘
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
柱 天干 地支 藏干 十神 纳音
--------------------------------------------------------
年柱 庚 午 丁(伤)己(印) 伤官 路旁土
月柱 甲 申 庚(比)壬(食)戊(财) 偏财 剑锋金
日柱 辛 酉 辛(比) 日主 石榴木
时柱 癸 酉 辛(比) 比肩 石榴木
日主：辛（金）
五行：金4 木1 水0 火1 土1
旺衰：身旺
命令行使用
# 起卦
python scripts/core.py -m coin -q "事业发展" -s "123"
# 解读
python scripts/interpret.py -g 000000 -q "事业" -c 3
# 八字排盘
python scripts/bazi.py --year 1990 --month 8 --day 15 --hour 10
# 运行测试
python -m unittest discover -s tests -v
禁忌事项
根据 SOUL.md，以下事项不予占问：
- 生死寿夭
- 替人决断婚姻（仅示势）
- 国运预测
- 短期内同一事反复起卦
- 涉及重疾、法律纠纷（须劝其寻求专业帮助）
项目结构
cyber_iching_mastar/
├── SKILL.md # 本文件
├── SOUL.md # 人格灵魂定义
├── skill.json # Skill 配置
├── requirements.txt # 依赖
├── README.md # 说明文档
├── scripts/
│ ├── __init__.py # 模块入口
│ ├── core.py # 起卦引擎
│ ├── bazi.py # 八字排盘
│ ├── interpret.py # 义理生成器（象→数→理）
│ └── data/
│ └── hexagrams.json # 六十四卦数据库
└── tests/
└── test_master.py # 测试套件（36个测试）
API 参考
CyberIChingMaster
| 方法 | 描述 | 参数 |
|---|
coin(question, seed) | 金钱卦起卦 | question: 问题, seed: 随机种子 |
milfoil(question, seed) | 蓍草法起卦 | question: 问题, seed: 随机种子 |
number(nums, question) | 数字卦起卦 | nums: [3个数字], question: 问题 |
render(hexagram) | 渲染卦象输出 | hexagram: 卦象对象 |
get_hexagram_info(code) | 获取卦象详情 | code: 二进制卦码 |
get_changed_hexagram(hexagram) | 获取变卦 | hexagram: 原始卦象 |
InterpretationEngine
| 方法 | 描述 |
|---|
generate_full_interpretation(code, question, changing) | 完整三层解读 |
interpret_xiang(code) | 象层解读 |
interpret_shu(code, changing, bazi) | 数层解读 |
interpret_li(code, question, changing) | 理层解读 |
interpret_yao_detail(code, changing) | 爻辞详解 |
quick_read(code) | 快速读卦 |
BaZiMaster
| 方法 | 描述 |
|---|
parse_birth(year, month, day, hour) | 完整八字排盘 |
get_gan_zhi_year(year) | 计算年柱 |
get_gan_zhi_month(year, month, day) | 计算月柱 |
get_gan_zhi_day(year, month, day) | 计算日柱 |
get_gan_zhi_hour(day_gan, hour) | 计算时柱 |
get_shi_shen(day_gan, other_gan) | 计算十神 |
render(result) | 渲染八字输出 |
License
MIT License
