liurenchaxin/internal/README.md

📁 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日