README_APP.md

Human-Clone System

Human-Clone 系统是一个多主体通讯协作平台，支持 human 和 clone 之间的实时异步通讯。

快速开始

环境要求

• Python 3.9+
• Redis 服务器

安装依赖

pip install -r requirements.txt

启动方式

1. 直接启动（推荐）

uvicorn src.main:app --reload --host 0.0.0.0 --port 7860

2. 使用脚本启动

python scripts/start_dev.py

3. 开发模式

uvicorn src.main:app --reload --debug --port 7860

API 文档

启动后访问：

• Swagger UI: http://localhost:7860/docs
• ReDoc: http://localhost:7860/redoc

项目结构

├── src/                    # 源代码目录
│   ├── core/              # 核心功能模块
│   ├── config/            # 配置管理
│   ├── api/               # API路由
│   └── utils/             # 工具函数
├── tests/                 # 测试代码
├── scripts/               # 启动脚本
└── docs/                  # 项目文档

核心功能

• 多主体（human/clone）实时通讯
• 基于 Redis 的异步消息传递
• 支持点对点消息发送
• 完全解耦的发送/接收队列机制

开发指南

详见 docs/development-workflow.md