# 📁 Internal 文件夹整理说明

## 🗂️ 文件夹结构

```
internal/
├── README.md                           # 本文件 - 索引说明
├── 📋 core/                            # 核心系统文档
│   ├── baxian_sanqing_system_guide.md  # 八仙三清系统指南
│   ├── fsm.md                          # 有限状态机设计
│   └── fsm_analysis.md                 # FSM分析文档
├── 🚀 development/                     # 开发计划和执行
│   ├── comprehensive_development_plan.md # 综合开发计划
│   ├── comprehensive_plan.md           # 简化版开发计划
│   └── execution_plan_v2.0.0.md        # v2.0.0 执行计划
├── 🔧 technical/                       # 技术实现文档
│   ├── liao.md                         # OSPF路由架构
│   ├── api_scheduling_strategy.md      # API调度策略
│   ├── rapidapi_yahoo_finance_guide.md # RapidAPI指南
│   ├── Xiantian_Bagua_Debate_System_Design.md # 先天八卦辩论系统
│   ├── Final_Baxian_Sanqing_Model_Configuration.md # 八仙三清模型配置
│   └── [其他技术文档...]
├── 🎭 strategies/                      # 策略和规划
│   └── platform_avatar_strategy.md     # 平台虚拟偶像策略
├── 📊 analysis/                        # 分析和研究
│   ├── kag_ecosystem_analysis.md       # KAG生态位分析
│   ├── Cognitive_Computing_Models_Deep_Analysis.md # 认知计算分析
│   ├── Mistral_Cognitive_Architecture_Analysis.md # Mistral认知架构
│   └── [其他分析文档...]
├── 🔄 migration/                       # 迁移和升级
│   ├── rfc_taigong_xinyi_fsm_enhancements.md # FSM增强方案
│   └── comprehensive_cleanup_summary.md # 清理总结
├── 📚 archive/                         # 归档文档
│   ├── deprecated_plans/               # 废弃计划
│   └── historical_analysis/            # 历史分析
├── 📁 docs/                            # 文档目录
├── 📁 setup/                           # 设置文档
└── 📁 mcp/                             # MCP相关文档
```

## 📋 文档分类说明

### **📋 Core (核心系统文档)**
- 系统架构总览
- 八仙三清系统指南
- 有限状态机设计

### **🚀 Development (开发计划和执行)**
- 开发路线图
- 执行计划
- 综合开发计划

### **🔧 Technical (技术实现文档)**
- OSPF路由架构
- Memory Bank系统
- 优先级算法
- API调度策略

### **🎭 Strategies (策略和规划)**
- 平台虚拟偶像策略
- 辩论系统策略
- 预测系统策略

### **📊 Analysis (分析和研究)**
- KAG生态位分析
- 认知计算分析
- 市场分析

### **🔄 Migration (迁移和升级)**
- Google ADK迁移
- FSM增强方案
- 清理总结

### **📚 Archive (归档文档)**
- 旧文档
- 废弃计划
- 历史分析

## 🔄 迁移计划

### **第一阶段：创建新结构**
1. 创建新的文件夹结构
2. 移动核心文档到 core/
3. 移动开发计划到 development/

### **第二阶段：整理技术文档**
1. 移动技术文档到 technical/
2. 移动策略文档到 strategies/
3. 移动分析文档到 analysis/

### **第三阶段：迁移和归档**
1. 移动迁移文档到 migration/
2. 归档旧文档到 archive/
3. 更新所有文档的引用链接

### **第四阶段：清理和优化**
1. 删除重复文件
2. 统一命名规范
3. 更新索引和引用

## 📝 命名规范

### **文件命名规则**
- 使用小写字母和下划线
- 使用描述性名称
- 包含版本号（如适用）
- 使用英文命名

### **示例**
```
✅ 正确命名：
- system_architecture.md
- baxian_sanqing_guide.md
- roadmap_v2.0.0.md
- ospf_routing_architecture.md

❌ 错误命名：
- SystemArchitecture.md
- baxian-sanqing-guide.md
- roadmap.md
- OSPF_Routing_Architecture.md
```

## 🎯 整理目标

1. **提高可读性**：清晰的文件夹结构
2. **便于维护**：分类明确的文档组织
3. **减少重复**：消除重复和冗余文件
4. **统一标准**：一致的命名和格式规范
5. **便于查找**：快速定位所需文档

---

**整理状态**：✅ 已完成  
**最后更新**：2025年8月13日
