136 lines
4.2 KiB
Markdown
136 lines
4.2 KiB
Markdown
# 📁 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日
|