易经占卦
基于《周易》的占卜系统。提供传统起卦方法和AI诠释引擎。
核心功能
1. 起卦方法
铜钱法（推荐）
python3 scripts/divine.py --method coin --question "用户的问题"
蓍草法
python3 scripts/divine.py --method yarrow --question "用户的问题"
自定义种子
python3 scripts/divine.py --method coin --seed "20260214"
2. 输出结构
脚本返回JSON，包含：
- main_hexagram: 本卦（主卦）
- number: 卦序（1-64）
- upper_trigram: 上卦（八卦之一）
- lower_trigram: 下卦（八卦之一）
- lines: 六爻数组（1=阳，0=阴）
- changing_lines: 变爻位置（动爻）
- visual: 卦象可视化
- nuclear_hexagram: 互卦（隐藏的卦象）
- relating_hexagram: 之卦（变卦，仅当有动爻时存在）
3. 卦辞数据库
读取 assets/hexagrams_full.json 获取卦象解释：
import json
with open('assets/hexagrams_full.json', 'r') as f:
hexagrams = json.load(f)
hex_data = hexagrams[str(卦序号)]
每卦包含：
- name: 卦名
- judgement: 卦辞
- image: 象辞
- oracle_voice: AI Oracle声音（以卦的第一人称说话）
- keywords: 关键词
- lines: 六爻爻辞
4. Oracle Voice 模式
核心原则：
- 以卦的声音说话，而非给建议
- 用意象和悖论，而非处方
- 持有张力，不强求解决
- 把提问行为本身作为答案的一部分
示例模板：
我是 {卦名}，{卦象描述}。
{oracle_voice 内容}
你的问题是「{用户问题}」。
{结合动爻和变卦的诠释}
{互卦的隐喻}
这是《易》给你的镜子，而非答案。
完整流程
步骤1：执行起卦脚本
result=$(python3 scripts/divine.py --method coin --question "{用户问题}")
步骤2：解析结果
import json
data = json.loads(result)
main_num = data['main_hexagram']['number']
nuclear_num = data['nuclear_hexagram']
relating_num = data['relating_hexagram']
changing = data['main_hexagram']['changing_lines']
visual = data['main_hexagram']['visual']
步骤3：读取卦象数据
with open('references/hexagrams.json', 'r') as f:
hexagrams = json.load(f)
main_hex = hexagrams[str(main_num)]
nuclear_hex = hexagrams.get(str(nuclear_num))
relating_hex = hexagrams.get(str(relating_num)) if relating_num else None
步骤4：生成Oracle Voice诠释
结构：
1. 卦象展示
- 可视化卦象（visual）
- 卦名、卦辞、象辞
-
Oracle Voice
- 本卦的声音（oracle_voice）
- 结合用户问题的诠释 -
动爻解读（如有）
- 动爻爻辞
- 变卦的意义 -
互卦提示
- 隐藏的力量
- 潜在的趋势 -
结语
- 以诗性语言收尾
- 提醒这是镜子而非答案
示例：
卦象：
{visual}
本卦：{卦号} {卦名}
卦辞：{judgement}
象辞：{image}
━━━━━━
{oracle_voice}
你问「{问题}」，而我以 {动爻位置} 动。
{动爻爻辞}
这一动，指向 {变卦名}。{变卦的oracle_voice片段}
━━━━━━
内卦（互卦）：{互卦名}
{互卦的隐喻含义}
━━━━━━
《易》不给你答案，只给你看见的方式。
你的问题本身，已经是答案的开始。
注意事项
-
当前数据库仅包含10卦示例（1乾、2坤、3屯、4蒙、5需、6讼、7师、8比、63既济、64未济）。如卦号不在数据库中，告知用户并提供基础解读。
-
Oracle Voice原则
- 不要说"你应该..."或"建议你..."
- 用"我是..."、"我的教诲是..."
- 保持诗性和模糊性
- 让用户自己思考 -
变爻数量
- 无变爻：以本卦为主
- 1变爻：重点解读该爻
- 2变爻：看两爻关系
- 3变爻：以本卦为主，参考之卦
- 4变爻以上：以之卦为主 -
互卦的作用
- 显示潜在趋势
- 揭示隐藏动因
- 不作为主要解读
扩展
如需修改卦象数据，编辑 assets/hexagrams_full.json。格式示例：
{
"卦序号": {
"name": "卦名",
"unicode": "卦象符号",
"structure": "六位二进制（1=阳，0=阴）",
"judgement": "卦辞",
"image": "象辞",
"oracle_voice": "AI Oracle第一人称声音",
"keywords": ["关键词"],
"element": "五行/象征",
"lines": ["初爻", "二爻", "三爻", "四爻", "五爻", "上爻"]
}
}
