算法与校验
透明、可核查的装卦引擎
版本
| 装卦引擎 | 自研 v1.4.1 |
| 构建日期 | 2026-06-22 |
| 历法库 | lunar-javascript 1.7.7（精确节气 / 23:00 子初换日 / 立春换年） |
| 规则模板 | 古筮真诠模板 v1.0、增删卜易模板 v1.0 |
| 卦辞文本 | 公版《周易》（中文维基文库底本，通行本校订） |
回归校验
用《增删卜易》《古筮真诠》古籍中逐字印出的卦例做回归比对，覆盖纳甲、六亲、世应、变卦、旬空、六神等字段。
| 语料 | 卦例数 | 说明 |
|---|---|---|
| 古筮真诠 .doc 干净提取 | 792 | 纳甲 / 六亲 / 世应 匹配率 100%；六神 99.9%、旬空 99.7%（个别为书印讹误） |
| 含进阶篇 PDF 提取合计 | 909 | 进阶篇为 PDF 提取，质量略低，差异多源于提取而非引擎 |
| 单元 + 边界测试 | 86 项 | 4096 本变组合、60 甲子旬空、节气交接、子时换日、化象从卦理、蓍草概率等 |
已知流派差异（默认采用古筮真诠模板）
六爻许多判定本有流派之别，目前两套模板的实际算法差异只在神煞范围（古筮 13 类 / 增删 4 类）；暗动/日破、三合成立条件、三刑等其余判定暂统一，后续将按古籍逐步细分（届时更新模板版本号）。真空/假空已按《增删卜易·旬空章》区分（旺/动/受日月生扶者为假空·出空填实即应，静弱无助者为真空）。旺衰评分仅为信息整理之辅助，非统一公式。
已知局限
内置历法仅为离线回退方案（在线正常走 lunar-javascript 精确历）。「设备时区」基准在夏令时切换当日凌晨的不存在钟点可能偏 1 小时；默认「北京时间」无夏令时，不受影响。
更新日志
- v2.1.0（2026-07-10）：新增 4 功能——首页今日一卦（每日回访）；我的卦例应验率按占类拆分＋超 7 天未回填结果的「待复盘」角标提醒；实战演练卦例全文搜索（问事/断语/卦名/占类）；演练卡可写下自己的断语、揭晓时与古断并排对照。
- v2.0.1（2026-07-10）：多智能体审查后修复——完整推演正确性：古断用神为子孙/兄弟时，③④用神旺衰改为直接锚定该用神（不再套占类默认误取世爻），⑤吉凶若用神与古断不符则加醒目告示，免责声明据实修正；修复导入卦例的存储型 XSS（id 转义＋白名单校验）；旬空改由日干支精算（修数据错例）；移动端顶部按钮换行修复；错题本清空后「下一卦」不再卡死、跳过评分不计入「已练」、②③自评加回显；补占类关键词与增删用神抽取。
- v2.0.0（2026-07-09）：实战演练三卷齐备——总论篇 / 易理篇 / 增删卜易三个分卷 tab（共约 985 例真实古卦例），增删卜易由 PDF 全文提取；新增完整推演流程（装卦→定用神[锚定古断]→用神旺衰/原神忌神→综合吉凶→应期，全部由引擎按规则确定性推演，并声明「凡与古人原断有出入以古断为准」）；卦例经多轮自动＋多智能体逐卷核对清理（问事↔卦盘干支/卦名硬校验、断语去页脚串与编者注污染、卷内去重、占类去卦名干扰重判）。
- v1.6.0（2026-07-09）：实战演练新增总论篇卦例并按卷分 tab（总论篇 285 例 / 易理篇 331 例，可分卷选练）；卦例改由 .doc 全文文本解析、并加「问事干支须与卦盘一致」硬校验以杜绝问事错配；首页添名言「君子以自昭明德」（晋卦象传）。
- v1.5.1（2026-07-09）：实战演练增强——揭晓页把「作者精解」详解默认展开、置于台前（就算基础不牢也能顺着读懂）；解释与原断中的六爻术语自动挂接六爻百科（点即查定义），并列出「本卦重点概念」标注古籍出处章节（如 月破·总论第14章）。
- v1.5.0（2026-07-09）：新增实战演练——从《古筮真诠》易理篇提取 338 个真实古卦例（问事＋古人原断＋作者解析），卦盘由「卦名＋变卦＋干支」经本站引擎重新装盘（六亲/纳甲/世应与古籍原文逐爻校验一致），支持「先自断用神/旺衰/吉凶、再对照古断」的练习流程，含占类筛选、连对统计、错题本与收藏；数据懒加载不拖累首屏。同步修正页脚/SW 版本号（此前滞留 1.3）。
- v1.4.1（2026-06-21）：五代理审计与加固——安全方面卦例导入与展示全程 HTML 转义并做结构校验（防注入与坏数据撑爆界面）、报数起卦改为正整数校验（不再因负数/小数静默出错卦）；断法校正「化绝从于卦理」（让位于回头生克）、「三合局须有成员爻发动方成局」（不再把纯静凑齐误判为成局）；无障碍补全弹窗键盘焦点管理与对比度修正（axe 全页面零违规）；中文字体改异步加载、Service Worker 改 stale-while-revalidate（首屏显著提速）；手机端排盘精简（神煞移入点按详情、首列固定）；六爻百科去除重复分类索引；六十四卦索引新增搜索与「八宫顺序｜周易卦序」排序。装卦核心与神煞经审计仍全部无误。
- v1.4.0（2026-06-20）：新增六爻百科（187 词条、可搜索，整理自《增删卜易》《古筮真诠》，经多代理逐条校验）；新增「卦象吉凶·参断」模块（用神旺衰＋原神/忌神＋空破墓化＋动爻化象，神煞/三刑/六害/卦身不参与定性）；纳入进阶断法（应期进/退神、三合半合待补、独发/尽发、特殊状态）；分类用神模型校正（疾病/官非/出行以世爻为用、官鬼为忌，天时不作吉凶）；摇钱「字/背」改称「阴/阳」（古筮真诠：简素面为阳）；排盘表格重构对齐（世应并入爻象列）。
- v1.3.2（2026-06-19）：真空/假空区分（增删卜易·旬空章，盘面以「空·真/空·假」标注）。
- v1.3.1（2026-06-19）：四代理审计修正——化象「从于卦理」(四土无墓/水化辰论克/寅申论冲不论绝)、蓍草大衍概率校正(老阳:老阴:少阳:少阴=3:1:5:7)、回退历法 23 点换日与闰年节气日修正、报数起卦非数字防御。装卦核心(纳甲/六亲/世应/神煞/飞伏)经审计全部无误。
- v1.3.0：规则体系/盘面详略解耦、时区与经度修正三步逻辑、文案精确化、64卦详情增强、分享链接。
- v1.2.0：神煞、进退神、应期候选、用神旺衰、三合、飞伏、生克关系图。
- v1.1.0：关系层、爻级详情、互错综交、64卦卦辞、卦例管理、PWA。