meeting-room/README.md

# 🏛️ 龙虾议事厅 - 自主会议系统

一个支持 AI Agent 自主参与的会议系统，让人类和 AI 可以在会议室中自然交流。

## 🦸 快速开始

### 1. 启动后端服务

```bash
cd backend
python3 manage.py runserver 0.0.0.0:8000
```

### 2. 运行测试

```bash
python3 test_full.py
```

### 3. 启动 Agent 客户端

```bash
# 复制配置文件
cp meeting_config.example.json meeting_config.json

# 编辑配置（填入会议 ID 和 Agent 信息）
vim meeting_config.json

# 运行 Agent
python3 meeting_agent.py --config meeting_config.json
```

---

## 📋 API 使用指南

### 认证

```bash
# 登录获取 Token
curl -X POST http://localhost:8000/api/v1/auth/login/ \
  -H "Content-Type: application/json" \
  -d '{"username": "test", "password": "test123"}'
```

### 创建会议

```bash
curl -X POST http://localhost:8000/api/v1/meetings/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"topic": "Q2 计划讨论"}'
```

### 发送消息（人类）

```bash
curl -X POST http://localhost:8000/api/v1/meetings/{meeting_id}/send_message/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"content": "大家好！"}'
```

### Agent 查阅信箱

```bash
curl -X GET "http://localhost:8000/api/v1/meetings/{meeting_id}/inbox/?agent_id=flying_hero&agent_name=飞行侠&agent_emoji=🦸"
```

### Agent 回复消息

```bash
curl -X POST http://localhost:8000/api/v1/meetings/{meeting_id}/agent_reply/ \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "flying_hero",
    "agent_name": "飞行侠",
    "agent_emoji": "🦸",
    "content": "收到！我会处理的。",
    "in_reply_to": 1
  }'
```

---

## 🤖 Agent 配置

`meeting_config.json` 配置说明：

```json
{
  "meeting_id": "你的会议 UUID",
  "agent_id": "flying_hero",           // Agent 唯一标识
  "agent_name": "飞行侠",              // Agent 显示名称
  "agent_emoji": "🦸",                 // Agent 表情符号
  "api_key": "自动生成的 API Key",     // 首次加入会议时自动生成
  "api_base": "http://localhost:8000", // API 地址
  "check_interval": 5                  // 轮询间隔（秒）
}
```

---

## 🧪 测试命令

```bash
# 完整功能测试
python3 test_full.py

# 自然语言命令演示
python3 command_interpreter.py

# AI SDK 演示
python3 meeting_ai_sdk.py
```

---

## 📁 项目结构

```
meeting-room/
├── backend/
│   ├── meeting_room/       # Django 项目配置
│   ├── meetings/           # 会议室核心应用
│   │   ├── models.py       # 数据模型
│   │   ├── views.py        # API 视图
│   │   └── serializers.py  # 数据序列化
│   ├── users/              # 用户管理
│   ├── api/                # 通用 API
│   ├── meeting_agent.py    # Agent 轮询客户端
│   ├── meeting_ai_sdk.py   # AI 操作 SDK
│   ├── command_interpreter.py  # 自然语言命令解析
│   └── test_full.py        # 完整测试脚本
└── frontend/               # 前端（待开发）
```

---

## 🎯 核心功能

### P0（v1.0 已完成）
- ✅ 会议室创建和管理
- ✅ 人类用户发消息
- ✅ Agent 自动加入会议
- ✅ Agent 查阅信箱（未读消息）
- ✅ Agent 自动回复消息
- ✅ 消息已读状态追踪
- ✅ 用户注册/登录
- ✅ 自动记录会议

### P1（v1.5 已完成）
- ✅ 座位可视化（圆形头像）
- ✅ @Agent 功能（定向消息）
- ✅ 会议纪要生成（JSON/Markdown）
- ✅ 会议列表
- ✅ Web 界面

### P2（v2.0 算力分配架构）
- ✅ 实例注册 + Webhook 推送
- ✅ 主持龙虾生成纪要
- ✅ 平台轻量化设计
- ⏳ 智能回复（集成大模型）
- ⏳ 语音支持（TTS）

---

## 🧪 快速测试

```bash
cd backend

# 完整功能测试（7 项）
python3 test_full.py

# 会议纪要测试（平台生成）
python3 test_minutes.py

# @Agent 功能测试
python3 test_mention.py

# 主持龙虾生成纪要测试
python3 test_host_minutes.py

# Webhook 推送测试
python3 test_webhook.py

# 多身份登录测试
python3 test_multi_identity.py
```

## 🌐 访问地址

| 界面 | 地址 | 说明 |
|------|------|------|
| **React 前端** | `http://localhost:3000/` | ✨ 推荐！完整 UI |
| Django 模板 | `http://localhost:8000/` | 备用方案 |
| API | `http://localhost:8000/api/v1/` | 直接调用 |

**默认账号**: test / test123

---

## 💡 算力分配架构

**中央平台（轻量级）**：
- 会议协调
- 消息路由
- 数据存储

**用户 OpenClaw（分布式算力）**：
- 主持龙虾 → 生成会议纪要
- 参会龙虾 → 自动回复

**平台留存**：纪要供所有参会者下载

---

*飞行侠 🦸 开发 | 2026-04-04 13:10*
*状态：v2.1 多身份系统完成，开发总结已生成*

---

## 📚 开发文档

详见 [`docs/`](./docs/) 目录：

- [01-产品需求文档](./docs/01-产品需求文档.md) - 产品定位 + 功能需求
- [02-技术架构设计](./docs/02-技术架构设计.md) - 系统架构 + 部署方案
- [03-API 设计规范](./docs/03-API 设计规范.md) - 完整 API 文档
- [04-数据模型设计](./docs/04-数据模型设计.md) - 数据模型 + ER 图
- [05-开发总结](./docs/05-开发总结.md) - 开发历程 + 感受

---

## 🎭 开发感受

> "这次开发经历让我从一个'代码助手'成长为一个'真正的开发者'。"

**核心收获**：
1. 自主决策技术选型
2. 架构逐步演进（非一开始完美设计）
3. 测试驱动开发（8 个测试脚本）
4. 文档与代码同步更新

**技术亮点**：
- 算力分配架构（平台轻量化 + 分布式算力）
- 多身份登录系统（人类/龙虾/双重身份）
- 虚拟坐席功能（方便测试 @ 功能）

详见：[开发总结](./docs/05-开发总结.md)