# 炼妖壶项目结构与核心模块概览

## 项目核心理念
炼妖壶项目（Lianyaohu）是一个融合中国传统文化与现代AI技术的投资分析系统。其核心理念是：
- 利用八仙、龙子等神话角色作为AI智能体，进行多维度的市场分析
- 通过"差序格局"、"十二长生"等传统哲学思想构建市场模型
- 结合现代技术（如FSM状态机、图数据库）实现智能化决策支持

## 核心模块介绍

### 1. 天体图谱 (Celestial Map) - `celestial_map.py`
基于费孝通的"差序格局"理论，构建产业链影响力的图模型：
- 恒星 (Star): 产业链核心/上游公司
- 行星 (Planet): 紧密关联的中游公司  
- 卫星 (Satellite): 下游或关联度较弱的公司
- 引力 (Gravity): 公司间的影响强度，通过NetworkX图结构建模

### 2. 市场状态机 (Market FSM) - `market_fsm.py`
一个简化的市场分析有限状态机，演示如何通过抽象基类调用外部引擎：
- 核心状态：Idle → Collecting → CycleAnalysis → Reporting → Idle
- 通过注入神话引擎和周期模型实现解耦

### 3. 神话引擎 (Mythology Engine) - `mythology.py`
将技术组件映射到神话角色的抽象接口：
- 抽象基类`MythologyEngine`定义统一接口
- `DaoistMythologyEngine`实现道家神话映射（如太上老君、灵宝道君等）

### 4. 周期模型 (Cycle Model) - `cycle_models.py`
描述市场或个股生命周期的抽象模型：
- 抽象基类`CycleModel`定义统一接口
- `TwelveStagesOfLifeCycleModel`实现"十二长生"周期模型

### 5. 妖股扫描器 (Monster Stock Scanner) - `monster_stock_scanner.py`
基于"龙生九子"概念的个股分析工具：
- `Dragon`抽象基类定义龙子接口
- `Bixi`(赑屃)负责分析宏观结构性压力（天时）
- `Fuxi`(负屃)负责计算个股主题挤压分数（地利）
- 结合"天时地利人和"识别潜在妖股

## 项目架构特色
1. **文化驱动设计**：所有模块都深度融入中国传统文化元素
2. **高度解耦**：通过抽象基类实现核心逻辑与具体实现的分离
3. **可扩展性强**：可以轻松添加新的神话体系或周期模型
4. **清晰的职责划分**：每个模块都有明确的功能定位