I-Ching Vir 架構、卦象模型與元件引擎邊界

Abstract

本文說明 I-Ching Vir 從爻值到結構化結果的系統架構：核心、起卦、卦變、流派、六爻、應期、評分、NLP/NLG 與歷史儲存。依據 2026 年 10 月 23 日的原始碼雜湊清單，區分程式實作陳述、編碼約定與計算驗證。本文為實作調查，不構成預測效力的證明。

1 範圍 (Scope)

I-Ching 是整體引擎；Liuyao（六爻）與 Yingqi（應期）為元件引擎。共用的 NLP/NLG 僅是其中一個分支。本文補充 QP-SYS-001，並與起卦演算法 QP-SYS-003相互參照。受檢原始碼為主要證據 ^[1]。

檔案結構與函式呼叫屬來源陳述；位元公式屬約定與推導；驗證器輸出屬計算結果；傳統意義屬詮釋。軟體內部一致性不等於能正確預測事件。

2 架構與資料流程

2.1 各層責任

Core 定義爻、八卦、重卦與動爻。Data 提供文王卦序、干支、納甲及文本查表資料。Casting 產生六個原始爻值；transform 產生變卦、互卦、錯卦與綜卦。流派模組讀取核心狀態以建立各自的資料。Presentation 將其組合為回應、動畫與結果文件。

NLP 建立 QueryContext；scoring 結合 QueryContext 與 DivinationContext；NLG 依證據及回答資格生成文字。應期模組利用卦象與曆法情境產生並排序時間候選。語言處理與應期計算均不取代六爻起卦。

請求 → 輸入檢查 → 起卦方法／手動爻值
     → 六爻 → 本卦、變卦、互卦與流派資料
     → QueryContext + scoring + Yingqi + NLG
     → response / result_document → snapshot / history

此圖為責任概觀；實際副作用順序見第 6 節，不能由箭頭推定。

2.2 部署邊界

作者工作樹的 server.vri 使用 InterVir 路由與中介層。程序檢查辨識到原生 I-Ching 執行檔、獨立 Node gateway，以及另一個 Python 引擎。因此不能將「Vir 實作」擴張為全部服務、工具與歷史資料都只使用 Vir。

清單區分部署函式庫樹與作者工作樹。部署函式庫附有原始碼雜湊；入口檔在此次檢查僅見於作者工作樹。尚未獨立重建，以證明完整原始碼集合對應正在執行的二進位檔。二進位雜湊只能辨識產物，不能自行證明建置來源 ^[1]。

3 爻與卦的模型

3.1 爻值與方向

爻序由下而上：位置 1 為初爻，位置 6 為上爻。原始值為 {6,7,8,9}；除以 2 的餘數為陽爻位元。6 與 9 為動爻，7 與 8 為靜爻。編碼約定為：

$$B=\sum_{i=1}^{6}b_i2^{i-1}. \tag{1}$$

低三位元構成下卦，高三位元構成上卦。位元碼 B 在 0..63；文王卦序在 1..64，須透過查表取得，不得以 B+1 代替。

3.2 卦變

動爻遮罩為 M 時，變卦等價於 $B'=B\oplus M$；錯卦為 $B_{opp}=B\oplus63$。綜卦反轉六爻順序；互卦下卦取 2、3、4 爻，上卦取 3、4、5 爻。changed、opposite、inverse、nuclear 分別實作這些運算 ^[1]。

合成例 [6,7,8,9,6,9] 的 B=42、M=57、變卦位元碼為 19、互卦位元碼為 21。這些數字不是文王卦序，也不是使用者的私人占問紀錄。

4 六爻與應期元件

4.1 六爻流派資料

schools/liuyao/resolver.vri 依卦象建立納甲、卦宮與世應位置。六親、曆法及動爻資料用於後續解釋與評分。流派推導讀取既有起卦結果，不重新選取卦象。

4.2 應期

受檢 Yingqi 程式使用 zengshan_core_v1 六爻應期規則集，不是九宮飛星模組。流程依爻、用神與曆法條件收集 trigger，再轉成地支候選、時間範圍及 top-k 結果 ^[1]。

同一地支有 n>0 個 trigger 時，yingqi_branch_effective_score 取最高 trigger 分數，每多一個 trigger 加 3 分：

$$s_{branch}=\max_j(s_j)+3(n-1). \tag{2}$$

top-k 不為正時預設為 3。yingqi_confidence_from_score 將至少 54 分標為 high、至少 48 分標為 medium。這是程式門檻標籤，不是事件發生機率。日期換算另依時間範圍與基準地支約定。

5 評分與 NLP/NLG

評分結合卦象、領域、動爻、世應、六爻、梅花、時間、關係與空亡因素。權重為實作政策；本文沒有將分數校準為事件機率的實證。

cr_build_cast_response_json_with_qc 評估分數、建立應期 timing，再呼叫 NLG 回應矩陣。Eligibility 決定直接回答或情境不足的回應。64 維向量、原型及語言評估詳見 QP-SYS-001 ^[2]。NLP 向量不是起卦熵源；起卦邊界另見 QP-SYS-003。

6 控制器、儲存與失敗處理

castHandler 區分 coins、yarrow、meihua 與 manual。handleDivinationFlow 建立卦象，在 store 可用時嘗試寫資料庫，追加歷史索引，取得 QueryContext，生成回應，呼叫 snapshot 儲存，再回傳 HTTP 200。

這不表示資料庫、索引及 snapshot 構成單一原子交易。dbSaved 只涉及資料庫路徑，不能證明所有副作用成功。僅有 reading ID 也不能證明具有歷史存取權；授權需要另行審查。

錢幣與蓍草路徑在進入處理與儲存流程前先生成六爻。熵源例外被捕捉並轉為 HTTP 500。此處為原始碼觀察，不是本次新增的 production 故障注入結果 ^[1]。

7 驗證與限制

附錄含 3 個合成向量，並窮舉 4096 個 (B,M) 組合，檢查同一動爻遮罩作用兩次可還原。另對 64 個位元卦態檢查錯卦與綜卦的二次還原。這是獨立代數驗證，不是執行 production 二進位檔 ^[3]。

以工作區 virc 2026.2.20 嘗試編譯原生 CSPRNG 測試時，語意分析失敗；本文不將其宣稱為通過測試。代數檢查不涵蓋 HTTP、授權、天文曆法或傳統效力。舊架構筆記中的 Xorshift 與 runtime 描述不能代表此次受檢起卦路徑。

8 結論 (Conclusion)

I-Ching Vir 包含核心、起卦、卦變、流派、六爻、應期、評分、NLP/NLG、回應及持久化。架構文件須保留這些邊界、揭露副作用順序，並區分已檢查原始碼與已執行二進位檔。QP-SYS-002 與 QP-SYS-003 補足 QP-SYS-001 的系統及起卦範圍。

Bibliography

• ^[1] 2026 年 10 月 23 日原始碼清單與雜湊。
• ^[3] 隨文提供的合成向量、驗證器及驗證紀錄。
• ^[2] QP-SYS-001，I-Ching Vir 的 NLP/NLG。