VIB 端产品文档
依据：产品需求基线 v0.35 · 2026-09-15。状态：方案评审稿（原型同步状态见各端说明）。
v0.35 新手奖励资格补充
仅两种情况提供一次新手奖励信号：VIB 未登录且游戏账户未检测到信号使用记录；或 VIB 已登录且未与任何游戏网站产生关联。其他情况不新增新手奖励，已有发放记录继续去重。已登录后只检查当前网站未关联是不够的，须检查全部网站。交互原型已同步新手资格、首次关联前判定、登录保留已发信号、发放去重及当前标签页刷新恢复。已登录新手暂按免费演示，正式计费待确认。
v0.34 规则补充与实现边界
需求已更新：游戏 PWA 内先登录游戏、再在悬浮窗登录 VIB 时首次关联；有效期仅从具体游戏信号生成后开始，倒计时由游戏接口提供，无退点；新手过期也触发遮罩、重启恢复；切号清空所有信号。支付失败或取消即放弃，不提供历史单续付，待到账沿用当前版本；VIP 生命周期依据第三方，项目不提供续费退款操作。
本次同步需求文档。以下原型说明保留 v0.33 演示情况；满屏限制已补充直接演示入口及过期触发，实际持久化恢复仍待实现，不能作为 v0.34 已实现的证据。注册赠点仍为演示值。
本次方案调整与原型状态
依据产品需求基线 v0.31，MVP VIB 端已更新以下方案。交互原型已同步 v0.31，可演示安装门槛、4 张 Splash、全屏认证、网站按钮及个人中心调整。安装、认证和下载跳转仍为演示，不代表生产能力。
| 页面 | 最新方案 |
|---|---|
| 安装引导 | 必须先下载安装 VIB PWA；未安装全屏引导 |
| 新用户 Splash | 仅展示 Splash1／Splash2／Splash3／Splash4 占位文字，具体内容由 UI 后续输出；依次点击下一步，4 张不可跳过；中断后从第 1 张重走，结束后进入注册页 |
| 注册／登录 | 新用户先走 Splash；已安装未登录时全屏遮挡，默认注册，可切换登录；认证后才可查看产品内容 |
| 首页 | 安装并登录后可见；独立展示“已关联／未关联”标签，按钮统一“去玩游戏”；两者均在系统默认浏览器打开对应游戏的 PWA 下载页 |
| 我的 | 移除“已关联游戏账户”模块，保留点数余额、购买及记录等入口 |
| VIP 订阅 | 单一 VIP 档位，月付 R$ 29.99／年付 R$ 299.99，五项权益 |
交互与开发衔接
- 原型将切到后台、刷新、关闭重开视为 Splash 中断；未完成时重回第 1 张。仅安装与引导完成标记保存到本地，不存储密码或真实登录凭证。评审场景选择器可重置安装、引导和登录状态，不属于产品内入口。
- 下载入口以新窗口打开对应网站的演示 PWA 下载页；真实 URL 尚未提供，系统默认浏览器唤起仍需目标手机验证。
- 全屏认证不能关闭或绕过，产品内容及底部导航不可查看或操作；退出或登录失效恢复默认注册页。
- “去玩游戏”始终可点击，关联标签独立展示；点击下载入口不产生账户关联。
- 安装检测、正式认证、各游戏下载页地址及系统默认浏览器打开方式仍需开发对接和设备验证。
- 假设用户包括首次安装的新用户和已有账号的回访用户；注册页保留清晰的登录切换入口，关联状态使用标签展示，“去玩游戏”使用按钮样式表达可点击。这是设计推演，非真实用户研究结论。
- 悬浮球方案已在 v0.32 调整，详见悬浮球文档；PWA 自身的安装、Splash 和认证流程继续沿用 v0.31。
对应需求原文
以下摘录保留原章节编号和已确认／待明确口径；若存在历史表述冲突，以 v0.35 新手资格及当前 MVP 范围为准。
1. 产品定位
New VIB 是基于 VIB 2.0 衍生的产品，暂称 VIB AI。用户通过嵌入 AI 版博彩游戏中的悬浮机器人获取信号，通过独立的 PWA 完成 VIB 注册、账户管理、发现更多支持的游戏及充点。
产品设想结合用户游戏行为采集游戏数据，提供信号，先展示多款可选游戏，用户选择后获得指定游戏、建议下注金额及倒计时，并自行在游戏中下注。提高胜率、极大概率赢得本局以及“AI 破解”属于用户提出的目标效果，当前没有提供验证证据，本文件不将其记为已实现能力或保证收益承诺。
2. 文档约定
- 已确认：用户直接提出或明确纠正的需求。
- 待明确：当前描述尚未给出具体规则，不默认已有结论。
- 建议：用于后续设计或验证的候选方案，不代表已批准范围。
本文件区分业务版本与文档版本：MVP 是首个产品交付范围；“后续版本”尚未指定正式版本号或交付时间。
3. 产品组成与术语
全局终端与安装约束（最新确认）：
- VIB 用户产品仅面向移动端用户；PWA 与游戏内机器人均按移动端使用场景定义，桌面用户端不纳入当前范围。
- VIB PWA 自身仍需先安装，再按第 5.4 节完成 Splash 和注册／登录；未安装时全屏安装引导，不展示首页及底部导航。
- v0.32 悬浮球例外（已确认）：下载 AI 版游戏平台后即可看到悬浮球。游戏账户已登录、未登录悬浮球 VIB 且游戏账户未检测到信号使用记录的新手，可在安装／注册 VIB 前体验新手信号。使用完成 5 秒后出现不可关闭的全游戏遮罩，提供下载 VIB PWA 或登录 VIB 两个入口；在悬浮球内成功登录前不解除。
- 本次明确替代旧“所有操作前先安装”的悬浮球规则；游戏内只提供 VIB 登录，注册在 VIB PWA 完成。新手信号不预扣，也不抵扣注册／登录后赠送的点数。
- 管理后台是否也限定移动端、是否也必须安装 PWA，尚未明确；本次用户群体约束不自动推导后台操作终端。
- 支持的移动操作系统及浏览器、安装状态检测和无法检测时的处理仍需开发评估。
| 对象 | 定义与职责 |
|---|---|
| AI 版游戏 | 用户下载并可在其中使用悬浮机器人的游戏；通过合作游戏网站接入后台提供的 JS；游戏下载或安装包的具体分发方式待明确 |
| 悬浮机器人／悬浮球 | 游戏内可见、可拖动、可点击的交互入口，承载消息、信号及 VIB 登录等流程 |
| VIB AI PWA | 独立产品入口，承载介绍、安装引导、游戏列表、VIB 注册登录、个人中心及充点 |
| 管理后台 | MVP 包含用户列表查询、用户数据统计、合作网站接入、精简信号奖励配置及财务管理；新手奖励在代码中写死 |
| VIB 账户 | 在 VIB AI PWA 注册，并可在游戏内悬浮机器人中登录的账户 |
| 信号 | 出现后提供多款游戏供选择，选定后给出指定游戏、建议下注金额及倒计时；用户在倒计时内完成匹配下注即使用，倒计时结束即过期 |
| 信号奖励金额 | 用户在游戏平台下注后获得的奖励金额；该定义已确认，总返还、净奖励及是否含本金的结算字段口径仍需对齐 |
| 点数 | 普通信号在确认选择具体游戏时扣点；沿用 ceil（（奖励 − 下注金额）× 0.20）公式，奖励金额取自该正常信号对应的管理后台配置结果；新手体验不预扣、不抵扣注册／登录赠点 |
| 公会 | 后续版本面向用户的名称，业务本质为分销商及其用户归属体系 |
一个 VIB 账户可关联多个不同网站，也可关联同一网站的多个账户；一个游戏账户只能关联一个 VIB 账户；新手奖励仅按第 5.2 节两种资格提供一次，已登录 VIB 且曾关联任意游戏网站的用户不因新增网站或账户再次获得。合作网站为 JS 接入和配置记录的单位，网站内可包含多款供信号选择的具体游戏；现有后台“游戏名称”等字段与网站的映射需按此区分。游戏内不提供 VIB 注册，不把游戏注册当作 VIB 注册。
4. 版本范围
| 功能 | MVP | 后续版本 |
|---|---|---|
| 游戏内悬浮球展示、拖动、点击 | 已确认，用户不能关闭悬浮球 | 按需扩展 |
| AI 剧本、心电图、角标及倒计时 | 已确认交互流程，剧本内容待补充 | 按需扩展 |
| 浮窗购买点数与订阅入口 | 已确认，跳转 PWA 完成 | 按需扩展 |
| VIP 订阅 | 单一 VIP 档位，月付 R$ 29.99／年付 R$ 299.99；每月赠送点数300及另外四项权益，详见 5.4.1 | 按需扩展 |
| 按状态展示消息气泡及多语言 | 已确认 | 按需扩展 |
| 下载 AI 版游戏用户的首次赠送信号 | 已确认；仅限第 5.2 节两种资格，提供一次新手信号，奖励金额代码写死 | 沿用，不因注册重复赠送 |
| 新手体验后的登录门槛 | 新手信号使用完成 5 秒后全游戏遮罩；下载 PWA 或登录 VIB，悬浮球内成功登录前不可关闭 | 沿用 |
| PWA 内 VIB 注册登录、游戏内仅 VIB 登录 | 已确认 | 沿用 |
| PWA 功能介绍、支持游戏列表及下载入口 | 已确认 | 按需扩展 |
| 个人中心、常规账户体系、充点 | 已确认，细则待明确 | 按需扩展 |
| 后台用户列表筛选及详情 | 已确认，来源渠道移至统计 | 按需扩展 |
| 后台用户数据统计 | 五项人数、趋势、投放渠道及网站对比；首次有效渠道归因 | 留存、转化及投放成本 |
| 后台按游戏设置并分发悬浮球配置 | 新增、配置 ID、接入 JS 和网站 RTP | 事件管理及停启用完整方案保留 |
| 后台信号赠送配置 | 仅精简条件奖励配置；新手奖励代码写死 | 新手奖励后台配置保留 |
| 后台游戏管理 | 不纳入 MVP | 保留全局游戏 RTP 方案 |
| 后台财务查询 | 已确认，包含 VIB 充值及送出信号在各游戏平台的奖励金额 | 按需扩展 |
| 信号的目标游戏与下注金额配置 | 明确不纳入 MVP | 已确认，具体配置规则待补充 |
| 公会邀请码、推广链接归属、手动入会 | 不纳入当前 MVP | 已确认 |
| 后台按游戏行为条件奖励信号 | 固定一条打码倍数、最后一次充值百分比范围 | 多条件组合、其余三类条件和当前余额百分比保留 |
5. MVP 需求
MVP 仅考虑巴西货币：巴西雷亚尔（BRL，R$）。点数仍为独立计量单位，金额与点数的充值换算规则待明确。
5.4 VIB AI PWA
v0.29 调整（2026-09-15，已确认）：本次调整仅针对 MVP VIB 端，替代 v0.28 的未登录首页浏览方案；其他端调整待用户补充。
v0.30 补充（2026-09-15，已确认）：新用户下载安装 VIB PWA 后，先依次展示 4 张 Splash 页面，再进入注册页。
新用户首次进入流程
下载安装 VIB PWA → 打开 PWA → Splash 1 → Splash 2 → Splash 3 → Splash 4 → 全屏注册页（可切换登录）→ 建立有效登录态 → 产品内容。
- Splash 属于注册前的新用户引导；展示时不开放首页、游戏网站列表、“我的”或底部导航。
- 第 4 张 Splash 之后进入注册页，沿用全屏认证门槛；完成 Splash 不代表已注册或已登录。
- v0.31 补充（已确认）：4 张 Splash 的具体内容与视觉由 UI 输出。
- Splash 不可跳过，必须依次完成全部 4 张后才进入注册页；不提供跳过入口，也不能直接访问注册页绕过未完成的 Splash。
- Splash 执行中断后，再次进入时从第 1 张开始，重新执行完整的 4 张 Splash，不从中断页续接。
- 原型展示（已确认）：4 页仅显示 Splash1、Splash2、Splash3、Splash4 占位文字，不展示具体内容或插图，具体内容仍由 UI 后续输出。通过“下一步”依次推进，第 4 页为“进入注册页”。切到后台、刷新或关闭重开按中断处理；仅保存安装与引导完成标记。以上为本轮设计与实现假设，正式中断技术判定、完成标记及重装处理仍需细化。
安装与登录门槛
用户必须先下载安装 VIB PWA 才可使用。安装完成不等于已登录；进入已安装的 VIB PWA 后，未登录用户必须先完成认证，才可查看产品内容。
| 状态 | 展示与可操作内容 |
|---|---|
| 未安装 VIB PWA | 全屏安装引导，不展示产品内容及底部导航 |
| 新用户已安装、尚未完成首次引导 | 依次展示 4 张 Splash 页面，之后进入全屏注册页 |
| 已安装、未登录（首次引导之后及其他未登录场景） | 全屏登录注册界面，默认注册页，可切换登录；完整遮挡产品内容与底部导航 |
| 已安装、已登录 | 展示产品内容，可使用“首页／我的”导航 |
- 未登录时不得通过关闭、返回、点击遮挡区域或直接访问内部页面绕过认证；首次 Splash 引导之后，未完成认证始终停留在登录注册界面。
- 退出登录或登录失效后，恢复全屏登录注册界面，默认注册页；产品内容不可继续查看或操作。
- 注册成功后须建立有效登录态，才可展示产品内容；注册字段、验证方式与正式会话规则仍待细化。
- 安装引导优先于 Splash 和登录注册；新用户安装后先走 4 张 Splash，再到注册页；其他场景按实际登录态进入认证界面或产品内容。
首页游戏网站按钮
| 当前 VIB 用户与该网站的关联状态 | 按钮文案 | 点击行为 |
|---|---|---|
| 未关联 | 去玩游戏 | 在系统默认浏览器打开对应游戏的 PWA 下载页 |
| 已关联 | 去玩游戏 | 在系统默认浏览器打开对应游戏的 PWA 下载页 |
- 网站卡片独立显示“已关联／未关联”标签；按钮文字始终为“去玩游戏”，不随关联状态变化，跳转目标和打开方式一致。
- 点击按钮或打开下载页不代表完成账户关联；关联标签依照实际关联记录显示。
- 关联展示按网站区分；多账户关联业务规则保留，具体状态接口与刷新机制待开发细化。
我的及其他页面规则
- “我的”不再显示“已关联游戏账户”模块及列表；此项为展示调整，不删除已有账户关联关系。
- 底部导航仍仅“首页”和“我的”；点数余额、购买及记录入口在“我的”中展示。
- 已登录首页保留移除欢迎区域、安装卡片及“一个档位”提示的规则；VIP 仍为单一档位。
- 现有原型的免填演示登录规则不定义正式认证规则。
| 模块 | 已确认内容 | 待明确内容 |
|---|---|---|
| 安装引导 | 必须先下载安装 VIB PWA；未安装全屏引导 | 安装检测、支持的系统与浏览器、具体操作指引 |
| 首页 | 安装并登录后可见；网站独立标签显示“已关联／未关联”，按钮统一为“去玩游戏”，均在系统默认浏览器打开对应游戏 PWA 下载页 | 各网站下载页 URL、关联状态接口及刷新机制；默认浏览器打开方式需目标设备验证 |
| 新用户 Splash | 内容由 UI 输出；安装后依次展示 4 张，不可跳过，中断后从第 1 张重新执行，完成后进入注册页 | UI 交付内容、切换方式、中断技术判定及完成标记、重装处理 |
| 注册与登录 | 新用户先完成 Splash；未登录全屏遮挡产品内容，默认注册页，允许切换登录 | 注册字段、验证方式、找回密码及会话规则 |
| 个人中心 | 常规账户及充点功能；不展示已关联游戏账户模块 | 资料字段、账户安全、记录范围及注册赠点数量 |
| 订阅 | VIP 月付 R$ 29.99／年付 R$ 299.99，五项权益；续费、到期、退款由第三方决定，项目不提供续费、退款等操作 | 第三方对接与赠点发放规则 |
| 充点 | 失败、取消均放弃本次支付；不提供历史账单继续支付；待到账沿用当前版本逻辑 | 套餐、支付方式、换算及当前版本接口对接 |
验收要点：未安装不能进入产品；新用户安装后依次展示 UI 输出的 4 张 Splash，不可跳过，完整结束后再到全屏注册页；在任一张中断后再次进入均从第 1 张重走全部 4 张；其他未登录场景默认全屏注册，可切换登录且无法绕过；认证成功后才显示内容；退出或登录失效后重新遮挡；两种关联状态标签正确，按钮均显示“去玩游戏”且可点击，在系统默认浏览器打开该游戏 PWA 下载页；“我的”无关联账户模块。此处为方案验收要求，交互原型已同步上述状态与流程；游戏下载页使用本地样例及新窗口演示，不表示真实安装、认证或系统默认浏览器唤起已实现。
支付状态与注册赠点（v0.34 已确认）
- 注册赠送点数数量由用户后续补充；原型示例值不是正式额度。
- 支付失败或用户取消，均视为放弃本次支付；不支持继续支付历史账单，用户再次购买需发起新的支付。
- 待到账处理由研发沿用当前版本逻辑，本次不另行定义超时、轮询或补单规则；需核对现有实现。
- VIP 的续费、到期及退款依据接入第三方规则，项目本身不提供续费、退款等操作。
5.4.1 VIP 订阅
已确认的 MVP 范围：
- 订阅仅设 VIP 一个档位；月付和年付是同一档位的两种付费周期，不是两个会员等级。
- 用户可选择月付 29.99 或年付 299.99；沿用已确认的 MVP 巴西雷亚尔（BRL）币种，界面使用 R$。
- 订阅权益文案按用户原文展示：每月赠送点数300；高峰期优先访问；部分新功能优先体验；可获得额外的信号奖励；专属客服支持。月付、年付展示相同五项权益。
- 游戏内机器人浮窗提供订阅入口，点击后跳转 VIB PWA 完成订阅。
| 付费方式 | 订阅档位 | 价格 | 已确认权益 |
|---|---|---|---|
| 月付 | VIP | R$ 29.99/月 | 上述五项权益 |
| 年付 | VIP | R$ 299.99/年 | 上述五项权益 |
月付和年付订阅均每月赠送 300 点。VIP 续费、到期及退款规则根据接入的第三方确定；项目本身不提供续费、退款等操作。每月赠点到账日、四项服务权益细则、点数有效期及第三方状态对应的赠点／余额处理需研发对接。VIP 赠点与注册赠点分别记录。
订阅订单是否计入后台“VIB 平台所有充值信息”、用户“是否 VIB 充值”筛选，以及是否需要显示 VIP 状态和到期时间，待明确，不默认改变现有统计口径。
v0.20 首页字段与文案
沿用现有浅色、深绿和青柠色原型风格，采用参考图三的内容层级，并结合图二的建模状态字段。
- 主标题“让 AI 帮你发现更多游戏机会”；“AI 实时陪伴分析”标签，说明“游戏进行中，AI 实时分析变化，提供参考信号与操作建议”。
- 四项能力：实时分析、下注参考、智能信号、更好体验。
- 网站区标题“AI 已为你筛选”；各卡片包含品牌、推荐标签、用户规模、RTP、运营时长、AI 建模状态、PWA 支持说明。
- 网站卡片独立显示“已关联／未关联”标签，主按钮统一为“去玩游戏”；两者均在系统默认浏览器打开对应游戏的 PWA 下载页。
- 保留现有示例网站名，人数、RTP、运营时长、筛选与建模状态均为原型样例，非已核实事实。
- 参考图用于内容设计，不作为新增公会专区、多级 VIP 或底部导航的业务指令；底部仍为“首页／我的”，会员仍为单一 VIP 档位。