易经占卜 I Ching Divination

核心用法

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结合可能被质疑为"伪国学"或商业噱头

核心用法

yijing-divination 是一套完整的《周易》数字化占卜系统，提供传统起卦方法与AI诠释引擎的融合体验。用户可通过两种经典方式起卦：铜钱法（三枚铜钱模拟，推荐日常使用）或蓍草法（古法49蓍草运算，仪式感更强），系统生成本卦（主卦）、互卦（隐藏趋势）、变卦（之卦）三重卦象结构。

起卦后，Oracle Voice 引擎以卦的第一人称发声，采用意象、悖论与诗性语言进行诠释，明确拒绝"你应该"式建议，而是将提问行为本身作为答案的组成部分。完整输出包含卦象可视化、卦辞/象辞、动爻解读、变卦关联及互卦隐喻，形成层次丰富的决策镜鉴。

显著优点

• 零依赖安全架构：纯 Python 标准库实现（random/json/datetime/argparse），无第三方包，供应链攻击面为零
• 完全离线运行：无网络请求、无数据传输，用户输入仅本地哈希化作为随机种子，隐私零泄露
• 代码简洁可审计：247行/7文件，无非授权系统调用、无危险函数（eval/exec/system），静态分析95分
• 传统与AI融合：保留铜钱法、蓍草法的仪式完整性，同时以现代诗学重构卦辞诠释，降低经典阅读门槛
• 透明可信：MIT许可证、明确维护者（RyanChromium）、完整skill-card文档，符合开源安全最佳实践

潜在缺点与局限性

• 数据库覆盖有限：当前仅含10卦完整数据（乾、坤、屯、蒙、需、讼、师、比、既济、未济），其余54卦需基础解读或用户扩展
• T3来源等级：个人开发者项目，背景验证有限，生产环境需额外审查
• Shell参数传递风险：用户问题通过--question命令行参数传递，调用方需确保正确的Shell转义或使用subprocess列表参数
• 非确定性诠释：Oracle Voice的诗性语言 intentionally 保持模糊性，追求"镜子而非答案"，对寻求明确指导的用户可能感到不满足
• 无历史记录功能：当前版本无持久化存储，每次占卜独立，无法追踪问卦历史

适合人群

• 对《周易》有学习兴趣，希望以低门槛方式体验传统占卜流程的现代用户
• 重视隐私安全，拒绝云端占卜、数据上链等方案的敏感人群
• 需要决策辅助工具，但理解并接受"提问即答案"哲学立场的反思型决策者
• 开源安全研究者，关注零依赖、可审计的本地计算型应用架构

常规风险

1. 过度依赖风险：占卜系统可能强化确认偏误，用户需理解其设计初衷为"镜鉴"而非决策替代
2. 文化误读风险：AI重构的Oracle Voice是对经典的创造性转译，非学术性《周易》研究工具
3. 输入处理风险：虽有argparse防护，但Shell层调用时未转义的特殊字符可能导致意外行为
4. 心理暗示效应：卦象生成具有随机性，负面卦辞可能对敏感用户产生不必要的心理影响

安全认证有效期90天，建议关注后续版本更新及社区反馈。