# multi-agents-classroom

**Repository Path**: wdracky/multi-agents-classroom

## Basic Information

- **Project Name**: multi-agents-classroom
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-15
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🏰 维斯特洛议事会 Westeros Council

> 基于 OpenAgents 构建的多智能体协作网络,将《冰与火之歌》中的角色以 AI Agent 形式接入同一协作空间,借助 GLM-4.7 赋予每位角色独特人格与语言风格,实现多智能体专业分工与协作决策,从游戏跑团到实际生产力的全面覆盖。

✨ **多Agent协作,共创无限可能——从维斯特洛到现实世界的智能协作平台!**

---

## 🎬 项目简介

受《权力的游戏》史诗故事启发,我们构建了一个多智能体跑团系统,将维斯特洛大陆的主要角色以 AI Agent 形式复活:

- **丹妮莉丝·坦格利安** - 龙之母,解放者
- **提利昂·兰尼斯特** - 小恶魔,智慧化身
- **琼恩·雪诺** - 北境之王,守夜人
- **艾莉亚·史塔克** - 无面者,复仇之剑
- **瑟曦·兰尼斯特** - 女王,权力化身
- **詹姆·兰尼斯特** - 弑君者,救赎之路
- **珊莎·史塔克** - 北境女王,智慧成长
- **布兰·史塔克** - 三眼乌鸦,时空见证者
- **席恩·葛雷乔伊** - 救赎者,重生之勇
- **桑铎·克里冈** - 猎狗,暴力中的善良

在这个系统中,每个角色都有:
- ✅ **独特的性格特征** - 基于原著精心设计
- ✅ **符合原著的语言风格** - 说话方式、口头禅、语言特色
- ✅ **丰富的背景故事** - 基于原著剧情和角色发展
- ✅ **复杂的情感与动机** - 体现角色的内心世界和矛盾

---

## 🧠 核心技术栈

| 组件 | 说明 |
|------|------|
| **[OpenAgents](https://github.com/openagents-org/openagents)** | 开源 AI Agent 网络框架,支持多智能体发现、通信、协作 |
| **[GLM-4.7](https://www.bigmodel.cn/glm-coding?ic=4G1ARPDRUV)** | 智谱 AI 最新旗舰大模型,强化角色扮演、长程任务规划,赋予角色"灵魂" |
| **Agent 角色提示工程** | 为每位角色定制身份、性格、语言风格、历史立场 |
| **本地部署 + 自定义模型集成** | 通过 OpenAI 兼容接口接入 GLM,实现私有化部署 |

---

## 🚀 快速开始

### 1. 安装 OpenAgents

```bash
pip install openagents
openagents --version  # 确保 ≥ 0.8.4
```

### 2. 启动网络中心(跑团服务器)

```bash
# 使用现有配置启动
openagents network start network.yaml
```

> 自动打开 Studio 管理界面：http://localhost:8700/studio/

### 3. 配置 GLM-4.7

环境变量(避免编码/认证问题):

```bash
# Windows (PowerShell)
$env:PYTHONIOENCODING = "utf-8"
$env:OPENAI_BASE_URL = "https://open.bigmodel.cn/api/paas/v4"
$env:OPENAI_API_KEY = "你的GLM-API-KEY"
```

> API Key 从 [智谱官网](https://www.bigmodel.cn/usercenter/apikeys) 获取

### 4. 启动所有角色 Agent (推荐使用一键启动)

```bash
# 方法一: 使用一键启动脚本 (推荐)
python -X utf8 quick_start.py

# 方法二: 使用原始启动脚本
python -X utf8 start_got_agents.py
```

> 所有 Agent 配置文件位于 `/agents/` 目录,含详细角色设定与行为规则。

---

## 🎮 游戏管理工具

项目提供了完整的游戏管理工具集,让跑团体验更加丰富:

### ⚡ 一键启动器 (`quick_start.py`)

友好的图形化启动菜单,简化所有操作:

```bash
python -X utf8 quick_start.py
```

**功能:**
- 🚀 全部启动 - 一键启动所有 10 个角色
- 🎭 自定义启动 - 选择要启动的角色
- 🎉 活动策划 - 多Agent活动策划系统
- 🎬 游戏主控 - 打开游戏管理面板
- 📊 对话分析 - 分析历史对话数据
- 🔧 环境检查 - 自动检查依赖和网络

### 🎬 游戏主控面板 (`game_master.py`)

集中管理游戏场景、事件和剧情:

```bash
python -X utf8 game_master.py
```

**功能:**
- 🎬 场景管理 - 切换和管理游戏场景
- 🎭 角色管理 - 查看和管理角色状态
- 💕 关系网络 - 查看和修改角色关系
- ⚡ 事件系统 - 触发和管理游戏事件
- 📜 剧情推进 - 推进游戏章节
- 🏆 成就系统 - 查看已解锁成就

### 🎉 活动策划系统 (`event_planner.py`)

**多Agent协作的活动策划工具，利用冰火角色的专业能力**:

```bash
python -X utf8 event_planner.py
```

**功能:**
- 🎯 创建新活动 - 从零开始策划
- 📊 宣传海报设计 - AI生成海报创意和文案
- 📋 活动安排 - 详细的日程和流程规划
- 🎨 视觉风格设计 - 确定活动视觉风格
- 📢 推广策略 - 制定宣传推广方案
- 📈 数据分析 - 分析活动数据和效果
- 👥 团队协作 - 多Agent协作讨论

**Agent角色分工:**
- **丹妮莉丝** - 活动总策划，领导力和愿景
- **提利昂** - 创意总监，创意和文案
- **琼恩·雪诺** - 执行主管，流程和协调
- **珊莎** - 视觉设计总监，审美和风格
- **瑟曦** - 市场总监，推广和品牌
- **詹姆** - 场地设备管理，后勤和保障
- **艾莉亚** - 创意执行，互动和体验
- **布兰** - 数据分析顾问，数据和预测

> 📖 详细使用说明：查看 `EVENT_PLANNING_GUIDE.md`

### 📊 对话分析器 (`conversation_analyzer.py`)

分析对话历史,获得深度洞察:

```bash
python -X utf8 conversation_analyzer.py
```

**功能:**
- 📈 角色发言统计 - 统计各角色的发言次数和字数
- 😊 情感倾向分析 - 分析对话的情感倾向
- 🏷️ 话题分布 - 识别对话中的主要话题
- 💬 互动分析 - 分析角色之间的互动
- ⏰ 时间分布 - 分析对话的时间分布
- 📄 导出报告 - 导出分析结果到文件

### 💕 角色关系系统 (`relationships.py`)

管理角色间的好感度和互动影响:

```bash
python -X utf8 relationships.py
```

**功能:**
- 查看所有角色之间的关系值 (-100 到 100)
- 获取角色的朋友和敌人列表
- 模拟互动对关系的影响
- 导出/导入关系数据

### 🎬 场景预设库 (`scenes.py`)

提供多个经典场景配置:

```python
from scenes import SCENES

# 获取所有场景
print(SCENES.keys())

# 获取特定场景
throne_room = SCENES['throne_room']

# 按氛围筛选
political_scenes = [s for s in SCENES.values() if s['mood'] == 'political']
```

**预设场景:**
- 铁王座议事厅 - 君临城权力中心
- 临冬城大厅 - 面对异鬼的最后堡垒
- 龙石岛王座厅 - 征服战争的指挥部
- 绝境长城 - 守夜人驻守的边境
- 高庭玫瑰花园 - 阴谋与美貌并存
- 弥林金字塔 - 解放与统治的矛盾
- 黑白之院 - 死亡与奉献的圣地

---

## 🎭 跑团玩法

### 基础对话

在 Studio 的 Messaging 模块 general 频道中,您可以:

- **向角色提问** - 每个角色都会用自己的视角回答
- **发起讨论话题** - 角色们会彼此争鸣,展现不同观点
- **扮演特定场景** - 比如"铁王座会议"、"临冬城议事厅"等

### 主题建议

#### 政治与权力
- "铁王座应该归谁?"
- "如何治理维斯特洛?"
- "什么是真正的权力?"

#### 家族与荣誉
- "家族荣誉 vs 个人责任"
- "你如何看待自己的家族?"
- "背叛和忠诚的界限是什么?"

#### 哲学与人生
- "什么才是真正的骑士精神?"
- "正义与复仇的区别是什么?"
- "命运是可以改变的吗?"

#### 角色互动
- "琼恩和丹妮莉丝:爱 vs 责任"
- "提利昂与瑟曦:智慧 vs 傲慢"
- "艾莉亚与桑铎:暴力 vs 保护"

### 剧情讨论

让角色讨论原著中的关键情节和决策:
- "琼恩应该杀死丹妮莉丝吗?"
- "珊莎是否应该原谅提利昂?"
- "艾莉亚的复仇是否正义?"
- "詹姆的救赎之路是否成功?"

### 假设场景

提出原著没有的场景:
- "如果琼恩没有杀死丹妮莉丝会怎样?"
- "如果提利昂成为了北境之王?"
- "如果瑟曦和詹姆没有分开?"
- "如果劳勃国王没有死会怎样?"

### 角色冲突

制造角色之间的争论:
- 让丹妮莉丝和瑟曦讨论"如何统治"
- 让提利昂和琼恩讨论"责任 vs 快乐"
- 让艾莉亚和珊莎讨论"复仇 vs 和解"

---

## 📁 项目结构

```
OpenAgents-GLM-master/
├── agents/                    # 角色配置文件(YAML + 角色提示词)
│   ├── Daenerys.yaml         # 丹妮莉丝·坦格利安
│   ├── Tyrion.yaml           # 提利昂·兰尼斯特
│   ├── JonSnow.yaml          # 琼恩·雪诺
│   ├── Arya.yaml            # 艾莉亚·史塔克
│   ├── Cersei.yaml          # 瑟曦·兰尼斯特
│   ├── Jaime.yaml           # 詹姆·兰尼斯特
│   ├── Sansa.yaml           # 珊莎·史塔克
│   ├── Bran.yaml            # 布兰·史塔克
│   ├── Theon.yaml          # 席恩·葛雷乔伊
│   └── Sandor.yaml         # 桑铎·克里冈
├── game_master.py            # 🎮 游戏主控面板 - 场景/事件/剧情管理
├── conversation_analyzer.py  # 📊 对话分析器 - 统计/情感/话题分析
├── relationships.py         # 💕 角色关系系统 - 好感度/互动管理
├── scenes.py               # 🎬 场景预设库 - 经典场景配置
├── quick_start.py          # ⚡ 一键启动器 - 图形化启动菜单
├── start_got_agents.py      # 启动脚本(启动所有角色)
├── launch_fixed.py         # 单个 Agent 启动器
├── network.yaml           # 网络配置
├── sitecustomize.py       # 编码修复
├── game_data/             # 游戏数据目录(自动生成)
│   ├── game_state.json    # 游戏状态存档
│   ├── scenes.json       # 自定义场景
│   └── conversation_report_*.json  # 对话分析报告
└── README.md             # 本文档
```

> 💡 每位角色的 `instruction` 均精心设计,确保**语言风格、自称、价值观、历史事件引用**高度还原。

---

## 🎯 高级玩法

### 1. 场景跑团
设计特定场景让角色互动:
- "铁王座议事会" - 讨论国家大事
- "临冬城守卫战" - 面对异鬼进攻的决策
- "龙石岛战略会议" - 如何征服维斯特洛
- "赫伦堡审判" - 执行正义还是复仇?

### 2. 剧情分支
提出不同的剧情分支,观察角色的选择:
- "如果异鬼进攻,各家族会作何反应?"
- "如果龙复活了,丹妮莉丝会如何使用?"
- "如果琼恩公开身世,北境会分裂吗?"

### 3. 伦理辩论
让角色讨论深刻的道德问题:
- "杀死儿童(瑟曦的孩子)是必要的吗?"
- "为了拯救多数可以牺牲少数吗?"
- "复仇是正义的吗?"

### 4. 角色扮演
您可以扮演特定角色参与:
- 扮演"小指头"策划阴谋
- 扮演"夜王"发动进攻
- 扮演"山姆威尔"提出建议

---

## 🛠️ 常见问题

1. **Agent 启动后立即退出?**
   → 检查 `OPENAI_API_KEY` 和 `OPENAI_BASE_URL` 环境变量是否设置正确。

2. **中文 YAML 解析失败?**
   → 设置环境变量: `PYTHONIOENCODING=utf-8`,使用 `-X utf8` 参数。

3. **忘记 Studio 管理员密码?**
   → 默认账号:`admin`,默认密码:`admin`(首次登录建议修改)。

4. **角色回复不符合原著?**
   → 检查 YAML 文件中的 `instruction` 是否准确,可以调整语言风格。

---

## 🌟 未来展望

- **新增角色** - 波隆、瓦里斯、布蕾妮等更多经典角色
- **语音合成** - 为每个角色配音,增强沉浸感
- **剧情分支** - 根据角色选择进入不同剧情线
- **AI 策略升级** - 更智能的角色决策和剧情推理

---

## 📄 角色速览

| 角色 | 身份 | 特点 | 经典台词 |
|------|------|------|----------|
| **丹妮莉丝** | 龙妈 | 解放者,母性 | "我不是奴隶。我是卡丽熙!" |
| **提利昂** | 小恶魔 | 智慧,幽默 | "我喝酒,而且我知道事情" |
| **琼恩·雪诺** | 北境之王 | 守护者,责任 | "长夜将至,我从今开始守望" |
| **艾莉亚** | 无面者 | 复仇,自由 | "我不是无面者,我是艾莉亚!" |
| **瑟曦** | 女王 | 权力,傲慢 | "我选择暴力" |
| **詹姆** | 弑君者 | 救赎,荣誉 | "真正的骑士是因为他的心" |
| **珊莎** | 北境女王 | 智慧,成长 | "淑女不只是穿漂亮的裙子" |
| **布兰** | 三眼乌鸦 | 神秘,全知 | "过去已经过去" |
| **席恩** | 救赎者 | 赎罪,勇气 | "我不是史塔克,我是席恩" |
| **桑铎** | 猎狗 | 粗鲁但善良 | "骑士都是狗屎" |

---

## 🤝 支持OpenAgents

- 项目受 **[OpenAgents](https://github.com/openagents-org/openagents)** 启发,欢迎 star & contribute!
- 加入 Discord 社区:https://discord.gg/openagents
- 本项目代码开源,欢迎 PR 新角色、新玩法!

---

## 📝 版权声明

本项目的角色设定基于乔治·R·R·马丁的《冰与火之歌》系列小说及 HBO 电视剧《权力的游戏》。

---

> **"凛冬将至"**
>
> 让维斯特洛的角色们在 AI 的世界中重生,继续他们的传奇故事!