Kiểm thư viện Tử Vi, lịch âm của anh chị bằng bộ ca kiểm chung

Bộ ca kiểm của Nhật Nguyệt là 17.291 cặp đầu vào và đáp án do lõi tính đang chạy trên site sinh ra: ai viết thư viện Tử Vi, Bát Tự, thần số học, lịch âm ở bất kỳ ngôn ngữ nào cũng so được với nó. Bản TypeScript và Python của Nhật Nguyệt phải đạt trọn mọi ca. Bài này em chỉ cách đem thư viện của anh chị ra so.
Bộ ca kiểm có gì?
| tệp | số ca | nội dung |
|---|---|---|
am-lich.json | 14.936 | dương sang âm (11.039), âm sang dương (3.696), mốc 24 tiết khí từng năm (201), cả âm lịch Trung Quốc, Hàn Quốc |
tu-vi.json | 777 | lá số, đại vận, hạn năm và sao lưu 2026, cách cục |
bat-tu.json | 777 | tứ trụ, thập thần, đại vận, tiểu vận |
than-so-hoc.json | 600 | các con số theo họ tên và ngày sinh |
le-hoi.json | 201 | ngày dương của từng lễ, mỗi năm 1900 tới 2100 |
Mọi tệp cùng một khuôn:

phienBanDongCo: phiên bản lõi tính đã sinh đáp án, hiện là 2.0.1.khoaBo: 18 khoá là chữ diễn giải (dienGiai,caveat,cachTinh...), bỏ đi trước khi so ở mọi tầng, vì câu chữ đổi mà phép tính không đổi.ca: mảng{"vao", "ra"}; đầu vào của từng môn ghi ở QUY-UOC.md trong kho mã.
Các bước so
- Tải thư mục
ca-kiemtừ kho mã. - Viết hàm
tinh(vao)gọi thư viện của anh chị và trả kết quả đúng khoá củara. - Bỏ các khoá trong
khoaBoở cả hai bên, mọi tầng. - So sâu: thứ tự khoá không tính, mảng so theo thứ tự, số thực lệch tối đa 1e-9, khoá thiếu hay thừa đều là lệch.
- In chỗ lệch đầu tiên kèm đường dẫn khoá, sửa, chạy lại tới khi đạt trọn.
Bộ so viết bằng Python
import json, math, sys
def bo_khoa(v, bo):
if isinstance(v, dict):
return {k: bo_khoa(x, bo) for k, x in v.items() if k not in bo}
if isinstance(v, list):
return [bo_khoa(x, bo) for x in v]
return v
def lech(mong, that, duong="ra"):
if isinstance(mong, bool) or isinstance(that, bool):
return None if mong is that else f"{duong}: chờ {mong}, ra {that}"
if isinstance(mong, (int, float)) and isinstance(that, (int, float)):
return None if abs(mong - that) <= 1e-9 else f"{duong}: chờ {mong}, ra {that}"
if isinstance(mong, dict) and isinstance(that, dict):
for k in sorted(set(mong) | set(that)):
if k not in that or k not in mong:
return f"{duong}.{k}: thiếu hoặc thừa khoá"
r = lech(mong[k], that[k], f"{duong}.{k}")
if r:
return r
return None
if isinstance(mong, list) and isinstance(that, list):
if len(mong) != len(that):
return f"{duong}: độ dài chờ {len(mong)}, ra {len(that)}"
for i, (a, b) in enumerate(zip(mong, that)):
r = lech(a, b, f"{duong}[{i}]")
if r:
return r
return None
return None if mong == that else f"{duong}: chờ {mong!r}, ra {that!r}"
def kiem(mon, tinh, loc=lambda vao: True):
tep = json.load(open(f"ca-kiem/{mon}.json", encoding="utf-8"))
bo = set(tep["khoaBo"])
dat = tong = 0
for ca in tep["ca"]:
if not loc(ca["vao"]):
continue
tong += 1
r = lech(bo_khoa(ca["ra"], bo), bo_khoa(tinh(ca["vao"]), bo))
if r is None:
dat += 1
elif tong - dat <= 3:
print(" lệch:", ca["vao"], r)
print(f"{mon}: {dat}/{tong} ca đạt")Đem thư viện lịch âm ra so, rồi thử một bản cố ý sai (quên múi giờ, luôn tính ở UTC+8):
from kiem_ca import kiem
from nhatnguyet import am_lich
def am_sang_duong(vao):
duong, hop_le = am_lich.lunar_to_solar(vao["ngay"], vao["thang"], vao["nam"], vao["nhuan"], vao.get("muiGio", 7))
return {"duong": duong, "hopLe": hop_le}
kiem("am-lich", am_sang_duong, lambda vao: vao["phep"] == "am-sang-duong")
# Thử một bản sai: quên múi giờ, luôn tính ở UTC+8
def ban_sai(vao):
duong, hop_le = am_lich.lunar_to_solar(vao["ngay"], vao["thang"], vao["nam"], vao["nhuan"], 8)
return {"duong": duong, "hopLe": hop_le}
kiem("am-lich", ban_sai, lambda vao: vao["phep"] == "am-sang-duong")am-lich: 3696/3696 ca đạt
lệch: {'nam': 1914, 'ngay': 1, 'nhuan': False, 'phep': 'am-sang-duong', 'thang': 10} ra.duong.day: chờ 17, ra 18
lệch: {'nam': 1914, 'ngay': 15, 'nhuan': False, 'phep': 'am-sang-duong', 'thang': 10} ra.duong.day: chờ 1, ra 2
lệch: {'nam': 1914, 'ngay': 29, 'nhuan': False, 'phep': 'am-sang-duong', 'thang': 10} ra.duong.day: chờ 15, ra 16
am-lich: 3593/3696 ca đạt
Bản đúng đạt 3.696/3.696. Bản sai đạt 3.593, lệch 103 ca, và dòng lệch chỉ thẳng chỗ hỏng: ra.duong.day: chờ 17, ra 18, tức mùng một tháng 10 năm 1914 sớm hơn một ngày ở giờ Việt Nam.
Cùng việc ấy bằng TypeScript
import { readFileSync } from "node:fs";
import { lapLaSoTuVi, daiVan, tinhHanNam, tinhSaoLuu, nhanDienCachCuc } from "@nhatnguyet/tu-vi";
const tep = JSON.parse(readFileSync("ca-kiem/tu-vi.json", "utf8"));
const bo = new Set(tep.khoaBo);
const sach = (x) => Array.isArray(x) ? x.map(sach)
: x && typeof x === "object" ? Object.fromEntries(Object.entries(x).filter(([k]) => !bo.has(k)).map(([k, v]) => [k, sach(v)]))
: x;
function lech(a, b, duong = "ra") {
if (typeof a === "number" && typeof b === "number") return Math.abs(a - b) <= 1e-9 ? null : `${duong}: chờ ${a}, ra ${b}`;
if (Array.isArray(a) && Array.isArray(b)) {
if (a.length !== b.length) return `${duong}: độ dài chờ ${a.length}, ra ${b.length}`;
for (let i = 0; i < a.length; i++) { const r = lech(a[i], b[i], `${duong}.${i}`); if (r) return r; }
return null;
}
if (a && b && typeof a === "object" && typeof b === "object") {
for (const k of new Set([...Object.keys(a), ...Object.keys(b)])) {
if (!(k in a) || !(k in b)) return `${duong}.${k}: thiếu hoặc thừa khoá`;
const r = lech(a[k], b[k], `${duong}.${k}`); if (r) return r;
}
return null;
}
return a === b ? null : `${duong}: chờ ${JSON.stringify(a)}, ra ${JSON.stringify(b)}`;
}
let dat = 0;
for (const { vao, ra } of tep.ca) {
const laSo = lapLaSoTuVi("", vao.gioiTinh, vao.dd, vao.mm, vao.yyyy, vao.gio);
const kq = { laSo, daiVan: daiVan(laSo), hanNam: tinhHanNam(laSo, vao.namXem),
saoLuu: tinhSaoLuu(laSo, vao.namXem), cachCuc: nhanDienCachCuc(laSo) };
const r = lech(sach(ra), sach(JSON.parse(JSON.stringify(kq))));
if (r) console.log("lệch", vao, r); else dat++;
}
console.log(`tu-vi: ${dat}/${tep.ca.length} ca đạt`);tu-vi: 777/777 ca đạt
Khi ca kiểm lệch thì làm gì?
- Đọc đường dẫn khoá trước: lệch ở
ngaySinhAmthì lỗi ở lịch, lệch ởcungthì lỗi ở an sao. - Chỗ các phái khác nhau là quy ước, không phải lỗi: giờ Tý từ 23h, Tứ Hóa can Canh, tháng nhuận. Thư viện chọn cách khác thì ghi rõ trong tài liệu và lọc riêng ca ấy.
- Nghi đáp án sai thì đừng sửa ca kiểm: gửi đầu vào và kết quả của anh chị về [email protected], em đối chiếu lại lõi tính.
Đạt trọn ca kiểm nghĩa là thư viện áp đúng quy tắc của phái như lõi tính của Nhật Nguyệt; nó không nói quy tắc Tử Vi hay Bát Tự đúng với đời người, điều ấy chưa được kiểm chứng.
Giấy phép
Ca kiểm theo CC BY 4.0, mã theo MIT. Ghi trong README của anh chị: "Ca kiểm: Nhật Nguyệt (nhatnguyet.org)". Kho mã và ca kiểm ở trang mã nguồn mở.



