Kiến trúc I-Ching Vir, mô hình quẻ và ranh giới các engine thành phần

Abstract

Bài này mô tả kiến trúc I-Ching Vir từ dữ liệu hào tới kết quả có cấu trúc: core, gieo quẻ, biến đổi, trường phái, Liuyao, Yingqi, scoring, NLP/NLG và lưu lịch sử. Mô tả dựa trên source được chụp checksum ngày 23/10/2026; phân biệt điều quan sát được trong code với yêu cầu kiến trúc và giới hạn kiểm chứng. Đây là bản khảo sát triển khai, không phải xác nhận hiệu lực dự đoán.

1 Phạm vi

I-Ching là engine tổng thể. Liuyao và Yingqi là các engine thành phần; NLP/NLG là một nhánh dùng chung, không đại diện toàn hệ thống. Tài liệu này bổ sung góc nhìn còn thiếu ở QP-SYS-001, và đi cùng bài thuật toán gieo quẻ QP-SYS-003. Mã nguồn triển khai là nguồn chính ^[1].

Các kết luận được phân loại: cấu trúc file và lời gọi là phát biểu nguồn; công thức bit là quy ước và suy diễn; kết quả bộ kiểm tra là kết quả tính; ý nghĩa truyền thống là diễn giải. Tính nhất quán phần mềm không đồng nghĩa dự đoán sự kiện đúng.

2 Kiến trúc và luồng dữ liệu

2.1 Các tầng trách nhiệm

Core định nghĩa hào, đơn quái, trùng quái và hào động. Data chứa bảng quái, số Văn Vương, Can Chi, Nạp Giáp và từ liệu. Casting tạo sáu giá trị hào; transform dựng Biến, Hỗ, Thác và Tông. Các trường phái đọc kết quả core để lập dữ kiện riêng. Presentation gom dữ kiện thành response, animation và tài liệu kết quả.

NLP tạo QueryContext từ câu hỏi; scoring đọc QueryContext và DivinationContext; NLG chọn cách diễn đạt theo dữ kiện và điều kiện trả lời. Yingqi nhận trạng thái quẻ cùng ngữ cảnh lịch để tạo và xếp hạng các ứng viên thời gian. Hai nhánh ngôn ngữ và thời gian không thay thế việc gieo sáu hào.

Request → kiểm tra đầu vào → phương thức gieo / hào nhập tay
        → sáu hào → Bản, Biến, Hỗ + dữ kiện trường phái
        → QueryContext + scoring + Yingqi + NLG
        → response / result_document → snapshot / history

Đây là sơ đồ trách nhiệm khái quát. Thứ tự side effect thực tế được nêu riêng ở mục 6, không suy ra từ mũi tên sơ đồ.

2.2 Biên hệ thống và triển khai

Entrypoint server.vri trong cây tác giả dùng InterVir để đăng ký route và middleware. Kiểm tra tiến trình xác định một binary native I-Ching và một gateway Node riêng; cũng tồn tại engine Python riêng. Do đó không gán thuộc tính “thuần Vir” cho mọi dịch vụ, tooling hoặc dữ liệu lịch sử.

Manifest phân biệt deployed-library-tree với author-worktree: thư viện đang đặt trên server có checksum, còn entrypoint chỉ có trong cây tác giả ở lần khảo sát này. Chưa có phép tái build độc lập chứng minh toàn bộ tập source tạo đúng binary đang chạy. Mã SHA-256 binary chỉ nhận diện hiện vật, không tự chứng minh provenance build ^[1].

3 Mô hình hào và quẻ

3.1 Giá trị và chiều hào

Hào được nhập theo thứ tự từ dưới lên: vị trí 1 là hào dưới, vị trí 6 là hào trên. Với giá trị thô trong tập {6, 7, 8, 9}, bit dương bằng phần dư khi chia 2; hào động là 6 hoặc 9. Hai số 7 và 8 là hào tĩnh.

Với $b_i$ là bit hào thứ $i$, quy ước mã hóa là:

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

Ba bit thấp tạo hạ quái, ba bit cao tạo thượng quái. Giá trị bit $B$ thuộc 0..63; số Văn Vương thuộc 1..64 và phải tra bảng. Không được dùng $B+1$ làm số Văn Vương.

3.2 Hào động và phép biến

Gọi $M$ là mặt nạ hào động. Công thức tương đương cho Biến quẻ là $B'=B\oplus M$. Thác quẻ đảo sáu bit: $B_{opp}=B\oplus63$. Tông quẻ đảo thứ tự sáu hào. Hỗ quẻ dùng các hào 2,3,4 cho hạ quái và 3,4,5 cho thượng quái. Các module changed, opposite, inverse, nuclear thể hiện những thao tác này ^[1].

Ví dụ tổng hợp: sáu hào [6,7,8,9,6,9] cho $B=42$, $M=57$, Biến quẻ có bit 19 và Hỗ quẻ có bit 21. Các số này là mã bit, không phải số Văn Vương hay kết quả hỏi của người dùng.

4 Liuyao và Yingqi trong engine tổng thể

4.1 Liuyao là nhánh dữ kiện trường phái

schools/liuyao/resolver.vri dựng dữ kiện Nạp Giáp, cung và vị trí Thế/Ứng trên mô hình quẻ. Các yếu tố Lục Thân, lịch và hào động được dùng ở các bước diễn giải/scoring tiếp theo. Ranh giới cần giữ là: dữ kiện trường phái đọc trạng thái hào; nó không tự chọn lại kết quả gieo.

4.2 Yingqi là nhánh ứng kỳ

Trong cây source khảo sát, Yingqi là mô-đun ứng kỳ của Lục Hào với ruleset zengshan_core_v1, không phải tên gọi cho Cửu Cung Phi Tinh. Pipeline thu thập trigger theo hào, dụng thần và trạng thái lịch; sau đó quy về ứng viên chi, khung thời gian và top-k ^[1].

yingqi_branch_effective_score lấy điểm trigger lớn nhất trong một chi, cộng 3 cho mỗi trigger bổ sung. Với $n>0$ trigger cùng chi:

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

Mặc định top-k là 3 khi đối số không dương. Trong yingqi_confidence_from_score, mức high bắt đầu ở 54 và medium ở 48. Đây là nhãn theo ngưỡng điểm của triển khai; không được đọc thành xác suất sự kiện xảy ra. Việc giải thích ngày/giờ còn phụ thuộc khung thời gian, chi nền và dữ liệu lịch.

5 Scoring và NLP/NLG

Scoring phối hợp yếu tố quẻ, lĩnh vực, hào động, Thế/Ứng, Liuyao, Mai Hoa, thời điểm, quan hệ và Không Vong. Trọng số là chính sách triển khai; không có bằng chứng trong bài này để biến điểm thành xác suất thực nghiệm.

Ở đường tạo response, cr_build_cast_response_json_with_qc gọi scoring, tạo timing bằng Yingqi, rồi gọi ma trận NLG. Eligibility quyết định trả lời trực tiếp hay dùng nhánh thiếu ngữ cảnh. Chi tiết vector 64 chiều, mẫu câu và kết quả đánh giá ngôn ngữ thuộc QP-SYS-001 ^[2]. CSPRNG không dùng vector NLP làm nguồn entropy; cơ chế gieo được mô tả riêng trong QP-SYS-003.

6 Controller, lưu trữ và điều kiện lỗi

castHandler phân biệt coins, yarrow, meihua và manual; các alias được chuẩn hóa theo code. handleDivinationFlow dựng quẻ, thử ghi database khi store sẵn sàng, ghi chỉ mục lịch sử, giải QueryContext, tạo response, gọi lưu snapshot rồi trả 200.

Do đó không coi toàn bộ thao tác database, index và snapshot là một transaction nguyên tử. dbSaved phản ánh đường ghi database, không phải bằng chứng rằng mọi side effect đều đã thành công. Không suy luận quyền truy cập lịch sử từ việc có reading ID; việc kiểm tra quyền cần khảo sát bảo mật riêng.

Trong nhánh đồng xu/cỏ thi, sáu hào được tạo trước khi gọi flow xử lý/lưu kết quả. Lỗi entropy được bắt và chuyển thành HTTP 500. Điều này mô tả ranh giới code; không phải kết quả fault-injection production mới của bài này ^[1].

7 Kiểm chứng và giới hạn

Phụ lục có 3 vector tổng hợp và chương trình duyệt 4096 cặp $(B,M)$, kiểm tra Biến quẻ trở lại trạng thái đầu khi áp dụng cùng mặt nạ hai lần; 64 mã quẻ được kiểm tra phép Thác và Tông lặp hai lần. Đây là kiểm chứng đại số độc lập, không chạy binary production ^[3].

Lần thử biên dịch native test CSPRNG bằng virc 2026.2.20 trong workspace không qua semantic analysis; không đưa kết quả này thành “test native đạt”. Bộ đại số không kiểm tra transport, quyền truy cập, lịch thiên văn hay độ hiệu nghiệm truyền thống. Tài liệu kiến trúc cũ có mô tả Xorshift và runtime không còn đủ để đại diện đường gieo hiện tại; bài này ưu tiên source checksum đã khảo sát.

8 Kết luận

I-Ching Vir gồm core và các nhánh casting, biến đổi, trường phái, Liuyao, Yingqi, scoring, NLP/NLG, response và lưu trữ. Công bố kiến trúc cần giữ các ranh giới này, nêu rõ thứ tự side effect và phân biệt nguồn đã đọc với binary đã chạy. Hai bài QP-SYS-002 và QP-SYS-003 bổ sung phần hệ thống và gieo quẻ cho bài ngôn ngữ QP-SYS-001.

Bibliography

• ^[1] Manifest source khảo sát và checksum, 23/10/2026.
• ^[3] Chương trình, vector tổng hợp và biên bản kiểm chứng kèm bài.
• ^[2] QP-SYS-001, NLP/NLG của I-Ching Vir.