# 📂 文件及功能介绍 (2025年更新)

## 根目录

- **README.md**: 项目的概述和使用说明。
- **requirements.txt**: 项目所需的Python依赖包列表。
- **bot.py**: 主启动文件，负责环境配置加载和NoneBot初始化。
- **webui.py**: Web界面实现，提供图形化操作界面。
- **template.env**: 环境变量模板文件。
- **pyproject.toml**: Python项目配置文件。
- **docker-compose.yml** 和 **Dockerfile**: Docker配置文件，用于容器化部署。
- **run_*.bat**: 各种启动脚本，包括开发环境、WebUI和记忆可视化等功能。
- **EULA.md** 和 **PRIVACY.md**: 用户协议和隐私政策文件。
- **changelog.md**: 版本更新日志。

## `src/` 目录结构

- **`plugins/` 目录**: 存放不同功能模块的插件。
  - **chat/**: 处理聊天相关的功能。
  - **memory_system/**: 处理机器人的记忆系统。
  - **personality/**: 处理机器人的性格系统。
  - **willing/**: 管理机器人的意愿系统。
  - **models/**: 模型相关工具。
  - **schedule/**: 处理日程管理功能。
  - **moods/**: 情绪管理系统。
  - **zhishi/**: 知识库相关功能。
  - **remote/**: 远程控制功能。
  - **utils/**: 通用工具函数。
  - **config_reload/**: 配置热重载功能。

- **`gui/` 目录**: 存放图形用户界面相关的代码。

- **`common/` 目录**: 存放通用的工具和库。

- **`think_flow_demo/` 目录**: 思维流程演示相关代码。

## 新增特色功能

1. **WebUI系统**:
   - 提供图形化操作界面
   - 支持实时监控和控制
   - 可视化配置管理

2. **多模式启动支持**:
   - 开发环境（run_dev.bat）
   - 生产环境
   - WebUI模式（webui_conda.bat）
   - 记忆可视化（run_memory_vis.bat）

3. **增强的情感系统**:
   - 情绪管理（moods插件）
   - 性格系统（personality插件）
   - 意愿系统（willing插件）

4. **远程控制功能**:
   - 支持远程操作和监控
   - 分布式部署支持

5. **配置管理**:
   - 支持配置热重载
   - 多环境配置（dev/prod）
   - 自动配置更新检查

6. **安全和隐私**:
   - 用户协议（EULA）支持
   - 隐私政策遵守
   - 敏感信息保护

## 系统架构特点

1. **模块化设计**:
   - 插件系统支持动态加载
   - 功能模块独立封装
   - 高度可扩展性

2. **多层次AI交互**:
   - 记忆系统
   - 情感系统
   - 知识库集成
   - 意愿管理

3. **完善的开发支持**:
   - 开发环境配置
   - 代码规范检查
   - 自动化部署
   - Docker支持

4. **用户友好**:
   - 图形化界面
   - 多种启动方式
   - 配置自动化
   - 详细的文档支持