Tính toán, bằng chứng, giải thích, kiểm chứng

Quy trình bốn tầng

1. 01

   Tính toán: việc lập lá số do thuật toán thực hiện

   Việc chuyển đổi lịch pháp, thời điểm tiết khí, múi giờ, hiệu chỉnh giờ mặt trời thực, can chi của tứ trụ, tàng can, chiều thuận/nghịch của đại vận và thời điểm khởi vận đều do thuật toán tất định tính toán và ghi vào các trường có cấu trúc. Mô hình ngôn ngữ không tham gia vào bước này, cũng không được phép suy trực tiếp tứ trụ từ ngày sinh.

2. 02

   Bằng chứng: kết luận phải liệt kê được căn cứ

   Độ mạnh/yếu của Nhật chủ, cấu hình Thập thần, hợp xung hình hại, điều hậu và cách cục đều được xuất ra thành các mục bằng chứng có thể kiểm tra từng dòng: nguyệt lệnh nào, chỗ thông căn nào, can chi nào bị kích hoạt. Điểm số chỉ là cách biểu đạt nội bộ của những bằng chứng này, không phải bản thân phán đoán.

3. 03

   Giải thích: AI chịu trách nhiệm diễn đạt, không chịu trách nhiệm tính toán

   Mô hình ngôn ngữ chuyển các bằng chứng có cấu trúc thành lời giải thích dễ đọc, nêu rõ điều kiện áp dụng của kết luận. Khi có khác biệt giữa các phái, chúng tôi nói rõ điểm khác biệt và mức ưu tiên hiện đang áp dụng, thay vì biến một trong số đó thành đáp án đúng duy nhất.

4. 04

   Kiểm chứng: kiểm tra tính nhất quán và giới hạn trước khi xuất

   Sau khi phần giải thích được tạo, chúng tôi kiểm tra xem nó có thể truy nguyên về các mục bằng chứng có cấu trúc hay không, đồng thời lọc nội dung rủi ro cao theo giới hạn chủ đề. Kiểm tra tính nhất quán (Dụng thần, Hỷ thần, Kỵ thần, Cừu thần đôi một không trùng nhau) là ràng buộc cứng ở tầng chọn dụng: nếu ngũ hành phụ trợ do bảng điều hậu đưa ra trùng với 「thứ sinh ra Kỵ thần」, nó sẽ được gán lại theo định nghĩa chức năng, và toàn bộ 120 tổ hợp Nhật chủ × Chi tháng đều được kiểm chứng hồi quy.

Engine version and changelog

Every algorithm fix that changes computed output bumps the engine version and is recorded here. A saved chart whose version no longer matches the current one is treated as stale and recomputed — using the same birth details stored alongside it, so conventions such as true solar time are not lost. In the rare case where an early record lacks the fields needed (year, month, day, hour, minute) it cannot be recomputed faithfully, so we keep the original chart rather than guess at one. Copy and layout changes do not bump the version.

Changelog

1. v52026-09-25

   黄历吉时判定改用黄道黑道十二神

   Affects: Almanac

   此前吉时是按「当日宜的条数多于忌的条数」推断的，方向性是错的：实测 2026-09-25 会把 5 个黑道时辰列为吉时，反而把当天唯一的青龙黄道时辰（庚子）列为凶时。现改为按十二值神的黄道/黑道属性判定；引擎异常时返回 degraded 标记，页面显示「暂无数据」而不是编造吉时。同一天还把 Web 端与引擎包里逐行相同的两份黄历实现合并为一份，避免两端算出不同结果。

2. v42026-09-20

   年柱改以立春为界，闰月盘与平月盘分开缓存

   Affects: BaZi · Zi Wei Dou Shu

   年柱此前按农历正月初一切换，导致立春到春节之间出生的人年柱错误；现以立春为界。同时紫微斗数的缓存 key 加入 isLeapMonth —— 此前闰月盘与平月盘共用同一个 key，会互相污染（缓存版本因此从 v3 提到 v4）。

3. v32026-09-20

   时干改用五鼠遁

   Affects: BaZi

   部分时辰的时干存在偏移，现统一按五鼠遁由日干推时干。

4. v22026-09-20

   修复 computeBaziAccurate 在特定输入下崩溃

   Affects: BaZi

   特定出生信息组合会让排盘函数直接抛错，导致整个结果页不可用。

5. v12026-09-20

   引入引擎版本号（回溯起点）

   Affects: All

   此前没有版本概念，缓存失效靠人工改字符串。v1 是补记的起点，用于让后续版本号有参照。

Reproducible verification

These numbers can be reproduced directly — the commands live in the repository. We also pin known deviations with tests: a test list that only reports passes is not informative; one that states exactly where we differ is.

Engine regression tests (divination-core, bun test)

110

Web and mobile tests (bun test lib apps/mobile) · 29 files

215

Total: 325 · 2026-09-29

What the tests pin down

• Day-pillar anchor: 1949-10-01 = 甲子. The old implementation returned 庚申/戊子 and drifted with the host time zone.
• Every 子 hour's stem follows the five-rat rule. The old implementation got the stem wrong for *every* 子 hour because of a rotated-array index error (a 癸 day's 子 hour should be 壬子; it returned 甲子).
• The year pillar switches at 立春, not at the lunar new year.
• Leap-month birthdays must land on the leap month itself. Measured on 2023 leap second month, day 20: the old implementation was 30 days off and placed palaces differently in the second half of the leap month.
• **Known deviations are pinned explicitly**: 23:00 does not roll the day pillar (early/late 子 hour is a genuine school disagreement; BaZi here uses the 子正 rollover), and solar-term day boundaries use an approximation table rather than a second-precise solar-term instant. These are known, test-recorded behaviours — not undiscovered defects.

Passing tests show the implementation matches the conventions we state. They are not evidence that the method itself is scientifically validated.

Các quy ước chúng tôi áp dụng

Bát tự có nhiều cách tiếp cận truyền thống đều có căn cứ như nhau. Nguyên tắc của chúng tôi là cố định một bộ quy ước, ghi lại nó, cho phép đối chiếu, thay vì dùng các quy tắc khác nhau ở những trang khác nhau.

Cơ sở thời gian

Mặc định dùng giờ đồng hồ đã điền. Giờ mặt trời thực là phần hiệu chỉnh tùy chọn: chỉ khi được bật và đã cung cấp kinh độ nơi sinh, mới điều chỉnh theo kinh độ và phương trình thời gian, đồng thời ghi lại thời gian sau hiệu chỉnh trong kết quả.

Ranh giới Trụ năm

Chuyển theo thời điểm cụ thể của Lập Xuân, không dùng Tết Dương lịch, cũng không dùng Tết Nguyên Đán.

Ranh giới Trụ tháng

Chuyển theo thời điểm cụ thể của mười hai tiết (tiết khí), không liên quan đến tháng âm lịch.

Đổi ngày giờ Tý

Việc giờ Tý muộn tính vào ngày hôm đó hay ngày hôm sau là khác biệt giữa các phái, cả hai cách đều có người dùng. Cách triển khai của chúng tôi cố định một quy tắc và giữ nhất quán; nếu bạn quen với cách còn lại, Trụ ngày và Thập thần sẽ lệch toàn bộ, có thể dựa vào đó để đối chiếu khác biệt.

Mạnh yếu và chọn dụng

Phù ức và điều hậu được tính riêng, **kết luận của cả hai tầng đều được trình bày trong kết quả lập lá số**. Khi hai cách chỉ về những hướng khác nhau, chúng tôi nói rõ điểm khác biệt, hiện đang dùng tầng nào, và vì sao chọn như vậy. Khác biệt tự nó không phải lỗi: phù ức hỏi Nhật chủ có đủ sức gánh hay không, điều hậu hỏi mùa là lạnh hay ấm, khô hay ẩm —— hai câu hỏi khác nhau.

Lá số ở ngưỡng

Độ mạnh/yếu của Nhật chủ được tính bằng cách cộng trừ nhiều mục thành một điểm thô, rồi phân bậc theo 75 / 60 / 40 / 25. Khi điểm thô nằm trong khoảng 3 điểm quanh một ngưỡng nào đó, chúng tôi đánh dấu trực tiếp trong kết quả lập lá số, đồng thời chia thành hai nhóm: nhóm mà khi vượt ngưỡng sẽ đổi sang một cách chọn dụng khác (ngũ thần theo đó thay đổi), và nhóm chỉ thay đổi tên gọi cấp bậc. Phân bậc không phải suy diễn —— nhánh chọn dụng đã được tách thành một hàm thuần có thể tính giá trị cho cấp bậc giả định, chúng tôi tính một lần đầy đủ ngũ thần (Dụng thần / Kỵ thần / Hỷ thần / Cừu thần / Nhàn thần) ở hai bên ngưỡng rồi so khớp từng mục. Khảo sát thực tế cho thấy khoảng bốn phần mười lá số rơi vào dung sai 3 điểm quanh một ngưỡng nào đó.

Những gì chúng tôi không làm

• Sức khỏe

  Không cung cấp chẩn đoán bệnh, đánh giá tình trạng cơ thể hoặc lời khuyên điều trị. Với vấn đề sức khỏe, hãy tham khảo ý kiến chuyên gia y tế.

• Đầu tư và tài chính

  Không cung cấp điểm mua bán cổ phiếu, quỹ đầu tư hay tiền mã hóa, cũng không dự đoán giá cụ thể. Các quyết định tài chính nên dựa trên thông tin tài chính đúng quy định.

• Pháp lý

  Không cung cấp ý kiến pháp lý, cũng không phán đoán kết quả tranh tụng.

• An toàn cá nhân

  Không đưa ra khẳng định về nguy hiểm, tai nạn hay tuổi thọ; với vấn đề liên quan đến an toàn, vui lòng tìm trợ giúp chuyên môn ngoài đời thực.

• Quyết định lớn trong đời

  Không dùng kết luận mệnh lý làm căn cứ duy nhất cho các quyết định như hôn nhân, di cư, nghỉ việc.

• Tiên đoán mang tính chắc chắn

  Không cam kết ngày tháng và kết quả của sự kiện cụ thể. Theo định vị của chúng tôi, mệnh lý là khung tham chiếu văn hóa truyền thống; chúng tôi không tuyên bố nó có hiệu lực theo khoa học hiện đại.

Các giới hạn đã biết

• Khi thời gian sinh không chính xác, độ tin cậy của các kết luận liên quan đến trụ giờ sẽ giảm rõ rệt; đặc biệt là khi gần ranh giới giờ hoặc tiết khí.
• Những khác biệt giữa các phái không thể được “giải quyết”, mà chỉ có thể được trình bày rõ. Ở những điểm có khác biệt, chúng tôi chú thích chứ không che giấu.
• Với các lá số ở ngưỡng giới hạn, chúng tôi sẽ chú thích, nhưng **chú thích không có nghĩa là kết luận trở nên vững chắc**: khi điểm số gần ngưỡng, chỉ cần đổi một bộ trọng số là có thể nhận được hướng Dụng thần ngược lại; sự bất định này không thể bị loại bỏ, chỉ có thể được nói rõ. Mục “vượt qua ngưỡng có làm thay đổi Dụng thần hay không” là **được tính riêng cho từng lá số**, không phải ước lượng — nhưng cũng chỉ là câu trả lời theo bộ tiêu chí hiện tại.
• Nhãn Cừu thần của một số tổ hợp điều hậu được xác định theo cơ chế dự phòng dựa trên chức năng (ngũ hành hỗ trợ điều hậu cổ điển được ưu tiên giữ làm Hỷ thần), có đôi chút khác với định nghĩa nghiêm ngặt “sinh Kỵ thần”; với những tổ hợp này, vui lòng lấy “căn cứ chọn Dụng” làm chuẩn.
• Phần giải thích của AI có thể có sai lệch về diễn đạt. Nếu một lời giải thích nào đó không thể tìm thấy căn cứ ở tầng bằng chứng, vui lòng lấy phần lập lá số và các trường bằng chứng làm chuẩn.
• Chúng tôi tiếp nhận báo lỗi: nếu bạn phát hiện lỗi trong lập lá số hoặc quy tắc, bạn có thể gửi qua kênh phản hồi, chúng tôi sẽ sửa trong phiên bản sau.

Câu hỏi thường gặp

Mục từ liên quan

• Giờ sinh, múi giờ và giờ Mặt Trời thật: tính đúng thời gian trước khi lập Bát tự
• Thân vượng thân nhược nhìn thế nào: độ mạnh yếu của Nhật chủ không phải là điểm số
• Hiểu thế nào về Hỷ Dụng thần: không phải 「thiếu gì bổ nấy」
• Điều hậu là gì: Vì sao lạnh – ấm – khô – ẩm lại đi vào phán đoán Bát tự