# 孢子殖民地项目 - 清理后结构

## 🎯 根目录（极简版）

```
孢子殖民地/
├── README.md              # 项目核心介绍
├── LICENSE                # 开源许可证
├── main.py               # 主程序入口
├── ai_collaboration_demo.py  # AI协作演示
├── install.sh            # 一键安装脚本
├── requirements.txt      # Python依赖

├── pytest.ini          # 测试配置
├── .gitignore          # Git忽略规则
├── .gitguardian.yaml   # 安全配置
├── agents/             # AI代理身份系统（核心）
├── src/               # 核心协作系统源码
├── app/               # Streamlit应用
├── demo_feature/      # 演示功能
├── design/            # 设计文档
├── docs/              # 项目文档
├── examples/          # 使用示例
├── outputs/           # 输出结果
├── tests/             # 测试文件
├── tools/             # 工具脚本
├── website/           # 项目网站
└── modules/           # 模块化组件
    ├── agent-identity/     # AI代理身份模块
    ├── core-collaboration/ # 核心协作模块
    ├── monitoring-dashboard/ # 监控面板模块
    ├── documentation-suite/ # 文档套件模块
    ├── testing-framework/  # 测试框架模块
    ├── devops-tools/      # DevOps工具模块
    └── legacy-support/    # 历史支持文件
```

## 📁 核心目录说明

### 🎯 根目录保留文件
- **main.py**: 项目主入口，启动AI协作系统
- **ai_collaboration_demo.py**: AI协作演示脚本
- **install.sh**: 一键安装所有依赖和环境
- **requirements.txt**: Python依赖清单


### 🏗️ 核心系统目录
- **agents/**: AI代理身份管理系统
- **src/**: 核心协作系统源代码
- **app/**: Streamlit Web应用界面
- **tests/**: 单元测试和集成测试
- **tools/**: 开发工具和实用脚本

### 📊 项目资产目录
- **docs/**: 项目文档和使用指南
- **examples/**: 使用示例和演示案例
- **design/**: 系统架构和设计文档
- **outputs/**: 运行输出和结果存储
- **website/**: 项目展示网站

### 🧩 模块化组件（modules/）
所有复杂功能和历史文件已迁移到modules目录：
- **legacy-support/**: 历史文件、报告、临时文件
- **其他5个模块**: 之前创建的模块化组件

## 🚀 快速开始

```bash
# 1. 克隆项目
git clone [项目地址]
cd 孢子殖民地

# 2. 一键安装
./install.sh

# 3. 启动项目
python main.py

# 4. 访问Web界面
streamlit run app/streamlit_app.py
```

## 🎯 设计哲学

**极简根目录**：只保留最核心、最常用的文件
**模块化组织**：复杂功能全部封装到modules目录
**清晰边界**：核心系统与辅助工具完全分离
**易于导航**：3秒内找到任何文件

现在项目根目录从30+个文件减少到17个，清爽多了！ 🎉