### 核心定位：飞星系统的可视化与深度解读

### 功能模块：

1. **九宫飞星可视化**（核心）
   - 四层飞星切换（年/月/日/时）
   - 飞星流转动画
   - 能量热力图
   - 宫位点击详情

2. **飞星深度解读**
   - 飞星组合解读
   - 流转规律分析
   - 九宫格局识别

3. **飞星实用工具**
   - 飞星速查
   - 飞星对照表
   - 本命飞星（已确认保留）

4. **系统关联**
   - 跳转到时辰工具
   - 跳转到风水工具
   - 跳转到奇门工具

5. **知识库**
   - 飞星基础知识
   - 常见问题
   - 实例分析

 

## 📋 九宫优化方案 - 实施计划

### 🎯 目标
将九宫打造成**飞星系统的可视化与深度解读工具**，与现有工具形成差异化互补。

---

## 🏗️ 功能模块设计

### 模块1：九宫飞星可视化（核心增强）

#### 1.1 四层飞星切换优化
```
当前：只能切换查看单层
优化：支持多层叠加显示

功能：
- Tab切换：先天九宫 / 年飞星 / 月飞星 / 日飞星 / 时飞星
- 多层叠加：同时显示2-4层飞星（用透明度区分）
- 自动流转：按时间顺序自动播放飞星流转动画
```

#### 1.2 宫位交互优化
```
当前：只能显示基础信息
优化：点击宫位弹出详细解读

功能：
- 点击宫位 → 弹窗显示该宫位的完整信息：
  - 飞星名称及含义
  - 当前层所有飞星
  - 飞星组合解读
  - 吉凶评级
  - 化解建议
  - 与其他工具的关联（时辰/风水/奇门）
```

#### 1.3 能量热力图
```
功能：
- 根据飞星组合计算每个宫位的能量值（-100到+100）
- 正值表示吉，负值表示凶
- 用颜色深浅表示强度：
  - 深红 = 大凶
  - 浅红 = 凶
  - 灰色 = 平
  - 浅绿 = 吉
  - 深绿 = 大吉
```

#### 1.4 飞星流转动画
```
功能：
- 显示飞星在九宫中的移动轨迹
- 动画速度可调（慢/中/快）
- 支持暂停/播放
- 显示当前时间点
```

---

### 模块2：飞星深度解读（新增）

#### 2.1 飞星组合解读
```
功能：
- 自动识别当前九宫中的所有飞星组合
- 判断组合的生克关系：
  - 相生组合（火生土、土生金...）
  - 相克组合（水克火、火克金...）
  - 相同组合（土+土、火+火...）
- 提供组合解读文案
- 显示组合的吉凶评级
```

#### 2.2 流转规律分析
```
功能：
- 展示飞星在过去、现在、未来的位置
- 预测下一个时辰/日的飞星分布
- 识别特殊节点：
  - 五黄入中（大凶）
  - 八白入中（大吉）
  - 合十格局
  - 连珠格局
```

#### 2.3 九宫格局识别
```
功能：
- 自动识别特殊格局：
  - 合十格局（1+9、2+8、3+7、4+6）
  - 连珠三格（如1-2-3、7-8-9）
  - 伏吟格局
  - 反吟格局
- 提供格局含义解读
- 显示格局的吉凶程度
```

---

### 模块3：飞星实用工具（新增）

#### 3.1 飞星速查
```
功能：
- 日期选择器：选择任意日期
- 快速显示该日期的：
  - 年飞星
  - 月飞星
  - 日飞星
  - 当前时辰飞星
- 一键返回今日
```

#### 3.2 飞星对照表
```
功能：
- 九星详解表（点击星名显示详情）
- 八门详解表
- 八神详解表
- 特殊组合速查表
- 可搜索、可筛选
```

#### 3.3 个人本命飞星（保留）
```
功能：
- 输入出生日期
- 计算本命飞星（命宫星）
- 显示本命星属性：
  - 星名、五行
  - 性格特质
  - 运势倾向
- 显示本命星在不同年份的流转
- 提供本命星的化解建议
```

---

### 模块4：系统关联（新增）

#### 4.1 与时辰工具关联
```
功能：
- 九宫中显示"查看时辰详情"按钮
- 点击跳转到时辰工具
- 带上日期参数，直接显示该时辰详情
```

#### 4.2 与风水工具关联
```
功能：
- 九宫中显示"查看风水布局"按钮
- 点击跳转到风水工具
- 带上飞星数据，风水工具参考飞星布局
```

#### 4.3 与奇门工具关联
```
功能：
- 九宫中显示"查看奇门预测"按钮
- 点击跳转到奇门工具
- 带上时间参数，直接显示该时间的奇门布局
```

---

### 模块5：知识库（新增）

#### 5.1 飞星基础知识
```
内容：
- 什么是九宫飞星
- 九星详解
- 八门详解
- 八神详解
- 飞星的流转规律
```

#### 5.2 常见问题
```
内容：
- 如何解读飞星？
- 飞星与八字的关系？
- 飞星与风水的关系？
- 如何化解凶星？
- ...
```

#### 5.3 实例分析
```
内容：
- 真实案例
- 案例解读
- 理论讲解
```

---

## 🛠️ 技术实现方案

### 需要的API接口

#### 1. 九宫布局计算API（可能已有）
```typescript
GET /api/nine-palaces/analysis?date=2026-03-25&hour=14
```

#### 2. 飞星组合解读API（新增）
```typescript
POST /api/nine-palaces/combinations
Body: { stars: [1, 2, 3, 4, 5, 6, 7, 8, 9] }
Response: {
  combinations: [
    {
      stars: [1, 9],
      relation: '相克',
      meaning: '水火相克，冲突对立',
      luck: '凶',
      advice: '避免重大决策'
    }
  ]
}
```

#### 3. 格局识别API（新增）
```typescript
POST /api/nine-palaces/patterns
Body: { layout: [4, 9, 2, 3, 5, 7, 8, 1, 6] }
Response: {
  patterns: [
    {
      name: '合十格局',
      positions: [4, 6],
      meaning: '天地合德，大吉大利',
      luck: '大吉'
    }
  ]
}
```

#### 4. 本命飞星计算API（新增）
```typescript
POST /api/nine-palaces/birth-star
Body: { birthDate: '1990-05-15', birthHour: 10 }
Response: {
  lifePalaceStar: 8,
  starInfo: {
    name: '八白左辅',
    element: '土',
    meaning: '正财贵人',
    personality: ['稳重', '务实', '有财运'],
    advice: '适合从事财务、管理类工作'
  }
}
```

### 前端技术要点

#### 1. 飞星流转动画
```typescript
// 使用 requestAnimationFrame 实现平滑动画
// 计算每个飞星在时间轴上的位置
// 使用 CSS transform 进行移动
```

#### 2. 能量热力图
```typescript
// 根据飞星组合计算能量值
// 使用 Canvas 或 SVG 绘制热力图
// 颜色渐变映射
```

#### 3. 宫位详情弹窗
```typescript
// 使用 shadcn/ui 的 Dialog 组件
// 动态加载内容
// 支持手势关闭（移动端）
```

---

## 📅 实施优先级

### 阶段1：核心优化（1-2天）
1. ✅ 四层飞星切换优化
2. ✅ 宫位交互优化（点击详情）
3. ✅ 飞星速查功能
4. ✅ 与其他工具的关联跳转

### 阶段2：深度解读（2-3天）
1. ✅ 飞星组合解读
2. ✅ 流转规律分析
3. ✅ 九宫格局识别
4. ✅ 能量热力图

### 阶段3：实用工具（1-2天）
1. ✅ 飞星对照表
2. ✅ 个人本命飞星
3. ✅ 飞星流转动画

### 阶段4：知识库（1天）
1. ✅ 飞星基础知识
2. ✅ 常见问题
3. ✅ 实例分析

**总计：5-8天**

---