x-iztro 0.1.0

紫微斗数排盘核心库：100% 对齐 iztro，支持 Rust / Python / Go 调用
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

use serde::{Deserialize, Serialize};

use crate::data::stars::StarKey;
use crate::data::types::*;
use crate::models::star::Star;

/// 单个运限层级（大限/流年/流月/流日/流时）的数据。
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct HoroscopeItem {
    /// 该运限所在宫位索引（0-11，寅宫为 0）
    pub index: usize,
    /// 层级显示名（大限/童限/流年/流月/流日/流时，按输出语言翻译）
    pub name: String,
    /// 该运限天干
    pub heavenly_stem: HeavenlyStem,
    /// 该运限地支
    pub earthly_branch: EarthlyBranch,
    /// 以该运限所在宫位为命宫推排的十二宫名（按宫位索引排列）
    pub palace_names: Vec<Palace>,
    /// 该运限天干引发的四化星 [禄, 权, 科, 忌]
    pub mutagen: Vec<StarKey>,
    /// 流耀在十二宫的分布（无流耀的层级为 None）
    pub stars: Option<Vec<Vec<Star>>>,
}

/// 小限数据。
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AgeItem {
    /// 通用运限字段
    #[serde(flatten)]
    pub base: HoroscopeItem,
    /// 虚岁
    pub nominal_age: u32,
}

/// 流年十二神：按目标年支起的岁前十二神与将前十二神。
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct YearlyDecStar {
    /// 将前十二神（按宫位索引排列）
    pub jiangqian12: Vec<StarKey>,
    /// 岁前十二神（按宫位索引排列）
    pub suiqian12: Vec<StarKey>,
}

/// 流年数据（含流年十二神）。
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct YearlyItem {
    /// 通用运限字段
    #[serde(flatten)]
    pub base: HoroscopeItem,
    /// 流年十二神
    pub yearly_dec_star: YearlyDecStar,
}

/// 一次运限查询的完整结果。
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct HoroscopeData {
    /// 目标阳历日期（与查询入参一致）
    pub solar_date: String,
    /// 目标农历日期中文表示
    pub lunar_date: String,
    /// 大限（未起运时为童限）
    pub decadal: HoroscopeItem,
    /// 小限
    pub age: AgeItem,
    /// 流年
    pub yearly: YearlyItem,
    /// 流月
    pub monthly: HoroscopeItem,
    /// 流日
    pub daily: HoroscopeItem,
    /// 流时
    pub hourly: HoroscopeItem,
}