核心用法
yijing-divination 是一套基于《周易》的数字化占卜系统，提供两种传统起卦方式：铜钱法（三枚铜钱模拟）与蓍草法（大衍之数），支持通过 --seed 参数实现可复现的随机结果。系统生成结构化的卦象数据，包括本卦（主卦）、互卦（隐藏卦象）、变卦（之卦，当有动爻时），并以 JSON 格式输出六爻数组、变爻位置及可视化卦象。
核心交互依赖 Oracle Voice 模式——以卦的第一人称诗性语言进行诠释，强调"镜映"而非"解答"，通过意象、悖论与张力引导用户自我反思。完整流程涵盖起卦执行、结果解析、卦辞数据库读取（hexagrams_full.json）及分层诠释生成：卦象展示 → Oracle Voice → 动爻解读 → 互卦提示 → 诗性结语。
显著优点
- 方法论正统性：严格遵循《周易》传统起卦程序，铜钱法与蓍草法均有经典依据，满足文化仪式感需求
- 诠释哲学独特：拒绝直接建议的"算命"模式，以"我是..."的拟人化声音构建对话空间，尊重用户主体性
- 技术实现清晰：Python 脚本化执行，JSON 数据结构化，便于扩展与二次开发
- 多层卦象分析：整合本卦、互卦、变卦三层信息，提供相对立体的情境映照
潜在缺点与局限性
- 数据库严重残缺：当前仅含10卦（1-8、63-64），覆盖度不足16%，多数查询将返回缺失提示
- 诠释深度依赖预设：Oracle Voice 质量受限于
hexagrams_full.json中硬编码的oracle_voice字段，缺乏动态生成能力 - 无历史记录机制：每次起卦独立执行，不支持卦象存档、对比或长期趋势追踪
- 随机性存疑：
--seed参数虽保证可复现，但物理随机源的模拟真实性未经验证 - 动爻规则简化：变爻数量判断逻辑（无变/1变/2变/3变/4变以上）为简化版，与传统易学存在差异
适合人群
- 对《周易》文化有基础认知、寻求决策"映照"而非"指令"的理性用户
- 需要仪式感辅助思考的个人决策者（职业选择、人际关系等模糊情境）
- 传统文化数字化体验爱好者
- 不适合：寻求确定性预测、心理咨询替代、或缺乏易学基础易过度解读的用户
常规风险
- 过度依赖风险：诗性语言可能被误读为具体预言，用户需明确"镜子"定位
- 数据缺失导致的体验断裂：高概率遇到未收录卦象，破坏沉浸感
- 诠释主观性：同一卦象的 Oracle Voice 为固定文本，难以适配问题语境的细微差异
- 文化误用：传统占卜与现代AI结合可能被质疑为"伪国学"或商业噱头