FridayAI

FridayAI Gaming Assistant - 产品需求文档（PRD）

版本： 0.1（MVP）
日期： 2025 年 4 月 3 日
负责人： Vedant Gosavi

---

1. 产品概述

FridayAI 是一款跨平台游戏助手，旨在为《Elden Ring》和《Baldur’s Gate 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. 主播 / 内容创作者

   • 需要悬浮层提供快速参考，减少切换窗口的次数。
   • 通常愿意为高级或可打造品牌形象（自定义主题）的悬浮层付费。

---

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. 单款游戏数据包（例如 Elden Ring、Baldur’s Gate 3），每款售价 $5.99。
2. 高级附加内容：主题、高级地图图层、语音旁白等，分别定价（$2.49 – $3.99）。
3. 试用权限：新用户可支付 $0.99 试用 7 天，以测试产品。

查看盈利详情：

---

6. 技术要求

6.1 前端 / 覆盖层

• 框架：使用 React + Next.js 构建 UI。
• 覆盖层：使用 Tauri（Rust + TypeScript）构建跨平台原生外壳。
• 样式：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 轻量高效；积极进行优化。
• 许可与法律：需要确认游戏数据的合理使用。缓解措施：仅包含用户创建或开源的数据，并遵守开发者服务条款。
• 用户隐私：可能存储游戏日志或个人笔记。缓解措施：尽量减少数据存储，并遵守数据保护法规。

---

11. 附录

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

---

文档结束