项目背景

项目名称

ScriptWorld - AI 驱动的多人剧本杀游戏平台

项目灵感与定位

剧本杀作为一种沉浸式角色扮演游戏，近年来在年轻人中广受欢迎。但传统剧本杀存在以下痛点：

人数限制：需要固定人数才能开局，缺少玩家时体验受限
DM 门槛：优秀的主持人（DM）培养成本高，水平参差不齐
NPC 互动：真人 NPC 成本高，难以实现复杂的自主行为

为此，我们开发了  ScriptWorld  —— 一个基于 AI Agent 的剧本杀游戏平台，通过 AI 技术解决传统剧本杀的核心痛点。

 项目定位

FastAPI + React + AI Agent 的剧本杀游戏平台

核心特性：

AI 角色扮演：AI 扮演 NPC 角色，实现自主对话与互动
智能 DM 主持：AI 主持人控场，引导游戏流程
多人实时联机：支持多人在线组局，打破地域限制
主备双模型：通义千问 + DeepSeek 主备切换，保证服务可用性

 二、本周工作成果：初始框架建构

1. 技术栈选型

后端技术选型

Web 框架| FastAPI | 高性能异步 Python 框架，原生支持 SSE，自动生成 API 文档 
数据库 | SQLite (SQLAlchemy ORM) | 轻量级无需安装，适合中小型项目，支持异步操作 
AI 能力 | 通义千问 + DeepSeek | 大语言模型 API，支持主备切换保证可用性 
实时通信 | SSE (Server-Sent Events) | 实现简单，适合服务端推送场景，兼容性好 
AI Agent | OpenAgents SDK | 分布式多 Agent 协作框架，支持 DM/NPC/大厅 Agent 分工 
API 限流 | SlowAPI | 防止恶意请求，保护 API 资源 

选型思路：后端采用  FastAPI + 异步架构  的组合，充分利用 Python 生态在 AI 领域的优势。通过 OpenAgents SDK 实现 AI Agent 的分布式协作，为后续的 AI 对抗功能提供扩展能力。

 前端技术选型

 UI 框架   | React 18 + TypeScript | 组件化开发，TypeScript 提供类型安全 
 构建工具   | Vite 5.x | 极速热更新，开发体验优秀 
 状态管理   | Zustand | 轻量级、API 简洁，适合中大型项目 
 路由    | React Router DOM v6 | 声明式路由，支持嵌套路由和权限控制 
 HTTP 客户端    | Axios | 支持拦截器、请求取消，社区成熟 
 实时推送   | SSE (EventSource) | 轻量级服务端推送，适合游戏消息流 

选型思路：前端采用   React + TypeScript 全类型覆盖   方案，配合 Vite 的极速构建能力，确保开发效率和代码质量。Zustand 作为轻量级状态管理库，相比 Redux 更适合游戏类应用的实时状态更新需求。

本周是创新实训的起点，我们完成了项目从规划到落地的第一步：

核心成果

1. ✅ 召开项目启动会议，明确剧本杀平台的目标与技术路线
2. ✅ 完成  前后端分离架构  的初始框架搭建
3. ✅ 搭建 Docker 容器化部署环境，支持一键启动
4. ✅ 确认团队分工与 16 周开发计划
5. ✅ 开通 CSDN 博客，完成首篇实训记录

架构亮点

 前后端分离架构 ：职责清晰，便于并行开发和后期维护
 AI Agent 分布式架构 ：基于 OpenAgents SDK，支持 DM/NPC/大厅 Agent 分工协作
 SSE 实时通信 ：替代传统轮询，实现游戏消息的低延迟推送
 Docker 一键部署 ：跨平台运行，降低环境配置成本
 TypeScript 全覆盖 ：类型安全，提升代码质量和开发效率
 主备双模型 ：通义千问 + DeepSeek 自动切换，保证服务高可用

 下一步

接下来将进入  基础功能开发阶段，重点实现以下核心功能：

 📝  剧本系统 ：剧本加载、角色分配、线索管理
 🎮  游戏流程 ：开场介绍、自我介绍、调查、讨论、投票、复盘
 🤖  AI Agent ：DM 主持人控场、NPC 角色扮演与自主互动
 💬  实时消息 ：SSE 推送、聊天系统、游戏状态同步

逐步完成项目的最小可行产品（MVP），打造沉浸式的 AI 剧本杀体验。