Skill: agent4quant/cyber-iching-master (version 1.0.0)

# Cyber I Ching Master - OpenClaw Skill ## 概述 **Cyber I Ching Master**（赛博易经大师）是一个融合三千年周易智慧的数字占卜系统。它不仅是简单的算命工具，而是帮助用户通过卦象观照自身、理解事物发展趋势的智慧向导。 ## 核心哲学 > **易者不占**：真正精通易理之人，遇事观其势即可决断。起卦是为问事者明心，非为占卜未来。 > **吉凶在人**：卦象示势，人事定吉凶。同一卦，君子得之则吉，小人得之则凶。 > **变易为常**：无不变之卦，无不变之事。老阴老阳之变，正是天道好生之机。 ## 核心功能 ### 1. 起卦方式 #### 大衍之数（蓍草法） 传统最正统的起卦方法，通过50根蓍草经过18次演变为六爻。 ```python from scripts import CyberIChingMaster master = CyberIChingMaster("scripts/data/hexagrams.json") result = master.milfoil(question="事业发展如何？") print(master.render(result)) ``` #### 金钱卦 用三枚铜钱抛掷六次，简单易行。 ```python result = master.coin(question="婚姻如何？", seed="123") print(master.render(result)) ``` #### 数字卦 随意报三个数字起卦，随缘自在。 ```python result = master.number([37, 58, 16], question="财运如何？") print(master.render(result)) ``` ### 2. 义理生成器（象→数→理三层解读） ```python 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. 八字排盘 ```python 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 旺衰：身旺 ``` ## 命令行使用 ```bash # 起卦 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


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)