核心用法
周易本经占筮技能是一套完整的数字占卜系统,核心能力围绕三大模块展开:
1. 起卦系统
支持传统"三钱法"(铜钱摇卦)与"蓍草法"两种经典起卦方式,通过概率模拟还原古代占卜仪轨。三钱法以6/7/8/9四象概率为1/8、3/8、3/8、1/8模拟铜钱正反面组合;蓍草法则遵循《周易·系辞》记载的"大衍之数",概率分布为1/16、5/16、7/16、3/16。系统支持种子复现,便于验证与研习。
2. 查卦与检索
提供六十四卦完整本经数据库,支持按卦名(如"乾""屯")、卦序编号或关键词(如"利涉大川""十年乃字")检索卦辞、爻辞、用九、用六原文。
3. 取辞解读规则
严格遵循《周易》七种变爻取辞古法:六爻不变用本卦卦辞;一爻变用动爻爻辞;二爻变以上爻为主;三爻变兼用本卦与变卦卦辞;四爻变以下静爻为主;五爻变用变卦唯一静爻;六爻皆变则乾用用九、坤用用六、其余用变卦卦辞。输出时先明规则、再引原文、后附白话,不妄断吉凶。
显著优点
考据严谨,去芜存菁。开发者系统拆解市面几乎所有同类占卜程序,剔除卦序错误、原文截断、白话混原文、未校验命理乱炖等通病,以学术态度还原《周易》本经原貌。
零依赖纯本地。无任何npm包依赖,全部功能基于Node.js内置模块与浏览器原生API实现,供应链攻击面为零。所有计算本地完成,无网络请求,隐私完全自主可控。
交互体验成熟。整合百家之长,采用术数百科式总览结构,支持CLI与网页双端操作,近占记录本地留存,兼顾传统仪式感与现代便捷性。
边界清晰自律。明确声明不冒充高精度命理体系(如八字、奇门、紫微、六爻纳甲),专注周易本经,避免伪精确排盘误导用户。
潜在局限
功能边界有限。严格限定于周易本经范畴,不提供八字、风水、择日等扩展术数服务,多元需求用户需配合其他工具。
随机数非真随机。虽使用crypto.randomInt保障密码学安全级随机,但本质为伪随机算法模拟,与物理铜钱、真实蓍草存在仪式感差异,传统派或觉"机心"过重。
白话解释主观性。原文引用后的白话解读虽力求平实,仍不可避免带有阐释者视角,建议用户以原文为准、白话为辅。
无云端同步。纯本地存储意味着换设备即失记录,无账号体系,重度用户需自行备份。
适合人群
- 易学入门者:希望从原著文本入手,建立对《周易》的扎实认知,避免被市面混乱资料误导。
- 传统文化爱好者:重视仪式感与文本纯正性,愿意以数字方式延续传统占筮体验。
- 隐私敏感用户:拒绝云端占卜APP的数据收集,要求完全本地可控的工具。
- 研究者与写作者:需要快速检索卦爻辞原文、核对取辞规则、复现特定卦象的学术用途。
- 开发学习者:零依赖架构、清晰代码结构可作为Node.js/前端项目的参考案例。
使用风险
常规技术风险:作为MIT-0开源项目,无商业维护承诺,长期更新依赖社区;localStorage存储有容量限制(通常5-10MB),记录过多需手动清理;浏览器隐私模式下数据无法持久化。
认知风险:占卜结果具有高度开放性解释空间,系统已明确避免"确定命令"式输出,但用户仍可能过度依赖或误读象征意义,需保持理性态度。
环境依赖:需Node.js 18+环境支持crypto.randomInt以获得最佳随机数质量,旧版本降级至Math.random虽不影响功能,但随机性理论强度略降。