liurenchaxin/docs/architecture/PROJECT_SUMMARY.md

44 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 炼妖壶项目结构与核心模块概览
## 项目核心理念
炼妖壶项目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. **清晰的职责划分**:每个模块都有明确的功能定位