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
- 安装 Python 3.12：
uv python install 3.12.0 - 验证安装：
uv python list --only-installed
- 安装 Python 3.12：
- 已配置指向目标 AWS 账户的 AWS 凭证（应用将部署至该账户）
- 使用 VSCode 时，建议安装 Nx Console VSCode 插件
- 根据本指南步骤，确保目标区域的AWS账号已在Bedrock中启用Anthropic Claude 3.5 Sonnet v2模型的访问权限。