Skip to main content

Crate xstars

Crate xstars 

Source
Expand description

§xstars — 紫微斗数排盘引擎

xstars 实现紫微斗数排盘算法。

支持多种排盘流派(三合、中州、飞星),完整的运限系统(大限/小限/流年/月/日/时), 及多语言输出(简体中文、繁体中文、英语)。

§快速开始

use xstars::Astrolabe;

// 从阳历日期创建命盘
let astro = Astrolabe::builder("2000-8-16", "寅", "女")
    .build().unwrap();
assert_eq!(astro.palaces.len(), 12);

// 访问命宫
let ming = &astro.palaces[astro.fate_pos.index()];
println!("命宫: {}", ming.name);

§架构

xstars
├── astro/       # 星盘 + 宫位 + 运限(Astrolabe/Palace/Yunxian)
├── calendar/    # 八字、历法转换
├── config/      # 流派配置(三合/中州/飞星)
├── i18n/        # 国际化:to_str()/display()/set_language()
├── star/        # 星曜系统(安星算法 + 星曜数据)
├── system/      # 天干地支五行阴阳
└── util/        # 工具函数

§国际化

所有枚举统一通过 to_str()(跟随全局语言)、display(lang)(显式指定)、 from_str()(跨语言解析)三个方法输出多语言字符串:

use xstars::i18n::{set_language, Language};
use xstars::StarName;

// 默认中文
assert_eq!(StarName::Ziwei.to_str(), "紫微");

// 切换英语
set_language(Language::EnUS);
assert_eq!(StarName::Ziwei.to_str(), "Zi Wei");

// 显式指定语言(不改变全局设置)
assert_eq!(StarName::Ziwei.display(Language::ZhCN), "紫微");

// 跨语言解析
assert_eq!(StarName::from_str("Zi Wei"), Some(StarName::Ziwei));
assert_eq!(StarName::from_str("紫微"), Some(StarName::Ziwei));

§宫位查询与星曜查找

use xstars::Astrolabe;
use xstars::astro::palace_pos::PalacePos;

let astro = Astrolabe::builder("2000-8-16", "寅", "女")
    .build().unwrap();

// 按位置或名称访问宫位(返回引用)
let p1 = &astro[PalacePos::Yin];           // 索引
let p2 = astro.palace_by_str("命宫");     // 查找

// 空宫判断
assert!(!astro.is_empty(astro.fate_pos));

// 三方四正
let sp = astro.cast(astro.fate_pos);
println!("对宫: {:?}", sp.opposite);

// 跨宫位查找星曜
if let Some(pos) = astro.star_pos_by_str("紫微") {
    println!("紫微在 {:?}", pos);
}

§坐标系约定

  • PalacePos(宫位坐标): 寅=0, 卯=1, …, 丑=11
  • Dizhi index(地支索引): 子=0, 丑=1, …, 亥=11
  • 所有安星算法返回 PalacePos,语义化宫位坐标

§完整文档

The astronomy implementation is provided by the xcal crate.

§参考标准

所有测试以 参考 测试套件为基准。

Re-exports§

pub use astro::Astrolabe;
pub use astro::CastPalaces;
pub use astro::Layer;
pub use astro::Palace;
pub use astro::PalaceName;
pub use astro::PalacePos;
pub use astro::Yunxian;
pub use astro::YunxianLayer;
pub use calendar::Bazi;
pub use calendar::Location;
pub use calendar::Pillar;
pub use config::school::School;
pub use config::AgeDivide;
pub use config::AppConfig;
pub use config::DayDivide;
pub use config::HuaTable;
pub use config::LeapMonthRule;
pub use config::MajorCycleDivide;
pub use config::MingzhuRule;
pub use config::MinorCycleDivide;
pub use config::MiscStarSet;
pub use config::StarScope;
pub use config::SuiqianVariant;
pub use config::TianshiRule;
pub use config::YearDivide;
pub use error::Error;
pub use star::Brightness;
pub use star::Hua;
pub use star::Star;
pub use star::StarName;
pub use star::StarType;
pub use system::Dizhi;
pub use system::DizhiView;
pub use system::Gender;
pub use system::Shichen;
pub use system::Tiangan;
pub use system::Wuxing;
pub use system::WuxingGroup;
pub use system::YinYang;

Modules§

astro
星盘系统
calendar
日历适配层
config
配置系统
error
错误类型定义
i18n
国际化模块
prelude
xstars prelude — 安星算法中需要全域可用的基础 trait
star
星曜系统
system
系统模块 - 哲学文化规则体系
util
工具函数

Macros§

impl_enum_str
声明式宏:为枚举自动生成国际化统一接口。