- name
- yijing-divination
- description
- 易经占卜系统。支持铜钱法、蓍草法起卦，生成本卦、互卦、变卦，提供Oracle Voice诠释。当用户请求占卜、问卦、易经解读、或寻求决策指引时使用。
易经占卦
基于《周易》的占卜系统。提供传统起卦方法和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诠释
结构：
- 卦象展示
- 可视化卦象（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": ["初爻", "二爻", "三爻", "四爻", "五爻", "上爻"]
}
}