# 稷下学宫AI辩论系统 - 项目结构

## 🏛️ 系统概述

**稷下学宫AI辩论系统**是一个融合中国传统文化与现代AI技术的智能辩论平台，以八仙论道为核心，通过记忆银行、ADK引擎和多智能体协作，实现深度投资分析与哲学思辨。

## 📁 目录结构

```
jixia_academy/
├── core/                           # 核心系统
│   ├── debate_system/             # 辩论系统引擎
│   │   ├── __init__.py
│   │   ├── main.py               # 系统主入口
│   │   ├── agents/               # AI智能体
│   │   │   ├── __init__.py
│   │   │   ├── memory_enhanced_agent.py
│   │   │   └── baxian/           # 八仙角色定义
│   │   │       ├── __init__.py
│   │   │       ├── tieguaili.py  # 铁拐李
│   │   │       ├── lvdongbin.py  # 吕洞宾
│   │   │       ├── hexianggu.py  # 何仙姑
│   │   │       ├── zhangguolao.py # 张果老
│   │   │       ├── lancaihe.py   # 蓝采和
│   │   │       ├── hanzhongli.py # 汉钟离
│   │   │       ├── hanxiangzi.py # 韩湘子
│   │   │       ├── caoguojiu.py  # 曹国舅
│   │   │       └── host.py       # 太上老君主持人
│   │   ├── debates/              # 辩论模式实现
│   │   │   ├── __init__.py
│   │   │   ├── adk_memory_debate.py
│   │   │   ├── adk_turn_based_debate.py
│   │   │   └── swarm_debate.py
│   │   └── memory/               # 记忆系统（已迁移至memory_bank）
│   │       └── (legacy files)
│   │
│   ├── memory_bank/              # 记忆银行系统
│   │   ├── __init__.py
│   │   ├── base_memory_bank.py
│   │   ├── cloudflare_memory_bank.py
│   │   ├── vertex_memory_bank.py
│   │   ├── factory.py
│   │   └── schemas/
│   │       ├── __init__.py
│   │       └── memory_models.py
│   │
│   └── ai_engine/                # AI引擎
│       ├── __init__.py
│       ├── adk_integration.py
│       ├── gemini_client.py
│       └── openai_client.py
│
├── agents/                       # 智能体系统
│   ├── baxian/                  # 八仙论道系统
│   │   ├── __init__.py
│   │   ├── baxian_coordinator.py
│   │   ├── debate_flow.py
│   │   └── character_profiles/
│   │       ├── tieguaili.json
│   │       ├── lvdongbin.json
│   │       └── ...
│   ├── host/                    # 主持人系统
│   │   ├── __init__.py
│   │   ├── taishanglaojun.py
│   │   └── debate_master.py
│   └── observers/               # 观察者和分析器
│       ├── __init__.py
│       ├── debate_analyzer.py
│       └── performance_tracker.py
│
├── integrations/               # 外部系统集成
│   ├── adk/                    # Google ADK集成
│   │   ├── __init__.py
│   │   ├── adk_client.py
│   │   └── adk_config.py
│   ├── openbb/                 # OpenBB金融数据集成
│   │   ├── __init__.py
│   │   ├── openbb_engine.py
│   │   ├── openbb_stock_data.py
│   │   └── providers/
│   ├── mongodb/                # MongoDB数据库集成
│   │   ├── __init__.py
│   │   ├── connection.py
│   │   ├── models.py
│   │   └── repositories/
│   └── cloudflare/             # Cloudflare Workers集成
│       ├── __init__.py
│       ├── kv_storage.py
│       └── worker_config.py
│
├── ui/                         # 用户界面
│   ├── web/                   # Web界面
│   │   ├── __init__.py
│   │   ├── index.html
│   │   ├── css/
│   │   ├── js/
│   │   └── assets/
│   ├── cli/                   # 命令行界面
│   │   ├── __init__.py
│   │   ├── cli.py
│   │   └── commands/
│   └── streamlit/             # Streamlit应用
│       ├── __init__.py
│       ├── streamlit_app.py
│       ├── components/
│       └── tabs/
│           ├── adk_debate_tab.py
│           ├── ai_collaboration_tab.py
│           ├── openbb_tab.py
│           └── tianxia_tab.py
│
├── config/                     # 配置管理
│   ├── __init__.py
│   ├── settings.py
│   ├── database.py
│   └── logging.py
│
├── data/                      # 数据存储
│   ├── models/               # 预训练模型
│   ├── debates/              # 辩论记录
│   ├── logs/                 # 系统日志
│   └── cache/                # 缓存数据
│
├── tests/                     # 测试套件
│   ├── __init__.py
│   ├── unit/
│   ├── integration/
│   └── e2e/
│
├── docs/                      # 文档系统
│   ├── api/                  # API文档
│   ├── user/                 # 用户指南
│   ├── architecture/         # 架构文档
│   └── examples/             # 使用示例
│
├── examples/                  # 示例代码
│   ├── debates/
│   │   ├── adk_debate_example.py
│   │   ├── baxian_adk_gemini_debate.py
│   │   └── swarm_debate_example.py
│   ├── integrations/
│   │   ├── openbb_integration_demo.py
│   │   └── memory_bank_demo.py
│   └── api_usage/
│       └── rest_api_example.py
│
├── scripts/                   # 部署和运维脚本
│   ├── install.sh
│   ├── setup.py
│   ├── start_debate.sh
│   └── deploy/
│
├── requirements.txt
├── pyproject.toml
├── README.md
└── LICENSE
```

## 🎯 核心模块说明

### 1. 辩论系统引擎 (core/debate_system/)
- **八仙论道**: 基于八卦理论的AI辩论系统
- **记忆增强辩论**: 集成记忆银行的智能辩论
- **轮流辩论**: ADK驱动的结构化辩论流程

### 2. 记忆银行系统 (core/memory_bank/)
- **Cloudflare KV**: 分布式键值存储
- **Vertex AI**: Google Cloud记忆管理
- **MongoDB**: 结构化数据存储
- **记忆工厂**: 统一记忆管理接口

### 3. 智能体系统 (agents/)
- **八仙角色**: 铁拐李、吕洞宾、何仙姑等8个AI角色
- **主持人**: 太上老君辩论主持
- **观察者**: 辩论分析和性能监控

### 4. 集成系统 (integrations/)
- **Google ADK**: 智能体开发套件
- **OpenBB**: 金融数据和分析
- **MongoDB**: 数据持久化
- **Cloudflare**: 边缘计算和存储

## 🚀 快速开始

```bash
# 安装依赖
pip install -r requirements.txt

# 启动八仙论道
python -m jixia_academy.core.main --mode baxian --topic "投资策略分析"

# 启动Streamlit界面
streamlit run jixia_academy/ui/streamlit/streamlit_app.py
```

## 📊 系统特色

- **文化传承**: 融合中国传统文化与现代AI
- **智能辩论**: 基于八卦理论的深度思辨
- **记忆增强**: 持续学习和知识积累
- **多模态交互**: CLI、Web、Streamlit多种界面
- **金融集成**: OpenBB专业金融数据分析