Tóm tắt (Abstract)
Background / Context: Mệnh lý học Tử Bình Bát Tự (四柱八字) là một hệ thống tính toán cấu trúc thời gian truyền thống Đông Á, đòi hỏi sự tích hợp chính xác giữa các quy tắc can chi cổ điển và cơ học thiên văn thực nghiệm. Trong thực tiễn triển khai phần mềm, các công cụ lập lá số thường mắc phải những sai số nghiêm trọng do quy ước sai mốc chuyển năm (nhầm lẫn giữa Tết Nguyên Đán và Tiết Lập Xuân), bỏ qua hiệu ứng kinh độ trong Giờ Thái Dương Thực (True Solar Time), và thiếu kiểm chứng thuật toán đối với ma trận Thập Thần cũng như tuổi khởi Đại Vận.
Methodology: Công trình này công bố đặc tả kiến trúc kỹ thuật toàn diện của BaZi Engine (@quizzman/qm-bazi phiên bản 3.0.0). Hệ thống vận hành trực tiếp trên nền tảng lịch pháp và thiên văn độc lập của Quizzman, bao gồm: xác định Trụ Năm bằng kinh độ hoàng đạo Mặt Trời theo lý thuyết hành tinh VSOP87 [1]; phân định Trụ Tháng theo 12 Tiết khí chính (Minor Solar Term); quy đổi Trụ Ngày dựa trên số ngày Julius liên tục (Julian Day Number) theo ISO 8601 [2]; và hiệu chỉnh Trụ Giờ thông qua Giờ Thái Dương Thực kết hợp Phương trình Thời gian (Equation of Time) theo Jean Meeus [3]. Đồng thời, công trình chuẩn hóa ma trận 100 trạng thái Thập Thần, phân bổ trọng số phần trăm Tàng Can trong 12 Địa Chi, thuật toán 12 giai đoạn Trường Sinh, và hệ thống 26 Thần Sát kinh điển.
Results: Báo cáo kiểm định và hồ sơ audit thuật toán đã phân tích, đối chiếu và khắc phục triệt để 6 điểm sai lệch và vùng mơ hồ trọng yếu trong mã nguồn, bao gồm: hiện tượng đảo ngược phân cực giữa Thực Thần và Thương Quan trong cấu trúc nội bộ, lỗi tra cứu cặp quan hệ Địa Chi do sắp xếp từ điển chuỗi, lỗi cộng dồn kinh độ hai lần trong tính giờ thực, và sai số tính tuổi khởi vận do đếm nhầm Trung khí. Hệ thống đã vượt qua 100% (128/128) ca kiểm thử hồi quy nội bộ và các véc-tơ kiểm chuẩn biên được công bố trong bộ dữ liệu BAZI-BENCH-QP-BAZI-001.
Conclusion: BaZi Engine thiết lập một khung tham chiếu thuật toán minh bạch, xác định rõ ranh giới giữa quy chuẩn thiên văn khả chứng và các quy tắc mệnh lý học truyền thống, loại trừ hoàn toàn các tuyên bố phi thực nghiệm và đóng vai trò nguồn chân lý thực thi (executable source of truth) cho nghiên cứu mệnh lý học phương Đông.
1 Phạm vi áp dụng (Scope)
Tài liệu này quy chuẩn hóa toàn bộ kiến trúc tính toán, mô hình thuật toán và kết quả audit mã nguồn của hệ thống Tử Bình Bát Tự Quizzman (@quizzman/qm-bazi), bao gồm:
- Chuỗi tính toán 4 trụ Can Chi (Năm, Tháng, Ngày, Giờ) trên nền tảng cơ học thiên văn VSOP87 và Julian Day Number theo tài liệu viện dẫn [4].
- Thuật toán hiệu chỉnh Giờ Thái Dương Thực (True Solar Time) dựa trên kinh độ địa lý và Phương trình Thời gian (Equation of Time).
- Mô hình toán học ma trận 100 tổ hợp Thập Thần và bảng phân bổ trọng số Tàng Can trong 12 Địa Chi theo các văn bản kinh điển [@REF-YUANHAI-1200; @REF-SANMING-1578].
- Quy tắc phân định chiều vận và tính toán tuổi khởi Đại Vận dựa trên khoảng cách ngày tới Tiết lệnh mở đầu tháng (Minor Solar Term).
- Hồ sơ audit kỹ thuật độc lập giải quyết 6 điểm bất cập giữa tài liệu kiến trúc và triển khai thực tế trong mã nguồn theo hồ sơ [5].
- Phân tích các giới hạn tính toán và vùng biên mơ hồ (ranh giới giờ Tý, vượt ranh giới ngày khi hiệu chỉnh TST, mô hình Dụng Thần heuristic).
Tài liệu áp dụng cho các nhà phát triển hệ thống, chuyên gia nghiên cứu lịch pháp và các dịch vụ tính toán niên đại trong hệ sinh thái Quizzman.
2 Tài liệu viện dẫn (Normative references)
Các tài liệu sau đây là cơ sở bắt buộc áp dụng trong toàn bộ hệ thống:
- ISO 8601-1:2019 [2], Date and time — Representations for information interchange — Part 1: Basic rules.
- ISO 2145:1978 [6], Documentation — Numbering of divisions and subdivisions in written documents.
- ISO 690:2021 [7], Information and documentation — Guidelines for bibliographic references and citations to information resources.
- Quizzman Research Team (2026) [4], Kiến trúc hệ thống tính toán lịch pháp âm dương và mô hình quy chiếu thiên văn Quizzman, Quizzman Paper Standard Series.
- Jean Meeus (1998) [3], Astronomical Algorithms, 2nd Edition, Willmann-Bell, Richmond, Virginia.
- P. Bretagnon, G. Francou (1988) [1], Planetary theories in rectangular and spherical variables. VSOP87 solutions, Astronomy and Astrophysics, Vol. 202, pp. 309–315.
- Từ Tử Bình, Đường Khái (1200) [8], Uyên Hải Tử Bình (淵海子平), Bản khắc Nam Tống.
- Vạn Dân Anh (1578) [9], Tam Mệnh Thông Hội (三命通會), Minh triều Văn Uyên các bản.
- Kinh Đồ, Lưu Cơ (1368) [10], Đích Thiên Tủy (滴天髓), Minh triều nguyên thư.
- Thẩm Hiếu Chiêm (1776) [11], Tử Bình Chân Thuyên (子平真詮), Càn Long tứ thập nhất niên bản.
- Dư Xuân Đài (1600) [12], Cùng Thông Bảo Giám (窮通寶鑑), Thanh triều bản.
- Quizzman Engineering Group (2026) [5], Báo cáo Audit & Vá Lỗi Engine Bát Tự (Tứ Trụ) — Dossier AUD-2026-BAZI-01, Quizzman Lab Internal Audit Series.
3 Thuật ngữ và định nghĩa (Terms and definitions)
Trong tiêu chuẩn này, các thuật ngữ sau đây được định nghĩa thống nhất:
3.1 Bát Tự / Tứ Trụ (Four pillars of destiny)
Hệ tọa độ thời gian gồm 8 chữ Can Chi tương ứng với 4 mốc: Năm (Niên trụ), Tháng (Nguyệt trụ), Ngày (Nhật trụ), và Giờ (Thời trụ).
3.2 Nhật Chủ (Day master)
Thiên Can của Trụ Ngày, đóng vai trò là chủ thể tọa độ trung tâm trong toàn bộ cấu trúc phân tích sinh khắc ngũ hành và xác định Thập Thần.
3.3 Tiết Lập Xuân (Start of spring)
Thời điểm thiên văn khi tâm Mặt Trời đạt kinh độ hoàng đạo biểu kiến , là điểm bắt đầu của năm dương lịch tiết khí trong lịch pháp phương Đông.
3.4 Tiết khí Minor và Trung khí Major (Minor and major solar terms)
- Tiết khí Minor (Tiết lệnh): Các thời điểm . Đây là mốc chuyển giao giữa các tháng Bát Tự.
- Trung khí Major: Các thời điểm . Đóng vai trò định vị tháng nhuận âm lịch, nhưng KHÔNG làm thay đổi Trụ Tháng của Bát Tự.
3.5 Tàng Can (Hidden stems)
Tập hợp từ 1 đến 3 Thiên Can ẩn tàng bên trong mỗi Địa Chi, mang các trọng số năng lượng phần trăm xác định ảnh hưởng tới bản mệnh.
3.6 Thập Thần (Ten gods)
Mười trạng thái quan hệ sinh khắc và âm dương giữa Nhật Chủ và các Thiên Can khác trong bản mệnh: Tỷ Kiên, Kiếp Tài, Thực Thần, Thương Quan, Thiên Tài, Chính Tài, Thất Sát, Chính Quan, Thiên Ấn, và Chính Ấn.
3.7 Giờ Thái Dương Thực (True solar time)
Góc giờ thực tế của tâm Mặt Trời tại kinh độ người quan sát, tính bằng giờ trung bình địa phương cộng hiệu số Phương trình Thời gian.
4 Nền tảng thiên văn và chuỗi tính toán Tứ Trụ (Astronomical foundation and four pillars computation)
4.1 Ranh giới Lập Xuân xác định Trụ Năm (Year pillar boundary)
Trong mô hình mệnh lý Tử Bình cổ điển theo [8], ranh giới chuyển giao năm hoàn toàn độc lập với ngày mồng 1 tháng Giêng Âm lịch (Tết Nguyên Đán). Năm Can Chi mới bắt đầu chính xác tại thời điểm Mặt Trời đạt kinh độ hoàng đạo (tiết Lập Xuân).
Quy tắc chuẩn hóa BAZI-R001 quy định:
- Nếu thời điểm sinh của năm Gregory hiện tại, năm Bát Tự tính theo năm Gregory trước đó:
- Nếu , năm Bát Tự tính theo năm Gregory hiện tại:
- Thiên Can và Địa Chi của Trụ Năm được xác định theo chu kỳ 60 Hoa Giáp qua công thức đồng dư mô phỏng:
Điều này đảm bảo rằng người sinh vào tháng 1 hoặc đầu tháng 2 dương lịch (trước thời điểm Lập Xuân) luôn giữ đúng Can Chi của năm trước, bất kể Tết Nguyên Đán đã diễn ra hay chưa.
4.2 Tiết lệnh khí và công thức Ngũ Hổ Độn xác định Trụ Tháng (Month pillar derivation)
Trụ Tháng không được xác định bởi tháng âm lịch dân sự mà phụ thuộc hoàn toàn vào 12 Tiết khí chính (Minor Solar Terms) theo Bảng 1.
| Chi Tháng | Tiết Khí Mở Đầu (Minor Term) | Kinh Độ Hoàng Đạo |
|---|---|---|
| Dần (寅) | Lập Xuân (立春) | |
| Mão (卯) | Kinh Trập (驚蟄) | |
| Thìn (辰) | Thanh Minh (清明) | |
| Tỵ (巳) | Lập Hạ (立夏) | |
| Ngọ (午) | Mang Chủng (芒種) | |
| Mùi (未) | Tiểu Thử (小暑) | |
| Thân (申) | Lập Thu (立秋) | |
| Dậu (酉) | Bạch Lộ (白露) | |
| Tuất (戌) | Hàn Lộ (寒露) | |
| Hợi (亥) | Lập Đông (立冬) | |
| Tý (子) | Đại Tuyết (大雪) | |
| Sửu (丑) | Tiểu Hàn (小寒) |
Thiên Can của Trụ Tháng được suy dẫn nghiêm ngặt qua bài ca Ngũ Hổ Độn (Quy tắc BAZI-R002):
trong đó tương ứng với thứ tự chi tháng bắt đầu từ Dần () đến Sửu ().
4.3 Chu kỳ 60 ngày liên tục xác định Trụ Ngày (Day pillar continuous cycle)
Can Chi của Trụ Ngày được bảo toàn qua chuỗi đếm liên tục của Số ngày Julius (Julian Day Number - JDN). Khác với năm và tháng, chu kỳ 60 ngày không bị đứt đoạn bởi bất kỳ biến động thiên văn hay quy ước lịch pháp nào.
Theo [4], chỉ số ngày JDN tính từ mốc 12:00:00 UTC được quy đổi trực tiếp:
4.4 Hiệu chỉnh Giờ Thái Dương Thực xác định Trụ Giờ (Hour pillar true solar time reduction)
Giờ sinh dân sự theo đồng hồ tiêu chuẩn múi giờ địa phương () phải trải qua bước hiệu chỉnh thành Giờ Thái Dương Thực () trước khi quy đổi sang 12 canh giờ Địa Chi:
trong đó:
- là giá trị Phương trình Thời gian tính theo Jean Meeus [3] bằng phút.
- là kinh độ địa lý của nơi sinh (kinh độ Đông dương).
- là kinh tuyến trung tâm của múi giờ pháp định ( cho Việt Nam UTC+7, cho Trung Quốc UTC+8).
- Hằng số đại diện cho tốc độ quay kinh độ của Trái Đất.
Thiên Can của Trụ Giờ được suy dẫn từ Can ngày qua công thức Ngũ Thử Độn:
5 Mô hình toán học Thập Thần và Tàng Can (Ten gods and hidden stems mathematical formulation)
5.1 Ma trận Thập Thần 100 trạng thái (Ten gods matrix)
Mối quan hệ giữa 10 Thiên Can của Nhật Chủ và 10 Thiên Can mục tiêu tạo thành một ma trận vuông 100 trạng thái cố định (Quy tắc BAZI-R003).
Quy tắc phân định dựa trên quan hệ ngũ hành và âm dương:
- Đồng hành: Cùng âm dương là Tỷ Kiên; khác âm dương là Kiếp Tài.
- Ta sinh: Cùng âm dương là Thực Thần; khác âm dương là Thương Quan.
- Ta khắc: Cùng âm dương là Thiên Tài; khác âm dương là Chính Tài.
- Khắc ta: Cùng âm dương là Thất Sát; khác âm dương là Chính Quan.
- Sinh ta: Cùng âm dương là Thiên Ấn; khác âm dương là Chính Ấn.
Bảng 2 trình bày cấu trúc định danh chuẩn hóa của 10 Thập Thần:
| Mã Thập Thần | Tên Tiếng Việt | Ký Tự Hán | Thuật Ngữ Tiếng Anh | Tính Chất |
|---|---|---|---|---|
TY_KIEN |
Tỷ Kiên | 比肩 | Friend | Đồng hành cùng cực |
KIEP_TAI |
Kiếp Tài | 劫財 | Rob Wealth | Đồng hành dị cực |
THUC_THAN |
Thực Thần | 食神 | Eating God | Ta sinh cùng cực |
THUONG_QUAN |
Thương Quan | 傷官 | Hurting Officer | Ta sinh dị cực |
THIEN_TAI |
Thiên Tài | 偏財 | Indirect Wealth | Ta khắc cùng cực |
CHINH_TAI |
Chính Tài | 正財 | Direct Wealth | Ta khắc dị cực |
THAT_SAT |
Thất Sát | 七殺 | Seven Killings | Khắc ta cùng cực |
CHINH_QUAN |
Chính Quan | 正官 | Direct Officer | Khắc ta dị cực |
THIEN_AN |
Thiên Ấn | 偏印 | Indirect Seal | Sinh ta cùng cực |
CHINH_AN |
Chính Ấn | 正印 | Direct Seal | Sinh ta dị cực |
5.2 Trọng số phần trăm Tàng Can trong 12 Địa Chi (Hidden stems weighting)
Trong mỗi Địa Chi, các Thiên Can ẩn tàng được chuẩn hóa theo tỷ lệ phần trăm đóng góp năng lượng theo [9] được mã hóa trực tiếp trong engine:
- Tý (子): Quý (100%).
- Sửu (丑): Kỷ (60%), Quý (30%), Tân (10%).
- Dần (寅): Giáp (60%), Bính (30%), Mậu (10%).
- Mão (卯): Ất (100%).
- Thìn (辰): Mậu (60%), Ất (30%), Quý (10%).
- Tỵ (巳): Bính (60%), Canh (30%), Mậu (10%).
- Ngọ (午): Đinh (70%), Kỷ (30%).
- Mùi (未): Kỷ (60%), Đinh (30%), Ất (10%).
- Thân (申): Canh (60%), Nhâm (30%), Mậu (10%).
- Dậu (酉): Tân (100%).
- Tuất (戌): Mậu (60%), Tân (30%), Đinh (10%).
- Hợi (亥): Nhâm (70%), Giáp (30%).
Tổng năng lượng ẩn tàng trong mỗi Địa Chi thỏa mãn điều kiện chuẩn hóa:
5.3 Vòng Trường Sinh thập nhị giai đoạn (Twelve life stages)
12 giai đoạn phát triển năng lượng của Thiên Can trên từng Địa Chi bao gồm: Trường Sinh (長生), Mộc Dục (沐浴), Quan Đới (冠帶), Lâm Quan (臨官), Đế Vượng (帝旺), Suy (衰), Bệnh (病), Tử (死), Mộ (墓), Tuyệt (絕), Thai (胎), Dưỡng (養).
Chiều vận hành của Vòng Trường Sinh tuân thủ nguyên lý: Dương can thuận hành, Âm can nghịch hành tính từ vị trí khởi sinh được quy chuẩn trong thư mục mã nguồn bazi-core.cjs.
6 Thuật toán phân định Đại Vận và Thần Sát (Luck pillars and shen sha algorithms)
6.1 Phân định chiều vận và khoảng cách Tiết lệnh khởi vận (Luck direction and initiation)
Chiều dịch chuyển của các bước Đại Vận (mỗi bước kéo dài 10 năm) được xác định bởi tổ hợp giữa cực tính năm sinh và giới tính đương số (Quy tắc BAZI-R004):
- Thuận hành (Forward): Dương Nam (Nam sinh năm Dương Can) hoặc Âm Nữ (Nữ sinh năm Âm Can).
- Nghịch hành (Backward): Âm Nam (Nam sinh năm Âm Can) hoặc Dương Nữ (Nữ sinh năm Dương Can).
Thuật toán xác định tuổi khởi Đại Vận ():
- Chiều thuận: Đếm số ngày từ thời điểm sinh tới thời điểm bắt đầu của Tiết khí Minor kế tiếp.
- Chiều nghịch: Đếm số ngày từ thời điểm sinh lùi về thời điểm bắt đầu của Tiết khí Minor liền trước.
- Quy tắc tỷ lệ cổ điển ấn định 3 ngày tương ứng 1 năm dương lịch:
6.2 Hệ thống 26 Thần Sát quy chuẩn (Standardized twenty-six shen sha)
Hệ thống mã hóa và kiểm thử 26 Thần Sát kinh điển chia thành hai nhóm:
- Nhóm Cát Tinh (Auspicious Stars): Thiên Ất Quý Nhân (天乙貴人), Văn Xương Quý Nhân (文昌貴人), Thiên Đức Quý Nhân (天德貴人), Nguyệt Đức Quý Nhân (月德貴人), Lộc Thần (祿神), Dịch Mã (驛馬), Đào Hoa (桃花/咸池), Tướng Tinh (將星), Hoa Cái (華蓋), Kim Dư (金輿), Thiên Y (天醫), Phúc Tinh (福星), Quốc Ấn (國印), Tam Kỳ Quý Nhân (三奇貴人).
- Nhóm Hung Tinh (Inauspicious Stars): Kình Dương (擎羊/羊刃), Đà La (陀羅), Kiếp Sát (劫煞), Vong Thần (亡神), Cô Thần (孤神), Quả Tú (寡宿), Nguyên Thần (元辰/大耗), Không Vong (空亡), Tai Sát (災煞), Lục Ách (六厄), Âm Dương Sát (陰陽煞), Câu Giảo (勾絞).
6.3 Giải thuật tra cứu quan hệ hợp xung hình hại (Pairwise interaction lookup)
Để phát hiện tương tác giữa các trụ, hệ thống triển khai hàm lookupUnorderedPair(table, a, b):
Giải thuật này loại bỏ hoàn toàn các lỗi phụ thuộc vào thứ tự chuỗi hoặc sắp xếp từ điển mảng khi tra cứu Lục Hợp, Tam Hợp, Lục Xung, Lục Hại, và Tam Hình.
7 Hồ sơ audit codebase và giải pháp xử lý sai lệch (Codebase audit and discrepancy resolution)
Hồ sơ audit kỹ thuật độc lập [5] ghi nhận và giải quyết 6 sai lệch trọng yếu giữa lý thuyết kiến trúc và thực thi mã nguồn:
7.1 Sai lệch phân cực Thực Thần và Thương Quan trong mã nguồn (Ten gods polarity discrepancy)
- Điểm mơ hồ phát hiện: Trong khai báo đối tượng
TEN_GODSban đầu của tệpbazi-core.cjs, khóagenerate-same(ta sinh, cùng âm dương) bị gán nhãn là 'Thương Quan', trong khigenerate-diff(ta sinh, khác âm dương) bị gán nhãn là 'Thực Thần'. Ngược lại, bảng tra trực tiếpTEN_GODS_MAPPINGtừng có sự không nhất quán giữa các Thiên Can. - Bản chất lý thuyết cổ điển: Theo Uyên Hải Tử Bình [8], Giáp (Dương Mộc) sinh Bính (Dương Hỏa) là cùng dấu âm dương, khí thuần túy nên gọi là Thực Thần (食神); Giáp sinh Đinh (Âm Hỏa) là khác dấu âm dương, Đinh Hỏa khắc trực tiếp Tân Kim (Chính Quan của Giáp) nên gọi là Thương Quan (傷官).
- Giải pháp chuẩn hóa: Đồng bộ toàn diện ma trận tra cứu
TEN_GODS_MAPPING100 trạng thái và hàmgetTenGodđể đảm bảo: cùng âm dương ta sinh = Thực Thần; khác âm dương ta sinh = Thương Quan.
7.2 Lỗi sắp xếp từ điển khi tra cứu cặp quan hệ hai chiều (Unordered pair lookup failure)
- Hiện tượng lỗi: Nhiều quan hệ Lục Hợp (Tý-Sửu, Mão-Tuất), Thiên Can Hợp (Ất-Canh) bị bỏ sót không hiển thị trong báo cáo phân tích.
- Nguyên nhân mã nguồn: Mã cũ sử dụng
[a, b].sort().join('-')rồi so sánh với bảng tra cứu có khóa cố định theo trật tự kinh điển (ví dụ:Tý-Sửu), dẫn đến việc chuỗi bị đảo thứ tự từ điển không khớp khóa. - Giải pháp: Triển khai hàm
lookupUnorderedPair(table, a, b)thử nghiệm đối xứng cả hai tổ hợpa-bvàb-amà không làm biến dạng trật tự gốc.
7.3 Khắc phục lỗi cộng dồn kinh độ kép trong Giờ Thái Dương Thực (True solar time redundancy)
- Hiện tượng lỗi: Khi người dùng cung cấp kinh độ cụ thể, giờ sinh thực tế bị dịch chuyển gấp đôi độ lệch thời gian (lệch thêm vài phút so với chuẩn thiên văn).
- Nguyên nhân mã nguồn: Hàm
calculateFourPillarsđã gọigetTrueSolarTimeForBaziđể tính giờ/phút hiệu chỉnh, sau đó lại tiếp tục truyền thuộc tínhlongitudevào hàmgetHourCanChi, khiến kinh độ bị trừ lặp lại hai lần. - Giải pháp: Sau khi quy đổi thành công
effectiveHourvàeffectiveMinute, thuộc tínhlongitudebị ngắt hoàn toàn khỏi các lệnh gọi suy diễn phía sau (xembazi-core.cjsdòng 1114).
7.4 Phân định Tiết Minor và loại trừ Trung Khí trong tính khởi vận (Minor solar term luck boundary)
- Hiện tượng lỗi: Tuổi khởi Đại Vận bị sai lệch, thường khởi sớm hơn lý thuyết từ 1 đến 3 tuổi.
- Nguyên nhân mã nguồn: Vòng lặp tìm kiếm tiết khí gần nhất quét qua mọi điểm có cờ
isStart === true, bao gồm cả Trung khí (Major Solar Term). Theo quy tắc Tử Bình cổ điển, tháng chỉ mở đầu bằng Tiết khí (Minor Term). - Giải pháp: Thắt chặt điều kiện biên tại dòng 1499 của
bazi-core.cjs:
7.5 Đồng bộ mốc Lập Xuân cho Trụ Năm trong Lưu Niên (Annual solar year synchronization)
- Hiện tượng lỗi: Khi phân tích Lưu Niên (vận từng năm), các trường hợp sinh vào tháng Giêng âm lịch trước tiết Lập Xuân bị gán nhầm Can Chi của năm sau.
- Giải pháp: Thay thế toàn bộ phép tính năm Gregory thuần túy bằng giá trị
solarYearsuy dẫn từ kinh độ Mặt Trời tại tiết Lập Xuân.
7.6 Đảm bảo tính toàn vẹn cấu trúc đối tượng Thiên Can (Stem object parameter integrity)
- Hiện tượng lỗi: Trong hàm
generateDetailedReading, các lệnh gọi tính Thập Thần bị rơi về giá trị mặc định 'Tỷ Kiên'. - Nguyên nhân: Hàm nhận tham số đầu vào là chuỗi string thay vì đối tượng Thiên Can đầy đủ có chứa thuộc tính
elementvàpolarity. - Giải pháp: Chuẩn hóa giao diện gọi hàm, đảm bảo đối tượng truyền vào luôn là cấu trúc thực thể đầy đủ lấy từ danh mục
HEAVENLY_STEMS.
8 Giới hạn và các vùng biên mơ hồ (Limitations and boundary ambiguities)
Hệ thống công khai minh bạch các giới hạn tính toán hiện hữu:
8.1 Vấn đề phân định Dạ Tý và Chính Tý (Early and late rat transition)
Canh giờ Tý kéo dài từ 23:00 đêm hôm trước đến 01:00 sáng hôm sau. Tồn tại hai trường phái học thuật trong Tử Bình:
- Phân chia Dạ Tý và Chính Tý: Khoảng 23:00–23:59 (Dạ Tý) giữ nguyên Can Chi ngày hôm nay, dùng Can ngày hôm nay để khởi Can giờ; từ 00:00 trở đi (Chính Tý) mới sang Can Chi ngày hôm sau.
- Không phân chia: Cứ từ 23:00 là chuyển hẳn sang Can Chi ngày hôm sau.
BaZi Engine hỗ trợ cờ tùy chọn earlyRat (mặc định tắt, tuân thủ nguyên lý ngày dân sự bắt đầu từ 00:00:00 theo ISO 8601).
8.2 Chuyển giao ngày hiệu lực khi Giờ Thái Dương Thực vượt nửa đêm (Midnight date crossing)
Khi người dùng sinh vào lúc 23:55 tại kinh độ phía Tây của kinh tuyến chuẩn, phép hiệu chỉnh TST có thể đưa giờ thực lùi về 23:45 (cùng ngày) hoặc sinh lúc 00:05 tại kinh độ phía Đông có thể đưa giờ thực tiến lên trước nửa đêm hôm trước. Hiện tượng này làm thay đổi effectiveJdn của Trụ Ngày. Engine cảnh báo người dùng về độ nhạy cảm của các lá số sinh sát ranh giới nửa đêm.
8.3 Ranh giới giữa thuật toán Dụng Thần heuristic và mô hình Nguyệt Lệnh cổ điển (Useful god heuristic boundaries)
Mô hình xác định Dụng Thần (Useful God) hiện tại trong determineUsefulGod vận hành theo thuật toán heuristic dựa trên cân bằng ngũ hành lượng hóa (đếm điểm vượng suy của ngũ hành qua Can lộ và Tàng Can). Mặc dù thuật toán này đạt tính tất định 100%, nó không phản ánh trọn vẹn sự tinh vi của các cách cục đặc biệt cổ điển (Tòng cách, Hóa khí cách, Chuyên vượng cách) vốn phụ thuộc vào sự phán đoán chủ quan của chuyên gia.
9 Kết luận (Conclusion)
Hệ thống BaZi Engine (@quizzman/qm-bazi v3.0.0) thiết lập một chuẩn mực tính toán mệnh lý Tử Bình Bát Tự hiện đại, loại bỏ các giả định tùy tiện và đặt nền móng toàn bộ trên cơ học thiên văn giải tích VSOP87 và lịch pháp Julian Day Number.
Hồ sơ audit kỹ thuật độc lập đã xác định rõ và khắc phục toàn bộ 6 khiếm khuyết trong các phiên bản trước, đồng thời minh bạch hóa các vùng biên mơ hồ giữa lý thuyết cổ điển và mô hình tính toán số học. Bộ dữ liệu kiểm chuẩn BAZI-BENCH-QP-BAZI-001 bảo đảm tính tái lập và khả năng kiểm chứng độc lập của toàn bộ các thuật toán được công bố trong tài liệu này.
Tài liệu tham khảo (Bibliography)
- [2] ISO 8601-1:2019, Date and time — Representations for information interchange — Part 1: Basic rules.
- [6] ISO 2145:1978, Documentation — Numbering of divisions and subdivisions in written documents.
- [7] ISO 690:2021, Information and documentation — Guidelines for bibliographic references and citations to information resources.
- [4] Quizzman Research Team (2026), Kiến trúc hệ thống tính toán lịch pháp âm dương và mô hình quy chiếu thiên văn Quizzman.
- [3] Jean Meeus (1998), Astronomical Algorithms, 2nd Edition, Willmann-Bell, Richmond, Virginia.
- [1] P. Bretagnon, G. Francou (1988), Planetary theories in rectangular and spherical variables. VSOP87 solutions, Astronomy and Astrophysics, Vol. 202, pp. 309–315.
- [8] Từ Tử Bình, Đường Khái (1200), Uyên Hải Tử Bình (淵海子平).
- [9] Vạn Dân Anh (1578), Tam Mệnh Thông Hội (三命通會).
- [10] Kinh Đồ, Lưu Cơ (1368), Đích Thiên Tủy (滴天髓).
- [11] Thẩm Hiếu Chiêm (1776), Tử Bình Chân Thuyên (子平真詮).
- [12] Dư Xuân Đài (1600), Cùng Thông Bảo Giám (窮通寶鑑).
- [5] Quizzman Engineering Group (2026), Báo cáo Audit & Vá Lỗi Engine Bát Tự (Tứ Trụ) — Dossier AUD-2026-BAZI-01.
Tài liệu tham khảo (Hồ sơ ISO 690)
- [2] International Organization for Standardization. ISO 8601-1:2019 Date and time — Representations for information interchange — Part 1: Basic rules. ISO, 2019. [URL] (Governing international standard for date and time representations and midnight boundary definitions.)
- [6] International Organization for Standardization. ISO 2145:1978 Documentation — Numbering of divisions and subdivisions in written documents. ISO, 1978. [URL] (Governing standard for decimal hierarchy numbering without trailing periods.)
- [7] International Organization for Standardization. ISO 690:2021 Information and documentation — Guidelines for bibliographic references and citations to information resources. ISO, 2021. [URL] (Standard profile for bibliographic records and citation structures.)
- [4] Quizzman Research & Engineering Team. Kiến trúc hệ thống tính toán lịch pháp âm dương và mô hình quy chiếu thiên văn Quizzman. Quizzman Paper Publishing System, 2026. [URL] (Foundational astronomical specification providing VSOP87 solar terms, Julian Day continuous counting, and True Solar Time reductions.)
- [3] Meeus, Jean. Astronomical Algorithms. Edition 2nd edition. Willmann-Bell, Inc., 1998. (Standard algorithmic reference for planetary coordinate reductions, Equation of Time, and solar longitude tracking.)
- [1] Bretagnon, Pierre; Francou, Gérard. Planetary theories in rectangular and spherical variables. VSOP87 solutions. 1988. [URL] (Analytical theory of planetary motion used to resolve exact apparent ecliptic solar longitudes for solar term boundary transitions.)
- [8] Từ Tử Bình (Xu Ziping); Đường Khái (Tang Gai) biên tập. Uyên Hải Tử Bình (淵海子平). 1200. (Foundational classical treatise on Four Pillars of Destiny establishing Day Master lordship, Ten Gods derivation, and seasonal commands.)
- [9] Vạn Dân Anh (Wan Minying). Tam Mệnh Thông Hội (三命通會). 1578. (Encyclopedic compendium of classical destiny calculation codifying Shen Sha algorithms, hidden stem proportions, and sixty stem-branch interactions.)
- [10] Kinh Đồ (Jing Tu); Lưu Cơ (Liu Ji) chú giải. Đích Thiên Tủy (滴天髓). 1368. (Classical philosophical authority on Five Elements equilibrium, root vigor (thông căn), and seasonal strength determination.)
- [11] Thẩm Hiếu Chiêm (Shen Xiaozhan). Tử Bình Chân Thuyên (子平真詮). 1776. (Analytical treatise standardizing pattern acquisition (cách cục), useful god (dụng thần) prioritization, and monthly commander weightings.)
- [12] Dư Xuân Đài (Yu Chuntai) biên soạn. Cùng Thông Bảo Giám (窮通寶鑑). 1600. (Seasonal regulator manual defining climate adjustment (điều hậu) and elemental dependencies for all ten Day Masters across twelve branches.)
- [5] Quizzman Engineering Group. Báo cáo Audit & Vá Lỗi Engine Bát Tự (Tứ Trụ) — Dossier AUD-2026-BAZI-01. Quizzman Lab Internal Audit Series, 2026. [URL] (Comprehensive architectural and empirical audit resolving Ten Gods polarity inversion, unordered pair matching, True Solar Time redundancy, and minor solar term luck initiation.)