FridayAI 游戏助手 - 产品需求文档 (PRD)

版本: 0.1 (MVP) 日期: 2025年4月3日 负责人: Vedant Gosavi

---

1. 产品概述

FridayAI 是一款跨平台游戏助手，旨在为《艾尔登法环》和《博德之门3》等热门游戏提供实时游戏信息、任务追踪和沉浸式指南。它采用基于 Tauri 的轻量级桌面覆盖层（使用 Rust 和 TypeScript 编写），与 Next.js 后端交互，实现用户身份验证、数据存储和内容交付。

要点：

• 使用 Tauri 的跨平台桌面应用程序
• 透明、始终置顶的覆盖层，用于游戏内辅助
• Next.js 和 React 用于主要用户界面和后端端点
• 通过 Clerk 进行身份验证和用户管理
• 通过 Stripe 进行支付处理和购买流程
• PostgreSQL 用于存储用户进度、任务数据、物品数据库等。

参考资料：

• 技术概述：
• 货币化结构：
• 数据库模式和架构：

---

2. 目标与目的

1. 增强游戏体验 在不显眼的覆盖层中为玩家提供实时指导（任务、物品、地图）。

2. 提供全面的游戏数据包 每个支持的游戏都附带精选数据：任务线、物品、NPC 和位置情报。

3. 实现无缝购买和升级 直接在覆盖层中一键购买高级数据包、主题或其他附加组件。

4. 确保跨平台兼容性 为 Windows、macOS 和 Linux 提供轻量级、响应迅速的覆盖层解决方案，且资源占用率低。

5. 扩展以支持更多游戏 保持模块化的代码结构，只需添加数据模式和前端包即可支持新游戏。

---

3. 用户画像

1. 休闲玩家

   • 需要快速的任务帮助或物品位置，但屏幕上的杂乱信息要尽可能少。
   • 可能会使用免费或基本数据包。

2. 硬核完美主义者

   • 需要关于任务、隐藏物品和高级统计数据的广泛数据。
   • 更倾向于购买高级功能或扩展包。

3. 主播 / 内容创作者

   • 需要一个覆盖层来提供快速参考，最大限度地减少 Alt-Tab 切换。
   • 经常投资于高级或可定制（自定义主题）的覆盖层。

---

4. 核心功能与需求

4.1 基于 Tauri 的覆盖层

• 始终置顶和透明的窗口，覆盖在全屏或窗口化游戏上。
• 可配置的位置、大小和基于热键的切换。
• 无边框方法，在游戏中实现干净、集成的外观。

4.2 游戏数据包

• **任务数据：**逐步说明、先决条件、奖励、剧透级别标记。
• **物品数据库：**可按名称、类型或属性搜索。
• **NPC 信息：**位置、派系、任务参与、时间表。
• **地图和位置：**用于地下城、开放世界区域等的交互式或静态参考。

4.3 用户进度和个性化

• **任务进度：**用户可以标记已完成、"进行中"或"已跳过"的步骤。
• **书签：**用于快速访问常用物品、任务或 NPC 的参考。
• **自定义覆盖层主题：**基本和高级皮肤、背景不透明度或配色方案。
• **剧透控制：**隐藏或显示结局或主要情节剧透的选项。

4.4 身份验证和购买

• Clerk 用于登录、注销和密码重置。
• Stripe 用于安全购买流程：
  • 一次性购买单个游戏包。
  • 可选的高级附加组件（主题、高级功能）。
  • 试用或免费演示。

4.5 多平台支持

• **Windows：**必须支持 Windows 10+，且系统开销最小。
• **macOS：**支持最新的两个 macOS 版本。
• **Linux：**主要发行版（Ubuntu、Fedora），确保覆盖层功能正常。

---

5. 货币化策略

1. 单个游戏数据包（例如，《艾尔登法环》、《博德之门3》），每个售价 5.99 美元。
2. **高级附加组件：**主题、高级地图图层、语音旁白等，以不同的价格出售（2.49 美元 – 3.99 美元）。
3. **试用访问：**新用户以 0.99 美元的价格获得 7 天试用期，以测试产品。

有关货币化详细信息，请参见：

---

6. 技术要求

6.1 前端 / 覆盖层

• **框架：**React + Next.js 用于 UI。
• **覆盖层：**Tauri（Rust + TypeScript）用于跨平台原生 shell。
• **样式：**Tailwind CSS，Shadcn UI 组件。

6.2 后端

• Next.js App Router 用于 API 端点和服务器端渲染。
• PostgreSQL 用于持久存储用户进度、游戏数据、日志。
• **身份验证：**Clerk 集成（无需本地用户表）。
• **支付：**Stripe 集成，具有强大的错误处理、订阅 Webhook 等。

6.3 数据模型

• 游戏特定的模式（例如 elden_ring 和 baldurs_gate3），包含以下表的：
  • quests、quest_steps、items、npcs、locations
• 用于用户设置、书签、购买等的 system 模式。
• 用于快速物品/任务查找的全文搜索字段（TSVector、GIN 索引）。

有关详细的模式结构：

6.4 安全与隐私

• **加密通信：**HTTPS 用于所有后端调用。
• **安全身份验证：**Clerk 管理令牌，最大限度地减少用户数据暴露。
• **支付安全：**依赖 Stripe 进行符合 PCI 标准的交易。
• **最小数据存储：**仅存储必要的用户进度/设置。

6.5 性能与稳定性

• **轻量级覆盖层：**Tauri 确保最小的 CPU/RAM 开销，这对于游戏性能至关重要。
• **缓存：**潜在的本地游戏数据缓存，以减少重复的获取调用。
• **可扩展性：**Vercel 上的 Next.js 后端，具有水平可扩展的 PostgreSQL（例如，托管数据库）。

---

7. 用户流程（高级）

1. **下载并安装：**用户从您的网站下载 Tauri 桌面客户端。
2. **登录 / 注册：**Tauri 内部的 Clerk 流程用于用户身份验证。
3. **购买或解锁游戏包：**如果尚未拥有，则进行 Stripe 支付流程。
4. **覆盖层设置：**配置大小、热键、剧透可见性等。
5. **启动游戏：**覆盖层在后台保持就绪状态。
6. **游戏内使用：**切换覆盖层，搜索任务/物品，跟踪进度。
7. **同步并保存：**更改保存到数据库，以实现多设备连续性。

---

8. 成功指标

• **用户参与度：**每日活跃用户、平均会话时长。
• **转化率：**试用用户转化为付费用户的百分比。
• **流失率：**订阅取消的频率（如果引入订阅）。
• **覆盖层使用情况：**游戏内交互次数，例如每次会话的任务查找次数。
• **性能指标：**覆盖层运行时 CPU/RAM 开销。

---

9. 非功能性需求

1. **可用性：**后端 99.9% 的正常运行时间，以确保实时数据。
2. **可维护性：**用于快速扩展（新游戏）的模块化架构。
3. **可用性：**覆盖层必须保持直观，且学习曲线最小。
4. **可移植性：**用于 Windows、macOS、Linux Tauri 构建的单个代码库。
5. 本地化（未来考虑）：能够为非英语用户添加语言包。

---

10. 风险与缓解措施

• **资源密集度：**覆盖层可能会降低游戏速度。缓解措施：Tauri 是轻量级的；积极优化。
• **许可与法律：**需要确认游戏数据的合理使用。缓解措施：仅包含用户创建或开源数据，尊重开发者 TOS。
• **用户隐私：**可能存储游戏日志或个人笔记。缓解措施：存储最少的数据，遵守数据保护法规。

---

11. 附录

• **货币化和产品 ID：**详细的 SKU 和一次性购买结构。
• **游戏文档：**添加新游戏、数据包结构的实践。
• **数据库模式：**系统模式与游戏模式，完整的 DDL。
• **技术 README：**总体架构说明。

---

文档结束