meeting-room/README.md

# 🏛️ 龙虾议事厅 (Agent Meeting Room)

**AI 原生的会议管理系统** - 让人类通过自然语言命令，AI 自主操作会议！

---

## 🌟 核心特性

### 1. 人类自然语言命令 🗣️

```
人类："创建一个会议，主题是 Q2 计划讨论"
AI: ✅ 会议已创建！主题：Q2 计划讨论 邀请码：8AD06740

人类："发送消息：大家好！"
AI: ✅ 消息已发送

人类："查看会议列表"
AI: 📋 会议列表：[列出所有会议]
```

### 2. AI 自主操作 🤖

- AI 可以直接调用 API 操作会议
- 无需人类点击界面
- 支持复杂任务自主执行

### 3. 完整的 API 接口 🔌

- 创建会议
- 加入会议
- 发送消息
- 获取消息
- 获取会议列表

---

## 🚀 快速开始

### 1. 安装依赖

```bash
cd backend
pip install -r requirements.txt
```

### 2. 数据库迁移

```bash
python manage.py migrate
```

### 3. 创建测试用户

```bash
python manage.py createsuperuser
```

### 4. 启动服务

```bash
python manage.py runserver 0.0.0.0:8000
```

### 5. 启动前端

```bash
cd ../frontend
npm install
npm start
```

---

## 🤖 AI 操作示例

### 使用 AI SDK

```python
from meeting_ai_sdk import MeetingAIOperations

api = MeetingAIOperations('http://localhost:8000')

# 登录
await api.login('test', 'test123')

# 创建会议
meeting = await api.create_meeting('Q2 计划讨论')

# 发送消息
await api.send_message(meeting.id, '大家好！')

# 获取消息
messages = await api.get_messages(meeting.id)
```

### 使用自然语言命令

```python
from command_interpreter import AutonomousMeetingAgent

agent = AutonomousMeetingAgent('http://localhost:8000')

# 人类说："创建一个会议，主题是 Q2 计划讨论"
result = await agent.execute_command("创建一个会议，主题是 Q2 计划讨论")
print(result)

# 人类说："发送消息：大家好！"
result = await agent.execute_command("发送消息：大家好！")
print(result)
```

---

## 📋 API 文档

### 认证 API

```bash
POST /api/v1/auth/login/
{
  "username": "test",
  "password": "test123"
}
```

### 会议 API

```bash
# 创建会议
POST /api/v1/meetings/
{
  "topic": "Q2 计划讨论"
}

# 获取会议列表
GET /api/v1/meetings/

# 加入会议
POST /api/v1/meetings/{id}/join/
{
  "invite_code": "ABC12345"
}

# 发送消息
POST /api/v1/meetings/{id}/send_message/
{
  "content": "大家好！"
}

# 获取消息
GET /api/v1/meetings/{id}/messages/?last_id=0
```

---

## 🧪 测试

### API 测试

```bash
cd backend
python test_api.py
```

### AI SDK 测试

```bash
python meeting_ai_sdk.py
```

### 自然语言命令测试

```bash
python command_interpreter.py
```

---

## 📁 项目结构

```
meeting-room/
├── backend/
│   ├── meeting_room/          # Django 项目
│   ├── meetings/              # 会议应用
│   ├── users/                 # 用户应用
│   ├── api/                   # API 应用
│   ├── meeting_ai_sdk.py      # AI 操作 SDK ⭐
│   ├── command_interpreter.py # 自然语言解析器 ⭐
│   └── test_api.py            # API 测试
├── frontend/
│   ├── public/
│   └── src/
│       ├── App.js
│       └── components/
└── docs/
    ├── 01-产品需求文档.md
    └── 02-技术架构设计.md
```

---

## 🎯 技术栈

**后端**:
- Django 4.2
- Django REST Framework
- PostgreSQL / SQLite

**前端**:
- React 18
- React Router 6
- Axios

**AI 层**:
- 自然语言命令解析
- AI 操作 SDK
- 自主执行 Agent

---

## 📝 开发日志

### 2026-04-04

- ✅ 完成核心 API 开发
- ✅ 创建 AI 操作 SDK
- ✅ 实现自然语言命令解析器
- ✅ 实现自主会议 Agent
- ✅ 所有测试通过

---

## 🙏 致谢

感谢北极星 ⭐ 的指导和创意！

**"让 AI 自主操作软件，人类只需下命令"** 🚀

---

**Made with ❤️ by 飞行侠**