AI地牢游戏

概述

在本教程中，您将构建一个由AI驱动的地牢冒险游戏。本教程不要求预先具备任何@aws/nx-plugin或相关技术的知识。您将在此学习的技巧是构建任何基于@aws/nx-plugin应用程序的基础，深入理解本教程将使您掌握@aws/nx-plugin的核心知识，并对如何使用NX有基本认知。

注意

本教程适合喜欢通过实践学习并希望快速创建实际项目的人群。如果您更倾向于逐步学习每个概念，请参考各个组件的独立指南

完成本教程的用户将获得以下技能：

• 使用@aws/nx-plugin创建新应用
• 使用NX管理/构建代码库
• 使用tRPC和FastAPI构建API
• 使用Tanstack router创建新页面
• 使用Tanstack query调用后端API
• 修改生成代码以适应特定需求
• 创建和部署CDK基础设施

构建内容

在本教程中，您将使用@aws/nx-plugin构建一个由AI驱动的地牢冒险游戏。

以下是完成后的效果预览：

应用组件

AI驱动的地牢冒险游戏将采用以下组件架构：

• 使用ElectroDB/DynamoDB管理游戏状态的tRPC API
• 支持流式响应的Python/FastAPI Lambda函数（基于Amazon Bedrock实现故事生成）
• React/Vite前端网站包含：
  • 使用Amazon Cognito/Identity Pools实现安全的API调用
  • 支持类型安全文件路由的Tanstack router
  • 调用游戏和故事API的生成SDK（利用Tanstack query）
• 部署应用的CDK基础设施

先决条件

开始前需确保已安装以下全局依赖：

• Git
• Node >= 22（推荐使用 NVM 管理 Node 版本）
  • 通过 node --version 验证版本
• PNPM >= 10（也可选择 Yarn >= 4、Bun >= 1 或 NPM >= 10）
  • 通过 pnpm --version、yarn --version、bun --version 或 npm --version 验证版本
• UV >= 0.5.29
  1. 安装 Python 3.12：uv python install 3.12.0
  2. 通过 uv python list --only-installed 验证安装
• AWS 凭证需配置至目标 AWS 账户（应用部署环境）
• 使用 VSCode 时推荐安装 Nx Console VSCode 插件

• 根据本指南步骤，确保目标区域的AWS账号已在Bedrock中启用Anthropic Claude 3.5 Sonnet v2模型的访问权限。