张翔
36 KiB
36 KiB
紫微斗数数据模型设计
目录
一、现有数据模型分析
1.1 现有模型结构
1.1.1 ZiweiChart（命盘主类）
public class ZiweiChart {
private BirthInfo birthInfo;
private List<Palace> palaces;
private HeavenlyStem yearStem;
private EarthlyBranch mingGongBranch;
private EarthlyBranch shenGongBranch;
private String summary;
private String overallLuck;
}
优点：
- 结构清晰，包含基本信息
- 支持通过宫位类型和地支查询宫位
缺点：
- 缺少大限、流年、流月、流日、流时信息
- 缺少四化星的详细信息
- 缺少星曜格局信息
- 缺少三方四正关系信息
1.1.2 Palace（宫位类）
public class Palace {
private PalaceType palaceType;
private EarthlyBranch earthlyBranch;
private List<StarInfo> majorStars;
private List<String> minorStars;
private String analysis;
private int score;
}
优点：
- 包含宫位基本信息
- 支持主星和辅星
缺点：
- minorStars 使用 String 类型，不够类型安全
- 缺少宫位的三方四正关系
- 缺少宫位的四化信息
- 缺少宫位的星曜格局信息
1.1.3 StarInfo（星星信息类）
public class StarInfo {
private MajorStar star;
private StarNature nature;
private TransformationType transformation;
private int brightness;
private String description;
}
优点：
- 包含星星的基本信息
- 支持四化
缺点：
- 缺少星星的宫位信息
- 缺少星星的亮度计算逻辑
- 缺少星星的相互作用信息
1.2 现有枚举问题
1.2.1 MajorStar 枚举问题
public enum MajorStar {
ZIWEI("紫微", 1, StarNature.AUSPICIOUS, "帝星", "领导、权威、尊贵"),
TIANJI("天机", 2, StarNature.AUSPICIOUS, "智星", "智慧、谋略、变通"),
TAIYANG("太阳", 3, StarNature.AUSPICIOUS, "贵星", "光明、热情、慷慨"),
WUQU("武曲", 4, StarNature.NEUTRAL, "财星", "刚毅、务实、财帛"),
TIANXING("天同", 5, StarNature.AUSPICIOUS, "福星", "温和、福气、享受"),
LIANCHEN("廉贞", 6, StarNature.INAUSPICIOUS, "情星", "感情、才华、是非"),
TIANFU("天府", 7, StarNature.AUSPICIOUS, "库星", "稳重、保守、财富"),
TAIYIN("太阴", 8, StarNature.NEUTRAL, "母星", "温柔、内敛、母性"),
TANLANG("贪狼", 9, StarNature.INAUSPICIOUS, "欲星", "欲望、魅力、桃花"),
JUMEN("巨门", 10, StarNature.INAUSPICIOUS, "口星", "口才、是非、沟通"),
TIANXIANG("天相", 11, StarNature.AUSPICIOUS, "印星", "辅佐、稳重、贵人"),
TIANLIANG("天梁", 12, StarNature.NEUTRAL, "荫星", "恩泽、稳重、长辈"),
QISHA("七杀", 13, StarNature.INAUSPICIOUS, "将星", "威猛、果断、开创"),
POJUN("破军", 14, StarNature.INAUSPICIOUS, "耗星", "破旧立新、变动、消耗");
private final String name;
private final int index;
private final StarNature nature;
private final String alias;
private final String description;
MajorStar(String name, int index, StarNature nature, String alias, String description) {
this.name = name;
this.index = index;
this.nature = nature;
this.alias = alias;
this.description = description;
}
public String getName() {
return name;
}
public int getIndex() {
return index;
}
public StarNature getNature() {
return nature;
}
public String getAlias() {
return alias;
}
public String getDescription() {
return description;
}
}
问题：
- 包含了辅星（天魁、天钺、禄存）
- 缺少天府星
- 主星数量不正确（应该是 14 颗）
1.2.2 MinorStar 枚举问题
public enum MinorStar {
WENCHANG("文昌"),
WENQU("文曲"),
LUCHUN("禄存"), // 重复：禄存在MajorStar中也存在
QINGYANG("擎羊"),
// ...
}
问题：
- 与 MajorStar 重复（禄存）
- 缺少很多重要的辅星
- 分类不清晰（六吉星、六煞星、其他辅星）
二、数据模型优化方案
2.1 优化目标
- 完整性：包含紫微斗数所有核心要素
- 准确性：正确区分主星和辅星
- 扩展性：支持大限、流年、流月、流日、流时
- 类型安全：使用强类型而非 String
- 可计算性：支持三方四正、星曜格局等计算
- 可持久化：支持数据库存储和查询
2.2 优化策略
2.2.1 分层设计
┌─────────────────────────────────────┐
│ ZiweiChart（命盘） │
│ ├─ BirthInfo（出生信息） │
│ ├─ TrueSolarTime（真太阳时） │
│ ├─ PalaceList（宫位列表） │
│ ├─ MajorLimitList（大限列表） │
│ ├─ CurrentYear（流年） │
│ ├─ CurrentMonth（流月） │
│ ├─ CurrentDay（流日） │
│ └─ StarPatternList（星曜格局） │
└─────────────────────────────────────┘
2.2.2 宫位扩展
┌─────────────────────────────────────┐
│ Palace（宫位） │
│ ├─ PalaceType（宫位类型） │
│ ├─ EarthlyBranch（地支） │
│ ├─ HeavenlyStem（天干） │
│ ├─ MajorStarList（主星列表） │
│ ├─ MinorStarList（辅星列表） │
│ ├─ TransformationList（四化列表） │
│ ├─ ThreeSidesFourDirections（三方四正）│
│ ├─ PalaceFortune（宫位运势） │
│ └─ PalaceScore（宫位评分） │
└─────────────────────────────────────┘
2.2.3 星星扩展
┌─────────────────────────────────────┐
│ StarInfo（星星信息） │
│ ├─ StarType（星星类型） │
│ ├─ StarNature（星性） │
│ ├─ StarBrightness（亮度） │
│ ├─ StarTransformation（四化） │
│ ├─ StarPalace（所在宫位） │
│ ├─ StarDescription（描述） │
│ └─ StarInteraction（相互作用） │
└─────────────────────────────────────┘
三、核心数据结构设计
3.1 命盘数据结构（ZiweiChart）
public class ZiweiChart {
private BirthInfo birthInfo;
private TrueSolarTime trueSolarTime;
private List<Palace> palaces;
private List<Palace> majorLimits;
private Palace currentYear;
private Palace currentMonth;
private Palace currentDay;
private Palace currentHour;
private List<StarPattern> starPatterns;
private HeavenlyStem yearStem;
private EarthlyBranch mingGongBranch;
private EarthlyBranch shenGongBranch;
private String summary;
private String overallLuck;
private int overallScore;
}
3.2 宫位数据结构（Palace）
public class Palace {
private PalaceType palaceType;
private EarthlyBranch earthlyBranch;
private HeavenlyStem heavenlyStem;
private List<MajorStarInfo> majorStars;
private List<MinorStarInfo> minorStars;
private List<Transformation> transformations;
private ThreeSidesFourDirections threeSidesFourDirections;
private PalaceFortune fortune;
private int score;
private String analysis;
}
3.3 主星信息结构（MajorStarInfo）
public class MajorStarInfo {
private MajorStar star;
private StarNature nature;
private StarBrightness brightness;
private Transformation transformation;
private Palace palace;
private String description;
private int influenceScore;
}
3.4 辅星信息结构（MinorStarInfo）
public class MinorStarInfo {
private MinorStar star;
private StarNature nature;
private StarBrightness brightness;
private Palace palace;
private String description;
private int influenceScore;
}
3.5 四化信息结构（Transformation）
public class Transformation {
private HeavenlyStem stem;
private MajorStar star;
private TransformationType type;
private Palace palace;
private String effect;
}
3.6 三方四正结构（ThreeSidesFourDirections）
public class ThreeSidesFourDirections {
private Palace mainPalace;
private Palace oppositePalace;
private Palace leftPalace;
private Palace rightPalace;
private List<Palace> allPalaces;
}
3.7 星曜格局结构（StarPattern）
public class StarPattern {
private String patternName;
private List<MajorStar> stars;
private List<Palace> palaces;
private String description;
private String effect;
private int patternScore;
}
3.8 宫位运势结构（PalaceFortune）
public class PalaceFortune {
private PalaceType palaceType;
private int score;
private String luckLevel;
private String analysis;
private String advice;
private String luckyColor;
private String luckyDirection;
private String luckyNumber;
}
3.9 真太阳时结构（TrueSolarTime）
public class TrueSolarTime {
private LocalTime beijingTime;
private double longitude;
private LocalTime trueSolarTime;
private String shichen;
private int timeDiffMinutes;
}
3.10 大限结构（MajorLimit）
public static class MajorLimit {
private int limitNumber; // 大限序号（1-12）
private EarthlyBranch branch; // 大限地支
private int startAge; // 起始年龄
private int endAge; // 结束年龄
private Palace palace; // 对应宫位
private String luckDescription; // 运势描述
public MajorLimit(int limitNumber, EarthlyBranch branch,
int startAge, int endAge) {
this.limitNumber = limitNumber;
this.branch = branch;
this.startAge = startAge;
this.endAge = endAge;
}
public boolean isAgeInRange(int age) {
return age >= startAge && age <= endAge;
}
}
3.11 流年结构（CurrentYear）
public static class CurrentYear {
private int year; // 年份
private EarthlyBranch branch; // 流年地支
private Palace mingGong; // 流年命宫
private String luckDescription; // 运势描述
public CurrentYear(int year, EarthlyBranch branch) {
this.year = year;
this.branch = branch;
}
}
四、枚举定义
4.1 主星枚举（MajorStar）
public enum MajorStar {
ZIWEI("紫微", 1, StarNature.AUSPICIOUS, "帝星", "领导、权威、尊贵"),
TIANJI("天机", 2, StarNature.AUSPICIOUS, "智星", "智慧、谋略、变通"),
TAIYANG("太阳", 3, StarNature.AUSPICIOUS, "贵星", "光明、热情、慷慨"),
WUQU("武曲", 4, StarNature.NEUTRAL, "财星", "刚毅、务实、财帛"),
TIANXING("天同", 5, StarNature.AUSPICIOUS, "福星", "温和、福气、享受"),
LIANCHEN("廉贞", 6, StarNature.INAUSPICIOUS, "情星", "感情、才华、是非"),
TIANFU("天府", 7, StarNature.AUSPICIOUS, "库星", "稳重、保守、财富"),
TAIYIN("太阴", 8, StarNature.NEUTRAL, "母星", "温柔、内敛、母性"),
TANLANG("贪狼", 9, StarNature.INAUSPICIOUS, "欲星", "欲望、魅力、桃花"),
JUMEN("巨门", 10, StarNature.INAUSPICIOUS, "口星", "口才、是非、沟通"),
TIANXIANG("天相", 11, StarNature.AUSPICIOUS, "印星", "辅佐、稳重、贵人"),
TIANLIANG("天梁", 12, StarNature.NEUTRAL, "荫星", "恩泽、稳重、长辈"),
QISHA("七杀", 13, StarNature.INAUSPICIOUS, "将星", "威猛、果断、开创"),
POJUN("破军", 14, StarNature.INAUSPICIOUS, "耗星", "破旧立新、变动、消耗");
private final String name;
private final int index;
private final StarNature nature;
private final String alias;
private final String description;
MajorStar(String name, int index, StarNature nature, String alias, String description) {
this.name = name;
this.index = index;
this.nature = nature;
this.alias = alias;
this.description = description;
}
public String getName() {
return name;
}
public int getIndex() {
return index;
}
public StarNature getNature() {
return nature;
}
public String getAlias() {
return alias;
}
public String getDescription() {
return description;
}
}
4.2 辅星枚举（MinorStar）
public enum MinorStar {
WENCHANG("文昌", MinorStarType.LUCKY, "文昌星", "主科名、文采、学业"),
WENQU("文曲", MinorStarType.LUCKY, "文曲星", "主口才、艺术、才华"),
ZUOFU("左辅", MinorStarType.LUCKY, "左辅星", "主辅佐、助力、贵人"),
YOUBI("右弼", MinorStarType.LUCKY, "右弼星", "主辅佐、助力、贵人"),
TIANKUI("天魁", MinorStarType.LUCKY, "天魁星", "主贵人、助力、机遇"),
TIANYUE("天钺", MinorStarType.LUCKY, "天钺星", "主贵人、助力、机遇"),
QINGYANG("擎羊", MinorStarType.EVIL, "羊刃星", "主刑伤、是非、血光"),
TUOLUO("陀罗", MinorStarType.EVIL, "陀罗星", "主拖延、迟滞、纠结"),
HUOXING("火星", MinorStarType.EVIL, "火星", "主急躁、突发、灾难"),
LINGXING("铃星", MinorStarType.EVIL, "铃星", "主突发、灾难、变动"),
DIKONG("地空", MinorStarType.EVIL, "地空星", "主空亡、损失、虚耗"),
DIJIE("地劫", MinorStarType.EVIL, "地劫星", "主劫夺、损失、破财"),
TIANMA("天马", MinorStarType.OTHER, "天马星", "主迁移、奔波、变动"),
TIANKU("天哭", MinorStarType.OTHER, "天哭星", "主悲伤、忧虑、情绪低落"),
TIANXU("天虚", MinorStarType.OTHER, "天虚星", "主虚耗、损失、空亡"),
LONGCHI("龙池", MinorStarType.OTHER, "龙池星", "主才华、艺术、文采"),
FENGGU("凤阁", MinorStarType.OTHER, "凤阁星", "主才华、艺术、文采"),
HONGLUAN("红鸾", MinorStarType.OTHER, "红鸾星", "主桃花、婚姻、感情"),
TIANXI("天喜", MinorStarType.OTHER, "天喜星", "主桃花、婚姻、感情"),
GUCHEN("孤辰", MinorStarType.OTHER, "孤辰星", "主孤独、寂寞、寡居"),
GUAKU("寡宿", MinorStarType.OTHER, "寡宿星", "主孤独、寂寞、寡居"),
FEILING("飞铃", MinorStarType.OTHER, "飞铃星", "主变动、奔波"),
BAIHU("白虎", MinorStarType.OTHER, "白虎星", "主凶险、血光"),
FEIXING("飞星", MinorStarType.OTHER, "飞星星", "主变动、奔波"),
LUCUN("禄存", MinorStarType.OTHER, "禄存星", "主财帛、福气");
private final String name;
private final MinorStarType type;
private final String alias;
private final String description;
MinorStar(String name, MinorStarType type, String alias, String description) {
this.name = name;
this.type = type;
this.alias = alias;
this.description = description;
}
public String getName() {
return name;
}
public MinorStarType getType() {
return type;
}
public String getAlias() {
return alias;
}
public String getDescription() {
return description;
}
}
4.3 辅星类型枚举（MinorStarType）
public enum MinorStarType {
LUCKY("吉星"),
EVIL("煞星"),
OTHER("其他");
private final String description;
MinorStarType(String description) {
this.description = description;
}
public String getDescription() {
return description;
}
}
4.4 星性枚举（StarNature）
public enum StarNature {
AUSPICIOUS("吉星"),
NEUTRAL("中性"),
INAUSPICIOUS("凶星");
private final String description;
StarNature(String description) {
this.description = description;
}
public String getDescription() {
return description;
}
}
4.5 星亮度枚举（StarBrightness）
public enum StarBrightness {
BRIGHT("庙", 100),
VERY_BRIGHT("旺", 90),
BRIGHT_MODERATE("得地", 80),
MODERATE("平和", 70),
DIM("陷", 60),
VERY_DIM("落陷", 50);
private final String name;
private final int score;
StarBrightness(String name, int score) {
this.name = name;
this.score = score;
}
public String getName() {
return name;
}
public int getScore() {
return score;
}
}
4.6 四化类型枚举（TransformationType）
public enum TransformationType {
LU("禄", "福气、钱财、好运、增幅"),
QUAN("权", "权力、竞争、强势、掌控"),
KE("科", "科名、名声、地位、才华"),
JI("忌", "波折、损失、是非");
private final String name;
private final String description;
TransformationType(String name, String description) {
this.name = name;
this.description = description;
}
public String getName() {
return name;
}
public String getDescription() {
return description;
}
}
4.7 四化星映射表
根据紫微斗数权威标准，天干四化映射关系如下：
| 天干 | 化禄 | 化权 | 化科 | 化忌 |
|---|---|---|---|---|
| 甲 | 廉贞 | 破军 | 武曲 | 太阳 |
| 乙 | 天机 | 天梁 | 紫微 | 太阴 |
| 丙 | 天同 | 天机 | 文昌 | 廉贞 |
| 丁 | 太阴 | 天同 | 天机 | 巨门 |
| 戊 | 贪狼 | 太阴 | 右弼 | 天机 |
| 己 | 武曲 | 贪狼 | 天梁 | 文曲 |
| 庚 | 太阳 | 武曲 | 太阴 | 天同 |
| 辛 | 巨门 | 太阳 | 文曲 | 天相 |
| 壬 | 天梁 | 紫微 | 武曲 | 破军 |
| 癸 | 破军 | 巨门 | 太阴 | 贪狼 |
四化星映射数据结构：
public class TransformationMapping {
private HeavenlyStem stem;
private MajorStar luStar;
private MajorStar quanStar;
private MajorStar keStar;
private MajorStar jiStar;
public TransformationMapping(HeavenlyStem stem, MajorStar luStar,
MajorStar quanStar, MajorStar keStar,
MajorStar jiStar) {
this.stem = stem;
this.luStar = luStar;
this.quanStar = quanStar;
this.keStar = keStar;
this.jiStar = jiStar;
}
public MajorStar getTransformationStar(TransformationType type) {
switch (type) {
case LU: return luStar;
case QUAN: return quanStar;
case KE: return keStar;
case JI: return jiStar;
default: return null;
}
}
}
四化星映射常量：
public class TransformationMappings {
public static final Map<HeavenlyStem, TransformationMapping> MAPPINGS;
static {
MAPPINGS = new HashMap<>();
MAPPINGS.put(HeavenlyStem.JIA, new TransformationMapping(
HeavenlyStem.JIA, MajorStar.LIANCHEN, MajorStar.POJUN,
MajorStar.WUQU, MajorStar.TAIYANG));
MAPPINGS.put(HeavenlyStem.YI, new TransformationMapping(
HeavenlyStem.YI, MajorStar.TIANJI, MajorStar.TIANLIANG,
MajorStar.ZIWEI, MajorStar.TAIYIN));
MAPPINGS.put(HeavenlyStem.BING, new TransformationMapping(
HeavenlyStem.BING, MajorStar.TIANXING, MajorStar.TIANJI,
MinorStar.WENCHANG, MajorStar.LIANCHEN));
MAPPINGS.put(HeavenlyStem.DING, new TransformationMapping(
HeavenlyStem.DING, MajorStar.TAIYIN, MajorStar.TIANXING,
MajorStar.TIANJI, MajorStar.JUMEN));
MAPPINGS.put(HeavenlyStem.WU, new TransformationMapping(
HeavenlyStem.WU, MajorStar.TANLANG, MajorStar.TAIYIN,
MinorStar.YOUBI, MajorStar.TIANJI));
MAPPINGS.put(HeavenlyStem.JI, new TransformationMapping(
HeavenlyStem.JI, MajorStar.WUQU, MajorStar.TANLANG,
MajorStar.TIANLIANG, MinorStar.WENQU));
MAPPINGS.put(HeavenlyStem.GENG, new TransformationMapping(
HeavenlyStem.GENG, MajorStar.TAIYANG, MajorStar.WUQU,
MajorStar.TAIYIN, MajorStar.TIANXING));
MAPPINGS.put(HeavenlyStem.XIN, new TransformationMapping(
HeavenlyStem.XIN, MajorStar.JUMEN, MajorStar.TAIYANG,
MinorStar.WENQU, MajorStar.TIANXIANG));
MAPPINGS.put(HeavenlyStem.REN, new TransformationMapping(
HeavenlyStem.REN, MajorStar.TIANLIANG, MajorStar.ZIWEI,
MajorStar.WUQU, MajorStar.POJUN));
MAPPINGS.put(HeavenlyStem.GUI, new TransformationMapping(
HeavenlyStem.GUI, MajorStar.POJUN, MajorStar.JUMEN,
MajorStar.TAIYIN, MajorStar.TANLANG));
}
public static TransformationMapping getMapping(HeavenlyStem stem) {
return MAPPINGS.get(stem);
}
}
五、数据模型实现
5.1 实现优先级
-
高优先级：
- 修正 MajorStar 枚举
- 修正 MinorStar 枚举
- 创建新的枚举类型
- 实现真太阳时计算
- 实现三方四正计算
-
中优先级：
- 扩展 Palace 类
- 扩展 StarInfo 类
- 实现星曜格局识别
- 实现大限流年计算
-
低优先级：
- 实现流月流日流时
- 实现星曜相互作用
- 实现高级分析功能
5.2 实现步骤
步骤1：修正枚举定义
├─ 修正MajorStar枚举
├─ 修正MinorStar枚举
├─ 创建MinorStarType枚举
└─ 创建StarBrightness枚举
步骤2：实现真太阳时计算
├─ 创建TrueSolarTime类
├─ 实现真太阳时计算方法
└─ 实现时辰确定方法
步骤3：扩展数据模型
├─ 扩展Palace类
├─ 扩展StarInfo类
├─ 创建MajorStarInfo类
├─ 创建MinorStarInfo类
└─ 创建Transformation类
步骤4：实现三方四正计算
├─ 创建ThreeSidesFourDirections类
├─ 实现三方四正计算方法
└─ 实现宫位关系查询
步骤5：实现星曜格局识别
├─ 创建StarPattern类
├─ 实现星曜格局识别方法
└─ 实现格局评分
步骤6：实现大限流年计算
├─ 实现大限计算方法
├─ 实现流年计算方法
└─ 实现流月流日流时计算
六、算法流程设计
6.1 排盘算法流程
┌─────────────────────────────────────┐
│ 1. 输入出生信息 │
│ ├─ 出生日期（公历） │
│ ├─ 出生时间 │
│ ├─ 出生地（经纬度） │
│ └─ 性别 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 2. 计算真太阳时 │
│ ├─ 获取出生地经度 │
│ ├─ 计算经度差 │
│ ├─ 转换为时间差 │
│ └─ 得到真太阳时 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 3. 确定命宫位置 │
│ ├─ 根据出生月、日、时计算 │
│ └─ 确定命宫地支 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 4. 安紫微星 │
│ ├─ 根据出生日、时查表 │
│ └─ 确定紫微星所在宫位 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 5. 安十四主星 │
│ ├─ 根据紫微星位置和安星口诀 │
│ └─ 安放其他十三颗主星 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 6. 安十二宫位 │
│ ├─ 从命宫开始 │
│ ├─ 逆时针方向排列十二宫 │
│ └─ 确定各宫位地支 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 7. 安辅星 │
│ ├─ 安六吉星 │
│ ├─ 安六煞星 │
│ └─ 安其他辅星 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 8. 定四化 │
│ ├─ 根据出生年天干 │
│ └─ 确定四化星及其位置 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 9. 计算三方四正 │
│ ├─ 计算每个宫位的三方四正 │
│ └─ 建立宫位关系 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 10. 识别星曜格局 │
│ ├─ 识别十四主星格局 │
│ ├─ 识别辅星格局 │
│ └─ 计算格局评分 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 11. 安大限 │
│ ├─ 根据命宫位置 │
│ ├─ 顺时针方向排列大限 │
│ └─ 确定各年龄段的大限宫位 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 12. 生成命盘 │
│ └─ 返回完整命盘 │
└─────────────────────────────────────┘
6.2 真太阳时计算流程
┌─────────────────────────────────────┐
│ 1. 输入北京时间 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 2. 输入出生地经度 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 3. 计算经度差 │
│ 经度差 = 当地经度 - 120° │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 4. 转换为时间差 │
│ 时间差 = 经度差 × 4分钟 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 5. 计算真太阳时 │
│ 真太阳时 = 北京时间 + 时间差 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 6. 确定时辰 │
│ 根据真太阳时确定时辰 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 7. 返回真太阳时信息 │
└─────────────────────────────────────┘
6.3 三方四正计算流程
┌─────────────────────────────────────┐
│ 1. 输入宫位 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 2. 确定对冲宫位 │
│ 对冲宫位 = (宫位序号 + 6) mod 12 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 3. 确定左隔二宫位 │
│ 左隔二宫位 = (宫位序号 + 4) mod 12│
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 4. 确定右隔二宫位 │
│ 右隔二宫位 = (宫位序号 + 8) mod 12│
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 5. 返回三方四正 │
└─────────────────────────────────────┘
6.4 星曜格局识别流程
┌─────────────────────────────────────┐
│ 1. 遍历所有宫位 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 2. 检查宫位主星组合 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 3. 检查三方四正主星组合 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 4. 匹配已知格局 │
│ ├─ 紫府同宫 │
│ ├─ 日月同宫 │
│ ├─ 机月同梁 │
│ ├─ 杀破狼 │
│ └─ 其他格局 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 5. 计算格局评分 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 6. 返回星曜格局 │
└─────────────────────────────────────┘
附录
A. 数据模型关系图
ZiweiChart
├─ BirthInfo
├─ TrueSolarTime
├─ List<Palace>
│ ├─ PalaceType
│ ├─ EarthlyBranch
│ ├─ HeavenlyStem
│ ├─ List<MajorStarInfo>
│ │ ├─ MajorStar
│ │ ├─ StarNature
│ │ ├─ StarBrightness
│ │ └─ Transformation
│ ├─ List<MinorStarInfo>
│ │ ├─ MinorStar
│ │ ├─ MinorStarType
│ │ └─ StarBrightness
│ ├─ List<Transformation>
│ ├─ ThreeSidesFourDirections
│ └─ PalaceFortune
├─ List<MajorLimit>
│ ├─ limitNumber
│ ├─ branch
│ ├─ startAge
│ ├─ endAge
│ ├─ palace
│ └─ luckDescription
├─ CurrentYear
│ ├─ year
│ ├─ branch
│ ├─ mingGong
│ └─ luckDescription
├─ Palace (CurrentMonth)
├─ Palace (CurrentDay)
├─ Palace (CurrentHour)
└─ List<StarPattern>
B. 术语对照表
| 中文 | 英文 | 说明 |
|---|---|---|
| 命盘 | Chart | 紫微斗数排盘结果 |
| 宫位 | Palace | 命盘中的十二宫 |
| 主星 | Major Star | 十四颗主星 |
| 辅星 | Minor Star | 辅助星曜 |
| 四化 | Transformation | 化禄、化权、化科、化忌 |
| 真太阳时 | True Solar Time | 以太阳位置为基准的时间 |
| 三方四正 | Three Sides Four Directions | 命盘分析的重要方法 |
| 星曜格局 | Star Pattern | 星曜组合形成的特殊格局 |
| 大限 | Major Limit | 十年运势周期 |
| 流年 | Current Year | 年度运势 |
文档版本：v1.0 最后更新：2025 年 12 月 29 日