New VIB 产品需求基线

文档版本：v0.36

文档校订：新手资格仅按游戏账号是否使用过信号判断，与 VIB 账号无关；按游戏账号发放去重；确认 20% 扣点、首次双登录关联、接口倒计时与单一有效期、无退点、新手过期遮罩及重启恢复、切号清空全部信号、支付与第三方 VIP 边界。

更新日期：2026-09-17

状态：需求整理稿，供持续补充；尚非完整开发规格。

依据：当前会话中用户的产品描述、纠正及补充；2026-09-17 合入协作者 prd-c6b5e04-prototype 交付，管理后台业务以该交付为准。尚未核对 VIB 2.0 的现有实现。

原型呈现约定（2026-09-16 已确认）：用于 UI 参考的产品画面不展示 Demo、模拟、样例数据、免填登录、未接入服务等演示说明；实现边界集中到文档。测试状态切换放在产品画面之外。悬浮球登录表单的 VIB 账号使用普通输入框，不使用账号下拉选择组件；密码使用密码输入框。移除演示文案不改变当前原型的本地模拟性质，不代表已接入真实服务。

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 登录表单，并提供前往 VIB AI 注册的入口；在悬浮球内成功登录前不解除。
• 本次明确替代旧“所有操作前先安装”的悬浮球规则；游戏内只提供 VIB 登录，注册在 VIB PWA 完成。新手信号不预扣，也不抵扣注册／登录后赠送的点数。
• 管理后台是否也限定移动端、是否也必须安装 PWA，尚未明确；本次用户群体约束不自动推导后台操作终端。
• 支持的移动操作系统及浏览器、安装状态检测和无法检测时的处理仍需开发评估。

一个 VIB 账户可关联多个不同网站，也可关联同一网站的多个账户；一个游戏账户只能关联一个 VIB 账户；新手资格仅按第 5.2 节的游戏账号信号使用记录判断，与 VIB 账号及关联网站无关；发放按游戏账号去重。合作网站为 JS 接入和配置记录的单位，网站内可包含多款供信号选择的具体游戏；现有后台“游戏名称”等字段与网站的映射需按此区分。游戏内不提供 VIB 注册，不把游戏注册当作 VIB 注册。

跨 PWA 操作与全局 Toast（2026-09-16 已确认）

按本项目确认的跨端交互约束，游戏 PWA 与 VIB AI PWA 的操作入口统一使用手动打开／复制安装链接引导，不再通过按钮自动跳转或打开新窗口。游戏内部的“立即使用”到游戏搜索结果、VIB 内部页面切换不受影响。

• 引导在原卡片内持续可见，Toast 消失不收起引导；告知“已安装请手动打开；未安装请复制安装链接，粘贴到浏览器地址栏打开并安装”。不自动判断对方 PWA 是否安装。
• 安装链接不直接展示给用户，只提供“复制安装链接”按钮；右上角使用醒目的 × 关闭按钮，点击可收起引导。复制完成后，无论成功或失败都收起引导。
• 成功 Toast：“复制成功”；失败 Toast：“复制失败”。正式产品仅剪贴板写入成功才提示成功；链接未配置、能力不可用或权限拒绝均按失败处理，不暴露链接作为失败兜底。再次点击原入口可重新展开。
• 全局 Toast 统一显示在当前页面上方安全区域，并位于登录遮罩等内容之上；不出现在底部，不影响页面按钮点击。原型手机画面的 Toast 显示在手机内部上方。
• 复制、收起引导均不解除强制登录遮罩、不完成注册／充值／订阅、不建立账户关联。注册后手动返回游戏登录 VIB；充值后手动返回并点击“已充值，重试”，按最新余额继续原流程；订阅权益以实际查询结果为准。
• 原型默认模拟复制成功：点击后收起引导并在顶部提示“复制成功”，不调用剪贴板、不依赖真实安装链接。失败反馈“复制失败”保留为评审分支。此模拟说明仅写入文档，不出现在产品画面；正式产品仍需接入真实安装链接与复制结果。

4. 版本范围

5. MVP 需求

MVP 仅考虑巴西货币：巴西雷亚尔（BRL，R$）。点数仍为独立计量单位，金额与点数的充值换算规则待明确。

5.1 游戏内悬浮机器人

v0.32（2026-09-15，已确认）：以下为当前 MVP 方案，替代旧安装前置、新手预扣及每次使用信号执行剧本的规则。交互原型已同步 v0.33，使用本地状态模拟登录、奖励、扣点与游戏进程。

5.1.1 接入方式与基本交互

• 悬浮球通过后台提供的 JS 接入合作游戏网站；下载 AI 版游戏平台并进入游戏后即可看到，无需先登录游戏或安装 VIB。
• 用户可以拖动悬浮球，不能关闭悬浮球。是否响应点击由游戏登录、VIB 登录及账号关联状态决定。
• 消息气泡在球旁，靠左向右展示、靠右向左展示；普通操作浮窗在球旁展开并随拖动移动，可收起，浮窗外游戏区域可操作。
• 消息气泡文案（2026-09-16 已确认／待补充）：气泡文字须随当前状态变化；具体状态清单及每种状态的对应文案由用户后续补充。当前原型内尚未单独确认的气泡文字仅为占位，不作为最终 UI 文案或验收依据。本次不新增状态、文案或多状态优先级规则；后续按补充内容统一维护。已单独确认的关联冲突提示继续保留；未登录游戏时点击悬浮球的“请先登录游戏账号”属于 Toast，按其独立规则处理。
• 例外：新手信号使用后的强制登录遮罩覆盖整个游戏界面，不能按普通浮窗规则收起，详见 5.1.3。
• 游戏内只提供 VIB 登录，注册通过安装引导手动前往 VIB PWA。PWA 内安装、Splash、注册／登录沿用 5.4 节。
• 原型免填账号密码登录仅为历史演示方式，不代表生产认证要求。

5.1.2 登录与关联状态

游戏退出联动（2026-09-16 已确认）：游戏账号退出时，游戏内悬浮球中的 VIB 账号同步登出，收起当前浮窗并解除登录遮罩，恢复游戏未登录状态。点击悬浮球提示“请先登录游戏账号”。再次登录游戏不会自动恢复悬浮球 VIB 登录态；按当前游戏账号的信号使用记录执行既有新手资格及登录遮罩规则。同步登出不解除账号关联、不重置新手奖励发放或信号使用记录；本规则仅涉及游戏内悬浮球的 VIB 会话。

游戏登录门槛与关联冲突优先于剧本和信号流程。“首次点击”定义见 5.1.6，不等于首次获得新手权益。

5.1.3 新手体验与 5 秒强制登录遮罩

1. 用户已下载 AI 版游戏平台、登录游戏账户，未在悬浮球中登录 VIB，且游戏账户未检测到信号使用记录；按 5.2 节新手资格与发放记录去重。
2. 悬浮球显示 1 个未读角标。首次点击打开浮窗，自动开始剧本；结束后告知有一个信号待使用。
3. 点击“使用信号”展示多款游戏；选择后展示推荐配置并开始倒计时；点击“立即使用”仅帮助跳转指定游戏搜索结果，用户手动进入游戏。
4. 显示建议下注金额及倒计时。在指定游戏、倒计时内按建议金额下注，标记新手信号已使用。此新手体验不扣点，不生成待扣债务。
5. 从“新手信号使用完成”事件起延迟 5 秒，用户仍未在悬浮球内登录 VIB 时，自动显示覆盖整个游戏界面的遮罩；无需再次点击球。不是从选择游戏、点击使用或奖励结算时起算。
6. 遮罩默认直接展示 VIB 账号输入框、密码输入框及登录按钮，不需要先点击按钮展开表单；另提供“没有账号？前往 VIB AI 注册”入口。没有关闭、稍后或跳过入口，点击空白、返回普通浮窗或收起操作不能解除遮罩，底层游戏不可操作。
7. 注册入口引导到 VIB AI，按既有安装／注册流程完成后返回游戏，在遮罩内登录 VIB；遮罩本身不提供注册表单。仅下载、安装、注册或在 PWA 登录，均不等于已在悬浮球登录，不能解除游戏遮罩。
8. 悬浮球内登录成功后解除遮罩，用户可继续游戏；后续信号须通过账号关联校验，按正常规则获取和使用。登录失败保留遮罩及重试入口；关联冲突仍按 5.1.2 禁止分析和获取信号。
9. 如在 5 秒内已完成悬浮球 VIB 登录，不再显示过时的登录遮罩。关闭普通浮窗不取消该计时。
10. 游戏已登录、VIB 未登录时，若检测到游戏账户已有信号使用记录，直接显示上述遮罩，无需点击悬浮球，不重新等待 5 秒。本次会话刚完成新手使用则沿用第 5 条的 5 秒延迟，重复检测不提前结束或重置这段延迟。游戏未登录或 VIB 已登录时不触发此登录遮罩。

原型评审入口（本次补充）：右侧“满屏限制 · 新手已使用”和“满屏限制 · 新手已过期”直接展示全游戏限制。正常使用路径仍在匹配下注完成后延迟 5 秒；过期路径暂按立即显示实现（演示假设，业务延迟待确认）。两种限制均可演示下载返回、登录失败重试、成功解锁和模拟重开恢复。满屏指手机中的完整游戏区域。v0.35 起当前标签页刷新恢复演示状态，点击评审场景重置；真实进程持久化尚未接入。

遮罩文案提案：标题“登录 VIB 后继续游戏”；直接展示账号、密码及“登录 VIB 账号”按钮；下方提供“没有账号？前往 VIB AI 注册”入口。登录表单和错误提示位于遮罩内，输入失败后可重试。该文字为设计提案，固定账号冲突文案按用户原文执行。

v0.34 已确认：新手信号未使用而过期也触发强制登录遮罩；重启游戏后仍恢复遮罩，不能通过重启绕过。使用完成后继续沿用 5 秒延迟；过期触发是否也延迟 5 秒尚未说明。游戏退出时按 5.1.2 同步登出悬浮球 VIB；持久化、剩余计时恢复及会话清理的技术处理由研发细化。

5.1.4 点数不足与正常信号流程

• 无信号时，浮窗提示没有可用信号；信号获取仍依据已确认奖励条件。MVP 气泡包含点数不足、游戏余额不足及活动等场景；事件管理和消息配置不属于 MVP 后台。
• 有信号时，首次有效点击按 5.1.6 执行剧本；剧本结束展示信号状态。此后同一游戏进程会话内点击“使用信号”直接展示可选游戏，不重复剧本。
• 扣点位置：用户确认选择某一款具体游戏时。确认界面展示该游戏所需点数和当前 VIB 点数；校验足额并扣点成功后，再推进跳转和下注引导。匹配下注仅标记使用完成，不再次扣点；奖励结算不作为扣点触发事件。
• 选定游戏后的点数不足界面：游戏与 VIB 均已登录、无关联冲突、有普通待用信号时，允许查看信号及选择游戏。选定具体游戏后、生成推荐配置前，按本次信号预计消耗校验点数；不足则展示独立的“VIB 点数不足”球旁浮窗，足够且扣点成功才生成推荐配置并开始倒计时。已进入不足状态后再次打开仍显示不足页，不重复剧本。新手免费体验不进入此状态，无信号仍显示无信号页面。
• 界面提示“VIB 点数不足”及补足点数后继续，可保留待用信号数；卡片展示“当前点数余额”和“信号预计消耗点数”，预计消耗指本次一份信号，按现有扣点规则计算。主操作“去 VIB 购买点数”展开 VIB AI 安装与充值引导，新增“已充值，重试”按钮；不提供“返回游戏”按钮或“查看可选游戏”入口；不展示“尚未扣点或使用信号……”说明。所需点数依据当前信号奖励及 20% 扣点规则计算；原型正常信号为 16 点，不使用固定 20 点阈值。所需点数用于选定游戏、生成配置前的内部校验。
• 不足时不扣点、不消耗信号、不产生具体游戏信号或启动倒计时；仍可通过卡片顶部通用“收起”操作收起浮窗。购买取消、失败或尚未到账时保持不足状态。点击“已充值，重试”后获取最新账户点数并更新卡片数值：仍不足则保留当前卡片、已选游戏和重试按钮；足够则直接继续已选游戏的流程，校验并扣点成功后展示推荐配置、开始倒计时，无需重新选择游戏。静态原型以评审面板“模拟购买成功”更新点数，未接入跨页支付与余额服务。
• 点数不足提示位置：放在选定游戏、生成推荐配置前的校验环节，不能等用户进游戏、按建议下注后才提示。文案仅提示“VIB 点数不足”及补足后继续，不显示差额和“尚未扣点或使用信号……”说明。提供“去 VIB 购买点数”，展开安装引导，由用户手动前往 VIB 充值；不足时不完成该游戏的扣点确认，不消耗信号、不开始该次下注引导。
• 球旁可同步展示点数不足气泡与状态样式，辅助提示不替代选定游戏时的余额校验。VIB 点数与游戏账户余额分开表达。
• 购买后返回由用户点击“已充值，重试”刷新余额并继续；仅打开购买页或返回游戏不视为到账，也不自动扣点。重复点击重试不能重复扣点或重置倒计时；查询失败保留卡片与原数值并提示重试，不视为足额。
• 重复点击／请求重试不能重复扣点。扣点失败不显示成功；扣点成功后不存在退点逻辑，过期、放弃、跳转失败或切号均不退点。

普通信号使用完成后的点数提示（2026-09-16 已确认）

• 仅在非新手信号实际使用完成时自动展示一个新的小浮窗；选择游戏、生成配置、打开搜索结果、未匹配下注、信号过期均不触发。新手信号不展示，沿用现有使用后界面与 5 秒登录遮罩规则。
• 浮窗仅包含三个元素：本次消耗点数、账户剩余点数、关闭浮窗按钮。本次消耗取该信号已经成功扣除的实际点数；剩余点数取使用完成时的账户余额，不能以当前配置重新估算或再次扣除。
• 关闭按钮显示 “关闭（3秒）”→“关闭（2秒）”→“关闭（1秒）”；浮窗出现即开始计时，用户可随时提前关闭，满 3 秒自动关闭。小浮窗不遮挡整个游戏、不阻断游戏操作，区别于信号卡片和全屏登录遮罩。
• 关闭后按剩余信号数量显示剩余信号数／暂无信号卡片，不新增“信号已使用”卡片。重复点击下注或重绘不重复弹出、不重新计时；刷新只恢复尚未结束的剩余时间，已关闭或已结束不重播。
• 游戏退出或切换账号时关闭该提示，避免继续展示原账号余额。扣点时机仍为选定游戏、生成配置前；本浮窗只告知已发生的点数消耗，不代表再次扣点或奖励结算。

5.1.5 账户关联与切换

• 一个 VIB 账户可关联多个游戏账户（包括同网站多个账户），一个游戏账户只能关联一个 VIB 账户。游戏账户身份需结合网站标识区分，不能仅凭跨网站可能重复的游戏 ID 关联。
• 检测到当前游戏账户已关联其他 VIB 时，机器人气泡准确显示：“当前游戏账户已与其他VIBAI账户关联”。停止分析和获取信号，不覆盖原关联，也不能使用其他账户遗留信号。
• 切换游戏账户会清空所有信号，不以悬浮球是否登录 VIB 为前提；重新校验新游戏账户的关联状态，旧账户待下注指引和异步返回不得继续作用于新账户。
• 切号清空全部信号后，切回旧账户不恢复被清空的信号；已扣点不退。清空信号不等于删除历史使用与财务记录。
• 关联发生在游戏 PWA：用户先登录游戏账户，再在悬浮窗成功登录 VIB，首次产生关联。已有相同关联直接沿用，已有其他 VIB 关联不覆盖。解除／更换关联能力未定义。切号不重置游戏进程内的剧本首次标记。

5.1.6 剧本触发、收起与会话定义

• “首次”指从未打开过游戏，或用户杀掉游戏进程后再次打开，在该次游戏进程会话内首次有效点击悬浮机器人。
• 首次有效点击即打开界面并自动走剧本；游戏未登录、需先登录原关联 VIB 或关联冲突时，先执行对应门槛，不能绕过校验开始分析。
• 同一游戏进程会话内，后续获取、使用信号均不再走剧本；不能按信号数量或点击次数重复执行。重启后剧本可再次触发，但不重置新手奖励领取／使用记录，不重复送新手信号。
• 剧本运行时可关闭普通浮窗，剧本继续执行。随时重新打开看到当前进度；已经结束时显示结束后的信号状态，不从头播放。
• 悬浮球在剧本期间显示心电图效果；收起不清除运行状态。剧本内容、时长、是否可主动跳过仍待明确，展示不代表实际分析效果验证。
• v0.33 进程定义（已确认）：剧本只在游戏内悬浮窗执行，因此此处进程明确指游戏进程，不是独立 VIB PWA 的进程。仅关闭或重开 VIB PWA 不重置游戏内剧本的首次标记。游戏进程内收起浮窗、切换游戏账户不重置该标记；JS 对游戏进程生命周期的识别及跨搜索结果页状态保持仍需开发实现，不能将组件挂载、页面刷新或切到后台直接等同杀掉游戏进程。

5.1.7 视觉与交互交付要求

新增信号震动反馈（2026-09-16 已确认）：游戏内收到一个新增信号时，尝试触发一次手机震动，仅适用于支持此能力的 Android 手机。震动是可选增强，不作为信号发放、展示或使用的前置条件；设备不支持、系统／浏览器限制、调用失败时静默跳过，不阻断流程，不强制要求开启震动或更换设备。

• 5 秒震动去重：从首次震动尝试起计算 5 秒窗口；期间连续新增多个信号，只尝试震动一次，信号正常累计。后续新增不会延长窗口，到达 5 秒后再次收到新信号才可触发下一次，不在窗口结束时补震。调用失败也不在窗口内重复尝试。
• 新手信号及后续条件奖励的实际新增均受上述 5 秒窗口限制；已有信号重绘、打开卡片、刷新恢复、重复检查资格不重复触发。
• 以已确认的新信号到账事件触发，不能仅根据重新渲染或加载到已有信号判断；真实服务需结合信号标识避免重复通知。
• 原型尝试调用 Android 手机浏览器的震动能力，采用 120 毫秒单次短震动作为临时演示参数；正式时长／节奏后续确定。浏览器调用验证不代表已完成 Android 真机震感验证。

• 普通球旁浮窗保留拖动跟随、左右避让和收起能力；新手强制登录遮罩为独立的全游戏状态。
• 正常有信号展示角标；新手入口明确显示 1 个未读角标。一般角标按全部可用还是未读计数、已读清除规则待明确。
• 产生信号并明确使用哪款游戏后开始计算有效期；倒计时由游戏相关接口提供。建议下注金额与倒计时在球旁展示，倒计时相对球水平居中并随拖动定位，靠底边向上避让。
• 球体保留剧本、点数不足、游戏余额不足的文字／图标区分；不能只靠颜色区分状态。
• 购买点数、订阅通过复制安装链接引导手动前往 VIB PWA；游戏内不完成支付。移动端长文案和键盘弹起时仍需可见当前操作，遮罩内管理焦点、阻断底层点击，错误提示可感知。

5.2 首次赠送信号

已确认：

1. 首次赠送面向下载 AI 版游戏的新用户，不以新注册 VIB 账户作为发放依据。
2. 符合资格的 AI 版游戏新用户可按 5.1.3 先体验再安装／注册 VIB。MVP 新手信号赠送数量及奖励金额均在代码中写死，不提供后台配置；本次入口呈现 1 个未读角标、1 个待使用信号，正式奖励金额未提供。
3. 信号出现后展示多款游戏供用户选择，选定后提供建议下注金额及倒计时。用户在倒计时结束前进入指定游戏并按建议金额下注，即完成信号使用。未按建议金额下注或玩其他游戏视为未使用；倒计时结束即信号过期。对应内容来源待定，目标游戏与下注金额的后台配置能力仍不纳入 MVP。
4. 注册 VIB 不额外重复赠送新手信号。有效期仅在产生信号并明确使用哪款游戏后开始，时长由游戏相关接口提供；倒计时内未使用即过期，视为放弃新手奖励信号。使用信号及有效期沿用当前版本逻辑。
5. 新手信号使用完成 5 秒后，未登录悬浮球 VIB 的用户进入不可关闭的登录遮罩；未使用而过期也触发遮罩，重启后仍恢复。过期触发延迟尚未说明。新手体验不预扣、不抵扣赠点。

新手奖励资格（2026-09-16 已确认）：

新手资格仅依靠游戏账号是否使用过信号判断，与 VIB 账号没有任何关联。

• VIB 是否注册、是否登录、是否关联当前或其他网站、是否曾在其他游戏账号获得新手奖励，均不参与资格判定。
• 同一 VIB 关联的不同游戏账号分别按各自使用记录判断；切换 VIB 账号不改变当前游戏账号的资格。
• 资格与发放去重分开：仍按游戏账号奖励发放记录提供一次；已有待使用信号不重复生成，刷新、重开或注册不重发；已发新手信号过期仍按放弃处理。此规则不将“未使用过”解释为每次都重新发放。
• 游戏登录和既有账户关联冲突阻断继续作为服务操作门槛，不作为新手资格判据；关联关系仍按原规则管理。
• 游戏平台维护使用记录和发放记录，首次登录、账号切换及跨端同步按同一游戏账号归并，不再按 VIB 账号或关联网站判断新手权益。

有效期（v0.34）：仅在产生信号并明确使用哪款游戏后开始，倒计时由游戏相关接口提供；到期未使用即过期。使用信号及有效期沿用当前版本逻辑，不在本次流程调整中新增有效期变更。

5.3 主要用户流程

搜索结果步骤口径（2026-09-16 已确认）：使用信号及有效期沿用当前版本逻辑。本次流程说明不再使用“打开搜索结果本身不算使用信号，取消旧 30 天有效期”的表述，也不据此新增或取消有效期规则。此前确认的推荐配置卡片倒计时、收起后持续计时和“立即使用”仅帮助跳转的交互保持。

2026-09-16 流程纠正（已确认）：选择游戏后展示“推荐配置已生成，可立即使用”卡片，包含游戏信息、建议金额、使用倒计时与“立即使用”按钮；未登录 VIB 的新手也采用相同界面与跳转流程。点击“立即使用”后进入该游戏的搜索结果界面，再由用户手动进入游戏。此说明替代旧“核对金额，确认游戏”的独立明细确认页。下文“确认游戏扣点”对应选定游戏、生成推荐配置前的操作，既有扣点公式及未登录新手免费规则保持。进入配置卡片时倒计时已开始，收起卡片也继续，再打开或点击立即使用均不重置；立即使用仅为跳转辅助，无需点击也可自行进入指定游戏，在倒计时内按建议金额匹配下注；附件金额、时长和游戏名称仅为示例。

1. 下载 AI 版游戏平台 → 进入游戏看到悬浮球。游戏未登录时，点击球显示 Toast：“请先登录游戏账号”。
2. 游戏已登录、游戏账户未检测到信号使用记录、悬浮球 VIB 未登录的新手 → 1 个未读角标 → 首次点击自动剧本 → 1 个待使用信号。
3. 使用新手信号 → 选择具体游戏 → 展示推荐配置（建议金额、使用倒计时）→ 点击“立即使用” → 跳转该游戏搜索结果 → 手动进入 → 倒计时内匹配下注 → 标记已使用；该体验不扣点。
4. 使用完成 5 秒后仍未登录悬浮球 VIB → 全游戏强制登录遮罩 → 直接填写登录表单；无账号则前往 VIB AI 注册。
5. 在悬浮球内登录成功 → 解除遮罩、继续游戏；通过关联校验后可使用后续获得的信号。同一游戏进程会话不再走剧本。
6. 普通信号 → 点击使用 → 展示多款游戏 → 选定某款时校验并扣除 VIB 点数 → 生成推荐配置并开始倒计时 → 点击“立即使用”仅跳转该游戏搜索结果。点数不足则在生成配置前提示去 VIB 购买点数。

信号使用后的卡片（2026-09-16 已确认）：不展示“信号已使用”状态卡片。普通信号使用完成后，先显示下述点数消耗小浮窗；关闭后，有其他待使用信号则显示剩余信号数界面，无可用信号则显示“暂无信号”卡片，无需额外点击“查看剩余信号”。新手信号不显示点数消耗小浮窗，直接显示对应的剩余／暂无信号卡片。“已使用”可作为内部记录，不作为卡片状态。未登录新手使用完成 5 秒后的登录遮罩规则保持。

使用、扣点及奖励结算是三个不同事件：

有效期（v0.34）：产生信号并明确具体游戏后，按游戏相关接口提供的倒计时计算有效期；到期未使用即过期，新手同时触发登录遮罩。金额不匹配或其他游戏下注不算使用。信号可累计，切换游戏账户清空所有信号，无退点逻辑。一次下注能否匹配多份信号仍待明确。

v0.33 奖励金额来源与扣点（已确认）：

普通信号扣点数 = ceil（（该信号奖励金额 − 下注金额）× 0.20），ceil 为向上取整。推荐配置卡片展示配置已生成状态、游戏信息、建议金额、使用倒计时和“立即使用”按钮；选定游戏时校验余额并扣点，成功后生成配置；“立即使用”仅跳转所选游戏搜索结果；不等待游戏下注后的实际结算金额才扣点。游戏侧实际结算金额独立记录。

当前后台沿用最后一次充值金额百分比上下限配置，先按配置确定该信号的具体奖励金额，再用于确认游戏时的扣点；范围内具体取值算法及金额精度仍待细化。该技术细则不改变“正常信号奖励来源为后台配置”的已确认结论，不新增固定金额配置方式。

新手赠点规则：本次新手体验不扣点，不生成预扣记录，注册／登录赠送点数到账后不抵扣本次新手消耗。注册赠点权益保留，数量及是否存在独立登录赠点规则未明确；不推导成每次登录都赠点。历史“注册赠点先抵扣、不足扣到 0”规则取消。此前“已登录用户使用新手信号按公式实际扣点”的特殊分支是否也统一免费需进一步明确，不沿用该旧描述作为本次未登录新手体验的计费依据。

实施前待明确：后台配置范围内金额取值算法、非正差额处理、点数换算、倒计时接口字段与异常处理、换游戏及错误下注后的重试规则。已确认扣点成功后不退点，切号清空全部信号。

5.3.1 本轮验收清单

以上为产品验收标准；v0.33 静态原型验证对应模拟交互，详见 prototype/check-v33.cjs。真实服务接入与游戏进程识别仍需独立验证。

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 后，未登录用户必须先完成认证，才可查看产品内容。

• 未登录时不得通过关闭、返回、点击遮挡区域或直接访问内部页面绕过认证；首次 Splash 引导之后，未完成认证始终停留在登录注册界面。
• 退出登录或登录失效后，恢复全屏登录注册界面，默认注册页；产品内容不可继续查看或操作。
• 注册成功后须建立有效登录态，才可展示产品内容；注册字段、验证方式与正式会话规则仍待细化。
• 安装引导优先于 Splash 和登录注册；新用户安装后先走 4 张 Splash，再到注册页；其他场景按实际登录态进入认证界面或产品内容。

首页游戏网站按钮

• 网站卡片独立显示“已关联／未关联”标签；按钮文字始终为“去玩游戏”，不随关联状态变化，安装链接与手动打开方式一致。
• 点击按钮或打开下载页不代表完成账户关联；关联标签依照实际关联记录显示。
• 关联展示按网站区分；多账户关联业务规则保留，具体状态接口与刷新机制待开发细化。

我的及其他页面规则

• “我的”不再显示“已关联游戏账户”模块及列表；此项为展示调整，不删除已有账户关联关系。
• 底部导航仍仅“首页”和“我的”；点数余额、购买及记录入口在“我的”中展示。
• 已登录首页保留移除欢迎区域、安装卡片及“一个档位”提示的规则；VIP 仍为单一档位。
• 现有原型的免填演示登录规则不定义正式认证规则。

验收要点：未安装不能进入产品；新用户安装后依次展示 UI 输出的 4 张 Splash，不可跳过，完整结束后再到全屏注册页；在任一张中断后再次进入均从第 1 张重走全部 4 张；其他未登录场景默认全屏注册，可切换登录且无法绕过；认证成功后才显示内容；退出或登录失效后重新遮挡；两种关联状态标签正确，按钮均显示“去玩游戏”且可点击，展开该游戏安装引导，不自动跳转，复制链接后由用户粘贴到浏览器打开；“我的”无关联账户模块。此处为方案验收要求，交互原型已同步上述状态与流程；跨端入口已改为复制安装链接与手动打开引导；正式链接待配置，真实安装、认证仍需对接。

支付状态与注册赠点（v0.34 已确认）

• 注册赠送点数数量由用户后续补充；原型示例值不是正式额度。
• 支付失败或用户取消，均视为放弃本次支付；不支持继续支付历史账单，用户再次购买需发起新的支付。
• 待到账处理由研发沿用当前版本逻辑，本次不另行定义超时、轮询或补单规则；需核对现有实现。
• VIP 的续费、到期及退款依据接入第三方规则，项目本身不提供续费、退款等操作。

5.4.1 VIP 订阅

已确认的 MVP 范围：

• 订阅仅设 VIP 一个档位；月付和年付是同一档位的两种付费周期，不是两个会员等级。
• 用户可选择月付 29.99 或年付 299.99；沿用已确认的 MVP 巴西雷亚尔（BRL）币种，界面使用 R$。
• 订阅权益文案按用户原文展示：每月赠送点数300；高峰期优先访问；部分新功能优先体验；可获得额外的信号奖励；专属客服支持。月付、年付展示相同五项权益。
• 游戏内机器人浮窗提供订阅入口，点击后展开 VIB 安装引导，手动前往 VIB PWA 完成订阅。

月付和年付订阅均每月赠送 300 点。VIP 续费、到期及退款规则根据接入的第三方确定；项目本身不提供续费、退款等操作。每月赠点到账日、四项服务权益细则、点数有效期及第三方状态对应的赠点／余额处理需研发对接。VIP 赠点与注册赠点分别记录。

订阅订单是否计入后台“VIB 平台所有充值信息”、用户“是否 VIB 充值”筛选，以及是否需要显示 VIP 状态和到期时间，待明确，不默认改变现有统计口径。

v0.20 首页字段与文案

沿用现有浅色、深绿和青柠色原型风格，采用参考图三的内容层级，并结合图二的建模状态字段。

• 主标题“让 AI 帮你发现更多游戏机会”；“AI 实时陪伴分析”标签，说明“游戏进行中，AI 实时分析变化，提供参考信号与操作建议”。
• 四项能力：实时分析、下注参考、智能信号、更好体验。
• 网站区标题“AI 已为你筛选”；各卡片包含品牌、推荐标签、用户规模、RTP、运营时长、AI 建模状态、PWA 支持说明。
• 网站卡片独立显示“已关联／未关联”标签，主按钮统一为“去玩游戏”；两者均展开该游戏安装引导，复制链接后由用户粘贴到浏览器打开。
• 保留现有示例网站名，人数、RTP、运营时长、筛选与建模状态均为原型样例，非已核实事实。
• 参考图用于内容设计，不作为新增公会专区、多级 VIP 或底部导航的业务指令；底部仍为“首页／我的”，会员仍为单一 VIP 档位。

5.5 MVP 管理后台

v0.36 协作者方案合并（2026-09-17）：按用户要求，管理后台业务以协作者交付为准；本节同步其菜单、表单、报表与诊断方案。新增功能纳入当前后台方案，原型完成程度单独列明，不将静态展示视为真实服务实现。生命周期模型中的跨端增长假设不自动替代 VIB／悬浮球的已确认交互。

v0.23 范围调整（2026-09-14，已确认）：原有模块沿用以下范围，新增渠道模块见本节补充。原完整后台方案保留在第 6.4 节；其中历史 MVP 描述不再代表本期范围。

后台仅展示本期可操作菜单及字段。原有活动停启用等敏感操作继续二次确认；取消、关闭或 Escape 不修改该待确认操作。新增推广商开关沿用协作者的即时修改方式；推广商管理弹窗的取消只关闭弹窗，不回滚已经保存或切换的记录。规则说明集中于文档，页面保留单位和必要的操作影响提示。

5.5.1 用户列表

v0.27 用户确认采用：用户列表与用户数据统计独立成模块。来源渠道属于投放落地页参数，仅用于统计；用户列表无渠道筛选、列及详情项。

• 以 VIB 用户 ID 为一行；同站多个游戏账户放入详情，不重复生成用户行。
• 默认显示 ID、手机号、注册时间、关联网站、PWA 安装状态，以及当前已确认的 VIB／游戏充值状态。注册时间加入列表展示；来源渠道不在用户列表筛选、列或详情中展示。
• 常用筛选优先展示用户 ID／手机号／游戏账户 ID、注册时间和关联网站；充值状态、安装状态、新手信号状态、国家放入更多筛选。多项查询的组合逻辑保留清楚提示。
• 日期筛选明确写“注册时间”，按 VIB 注册时间筛选。不得与统计页的行为发生时间混用。
• 详情按基本资料、关联网站账户、信号记录、充值记录分区；延续查看能力，不新增修改用户、手工发奖或封禁操作。
• 游戏充值状态按所选网站判断，并能在详情逐账户核实。无网站筛选时展示是否任一关联网站充值；VIB 充值和游戏充值始终分开。

5.5.2 悬浮机器人管理

• 合作网站列表保留网站名称、配置 ID、接入 JS、独立 RTP 随机范围及刷新时间；新增网站生成配置 ID 和 JS 示例。
• 不提供事件管理入口、事件编辑／导入流程、机器人状态列及停启用操作；新增操作文案只描述创建接入配置。
• 网站 RTP 新增／编辑沿用原范围和时间校验；独立“游戏管理”及全局游戏 RTP 配置不纳入 MVP。网站 RTP 不随游戏管理一起移除。
• 用户端已有状态气泡和多语言展示需求继续保留；本次仅取消后台配置能力，不定义新的事件分发实现。
• 网站字段、ID 生成、正式 JS 分发和 RTP 生效细则仍待开发细化。原型使用示例数据，保存仅当前页面有效。

5.5.3 信号赠送配置

新手奖励信号：MVP 不做后台配置，规则在代码中写死。新手资格、先体验后登录、按游戏账号使用记录判定并发放去重、注册不重复赠送及信号有效期沿用第 5.2 节。赠送数量及奖励金额代码写死，正式奖励金额和网站差异尚未明确，不把旧后台示例值视为正式常量；已有原型仅演示状态，不实现真实发奖。

信号奖励配置：

v0.33 补充（已确认）：后续正常使用的信号奖励金额由此处管理后台配置；对应信号的具体奖励金额供悬浮球在确认游戏时计算点数。新手奖励金额仍由 MVP 代码写死，二者分别处理。

• 保留已开启活动列表、新建、按活动名称／ID 搜索、活动停启用、摘要和保存校验；取消或离开不保留未保存内容。
• 已有信号奖励活动不提供编辑入口及修改保存流程；创建后可查看列表和停启用。完整方案继续保留活动编辑能力。
• 条件类型只保留“达到指定打码倍数”，参数为目标倍数。每个活动固定一条打码倍数条件，不提供增加／删除条件和 AND 组合操作；不提供输钱、赢钱、时段充值条件或其时间／比例／金额字段。
• 打码倍数 = 打码量 ÷ 累计充值金额；仅向上达到目标触发，下降至目标不触发，下降后再次上升达到目标可再次获得。统计起点、有效打码范围及越过目标的判定待明确。
• 奖励只保留“最后一次充值金额的百分比”，沿用现有百分比上下限，自动选定该方式，不提供当前余额选项。以条件满足时对应网站最后一次充值金额 R 计算 [R × p_min，R × p_max]，百分比按比例参与计算，金额使用 BRL。
• MVP 规则统一适用于所有网站（含后续新增网站），不提供按网站选择或分别配置；以全局范围保存，不保存创建时的网站 ID 快照。各网站仍按自身数据独立判断，不合并跨网站充值或打码；无充值记录或相关基数为零不满足条件。范围内最终金额、精度及业务上限仍待明确。
• 安装 PWA、注册和游戏内机器人登录前提保持不变，无报名流程。达到该条件发一份信号；持续满足只发一次，信号可累计，重新满足次数不限。
• 多活动同时命中、规则修改后的再次命中识别及到账／领取细则仍待明确。

MVP 验收：菜单没有游戏管理和新手奖励配置；合作网站没有事件管理及停启用；新建活动固定一条打码倍数条件，仅设置目标倍数和最后一次充值百分比，无网站选择、条件增删及组合，已创建活动没有编辑操作；旧完整方案不能作为本期活动载入或启用；网站 RTP、用户查询和财务查询仍可操作。

5.5.4 财务管理

v0.17 补充：指定游戏网站支持复选多选。原型中的网站筛选在信号游戏奖励查询中展示；多选按任一网站匹配，不勾选表示全部。VIB 充值本身无已确认的网站归属，不新增网站关联口径。

两类数据分别对应平台充值与信号在游戏侧的奖励，不自动合并为 VIB 收入。奖励金额的结算口径、时间字段、明细与汇总展示粒度，以及信号与游戏奖励的关联方式待明确。当前没有提出退款、提现、结算操作或报表导出要求。

游戏数据采集接口、信号生成机制、账户和支付服务的后台实现方式尚未定义；上述查询能力依赖相应数据接入，不视为技术依赖已解决。

5.5.5 用户数据统计

2026-09-14 原型实现补充：用户列表常用／更多筛选、四个详情分区，及统计五项人数、趋势、渠道／网站对比和行为人群下钻已实现。示例日期固定 2026-09-14，更新时间 12:00，时区 UTC−03:00 为演示假设，最长 366 天为原型限制。真实渠道采集／跨端归因未实现；本地示例验证统计口径，不代表真实运营数据。

页面依次放统计周期与渠道／网站筛选、核心指标、按日趋势、渠道／网站对比表。对比表按维度切换，避免一次堆叠多张表。首期采用固定指标，不增加自定义报表。

五项指标都按 VIB 用户 ID 去重。新手／打码奖励可按信号类型拆分，合计仍需去重。未关联到 VIB 身份的注册前记录暂不混入去重人数，归并机制待明确。

统计口径与下钻

• 总览按 VIB ID 去重；按网站分别统计同一用户可出现在多站，因此网站分组人数不可直接相加作为总人数。
• 渠道代表投放获客来源，网站代表行为发生场所。渠道对比展示五项指标；网站对比仅展示活跃、获得信号、使用信号人数。注册与 VIB 充值暂无网站归属，选网站时这两项显示“暂不支持按网站统计”，不展示未筛选总数。
• 统计周期默认最近 7 天，可切换今天／昨天／30 天／自定义；展示采用的业务时区和数据更新时间。业务时区待确认，不直接采用后台操作者电脑时区。
• 点击指标或对比行可进入对应用户列表，带上“统计周期内使用过信号”等明确条件及名单范围；不能直接把统计日期传给注册日期筛选。若后端暂不支持行为筛选，首期不显示不可用的下钻链接。
• 安装检测目前仍待评估；保留已安装／未安装／未知三态。检测未知不算未安装，安装率暂不列核心指标。
• 不将同周期使用人数 ÷ 同周期发放人数直接命名为信号转化率：本周期可能使用历史信号。后续若增加转化率，以同一批发放信号及固定观察窗口关联实际使用；未成熟窗口单独标注。
• 游戏奖励金额不作为 VIB 收入。收入与对账继续归财务，用户统计只回答多少用户充值／使用。

首期与后续范围

首期：两个独立菜单；用户列表保留已有能力并收起低频筛选；统计页先做上述五项人数、按日趋势及渠道／网站对比。活跃定义和网站维度按本方案执行；开发前确认业务时区及数据可得性，缺失数据标为暂无数据，不能显示虚构零值。

用户数据统计模块后续扩展：同批信号使用转化、新用户激活、VIP 转化。次日／7 日留存与渠道转化已于 2026-09-17 纳入独立推广渠道报表方案；正式实现前仍须明确人群和观察窗口。

当前实现仅为静态演示。新增统计模块需真实的注册、登录、信号发放／使用、充值事件及用户／网站关联数据；现有样例不足以证明真实趋势或转化。

投放渠道参数与归因

• 来源渠道来自投放落地页链接携带的渠道参数，归入用户数据统计及推广渠道报表，用户列表不提供独立渠道筛选、列或详情项。
• 落地页捕获有效渠道参数，在后续跳转、PWA 安装引导及注册链路中保留；注册成功时关联到 VIB 用户 ID。跨端传递与身份关联能力需开发验证，不默认已有实现。
• 同一用户注册前接触多个渠道，以首次捕获到的有效渠道参数作为归属；注册后固定，后续访问其他投放链接不覆盖。
• 注册成功时没有有效可关联参数，归入“未归因”；不能直接判定为自然流量。后续登录携带渠道参数不自动修改既有归属。
• 渠道筛选与对比表使用渠道参数对应名称，例如 CC、naoteng、test；正式有效值判定、名称映射和注册前保留期限待明确；2026-09-17 已新增推广渠道配置方案，交付链接采用 ch 参数。
• 统计周期限制注册／登录／发放／使用／充值事件的发生时间；按渠道看后续行为时不要求用户也在本周期注册，避免把行为统计误做新用户队列统计。
• 从渠道统计下钻时，由统计页传入只读的渠道人群范围，与周期内行为条件共同筛选；列表显示统计范围及清除入口，不新增普通渠道筛选和渠道列。尚不能准确查询该人群时不开放下钻。
• 用户数据统计继续统计各投放渠道带来的注册与后续行为人数。独立推广渠道报表已纳入访问、转化与成本方案；访问事件和广告花费仍待真实接入，不能将样例报表视为数据已可用。

趋势、状态与用户详情补充

• 按日趋势支持五项指标切换，每天独立去重；周期总人数重新去重，不能直接累加每天人数。
• 今天显示统计截止时间，业务时区与数据更新时间统一展示；缺失／同步失败显示暂无数据，真实无业务且数据完整时才显示 0。
• 信号实际使用以指定游戏、建议金额、倒计时内匹配下注为准；发放、使用、扣点分开记录，不以注册或点击使用替代。
• 详情分区为基本资料、关联网站账户、信号记录、充值记录；VIB 充值与网站账户充值分开。保留只读查询能力，不增加用户编辑或手工发奖。
• 游戏账户 ID 不保证跨网站唯一，可结合网站检索；不指定网站时显示全部匹配用户。网站关联与充值条件必须在同一网站账户范围内匹配。

待明确事项与验收

待明确：业务时区、更新频率、跨端渠道传递、参数及有效值、注册前参数保留期限、注册前身份关联、VIP 是否计入充值人数、退款后的历史人数处理及下钻数据能力。

验收：用户列表无渠道字段；同一 VIB 用户只占一行；渠道参数首次有效捕获后归属固定，注册后不覆盖，缺失归未归因；统计筛选作用于对应事件时间；网站不强行归属注册和 VIB 充值；多站人数和每日人数不简单相加；无匹配下注不计使用，待支付／失败不计充值；数据缺失不显示为零；下钻不误用注册时间且不重新引入普通渠道筛选。

5.5.6 推广渠道与推广商管理（2026-09-17 合入）

• 导航包含推广渠道管理、仿应用商店、推广渠道报表；“推广效果报表”沿用交付中的占位入口，当前返回渠道管理，不代表已有独立报表。
• 渠道列表展示渠道名称、推广商、落地指向、渠道 ID、埋点类型、渠道链接、弹框时间点／间隔、安装类型、APK 地址及编辑操作。
• 新增／编辑渠道包含渠道名称、推广商、落地指向（落地页／web 首页）、跳转域名、埋点类型、安卓设备、下载按钮、引导安装、弹框时间点、间隔、安装类型、安装赠送开关、赠送金额及打码倍数。沿用协作者字段和校验，保存后更新本页列表；渠道链接携带 ch 参数。域名与枚举是交付样例，不代表正式接入配置。
• 推广商支持名称与启用状态查询、重置、新增、编辑名称／排序／状态及即时停启用；变更保存在页面内存。当前渠道表单的推广商候选仍是固定样例，不会自动读取新增推广商。
• 渠道列表查询／重置及筛选控件目前仅呈现方案，未绑定查询行为。安装赠送字段不代表游戏侧已发奖，不修改悬浮球新手资格规则。

5.5.7 仿应用商店与落地页模板（2026-09-17 合入）

• 列表展示模板名称、落地页类型、APP 名称／图标、落地页标题／Logo、描述和评价，提供新增和编辑入口。
• 表单包含谷歌／苹果／常规类型、两种模板样式、APP Logo、落地页 Logo、APP 名称、标题、显示域名、iOS 跳转链接、评分、评分人数、下载量、简介及三张宣传图。
• 图片支持 JPG／PNG／GIF／WebP 本地预览；Logo 建议 512×512，宣传图建议 252×448。评分、评价及下载量沿用演示素材，不能视为真实用户证据。
• 保存后更新列表中的模板名称、类型、APP 名称、标题、简介和评价；素材、样式、域名及跳转信息尚未完整保存回显。列表查询／重置未绑定行为，尚未实现模板发布或真实安装。

5.5.8 推广渠道报表与诊断（2026-09-17 合入）

• 独立展示“游戏 PWA 投流”和“VIB AI 投流”两条路径，切换视图和直推／裂变／留存转化／自然列组可交互；列组可组合，无勾选时展示全部。
• 游戏路径覆盖流量、注册登录、首充、充值提现与投注、AI 信号、VIB 绑定／点数购买、留存和回收验证；VIB 路径覆盖 VIB 首开、注册登录、点数购买、信号、游戏承接、回流及 LTV／CAC。指标提示沿用协作者定义。
• 渠道、统计时间、官方渠道、在投渠道、快捷渠道／日期、查询／重置／导出均保留方案展示，当前不驱动样例数据查询或文件导出。
• 用户列表下方提供渠道模块与完整方案入口。交付保留单渠道诊断抽屉代码，但当前页面未提供可点击触发入口；诊断抽屉包括总览、商业与流量、三段漏斗、ID 接力、回传成功率、复盘动作和转化用户样本。用户样本为展示标签，不是真实用户详情下钻。
• CPA 首充 = 广告成本 ÷ 游戏首充人数；信号到绑定率 = VIB 绑定人数 ÷ 信号使用人数；绑定到点数购买率 = 点数购买人数 ÷ VIB 绑定人数。原型 D7 价值、分组人数、部分留存及成本通过样例估算，阈值和预算建议仅是方案参数。
• 正式数据须明确 cohort、事件时间、去重身份、归因窗口、价值组成和广告成本来源；缺失归因与自然流量不能直接画等号。“每 10 分钟更新”和统计窗口目前为静态文案。
• 生命周期方案见 prototype/lifecycle.html，保留广告归因闭环、跨环境 ID、埋点 Specs、版本边界及任务拆解；作为后台增长分析配套方案。涉及游戏端／VIB 端的新增体验和商业假设仍需单独确认，不改变现行前台流程。

5.5.9 游戏网站管理（2026-09-17 补充）

用户已确认：MVP 管理后台增加独立的“游戏网站管理”入口，先按用户提供的当前版本截图补入，后续补充另行提供。当前原型在推广渠道分组旁增加该入口；“游戏管理”的全局游戏 RTP 配置仍不属于 MVP。

截图可见内容：

• 列表：按名称筛选、查询、刷新、添加游戏网站；展示总条数及分页。
• 列：Logo、名称、链接（外链标识）、游戏 API 地址、创建时间、更新时间、操作（编辑、删除）。
• 添加弹窗：Logo 上传与预览、名称、链接、游戏 API 地址；取消、保存及右上角关闭。
• 上传提示为“限 5MB 以内图片”；API 地址为可选，对接游戏服务端接口的根 URL，留空表示未配置。
• 截图中的 5 条网站、域名和时间仅作页面参考，不代表要求创建真实网站或接入其 API。截图中账户身份与时间栏不构成新增权限或时区系统的要求。

本轮字段补充（已确认）：创建和编辑网站时增加“随机 RTP 范围”，分最低、最高两个数字输入框，保持小数点后两位；增加“刷新间隔”数字输入框，单位为秒。列表同步增加“随机 RTP 范围（%）”和“刷新间隔（秒）”两列，保存后更新，编辑时回填。RTP 失焦及保存后统一显示两位小数。

字段实现约定：RTP 沿用既有网站配置的百分比口径和 0–100 范围，最低值不得高于最高值；刷新间隔按正整数秒处理，三个数值暂按必填处理。必填性、秒数是否允许小数及正式业务上限待明确。原截图未提供这些值，现有五条记录显示“未配置”，不虚构默认配置。网站管理使用独立秒数字段，不直接复用历史悬浮机器人表单的分钟字段；二者数据联动仍待补充。静态原型展示与保存配置，不执行真实 RTP 刷新。

本次原型与暂定交互：列表查询、刷新、分页、新增、编辑和删除均在页面内演示；修改整页刷新后重置，不请求游戏站点或 API。列表 Logo 暂用文字占位，上传后显示选图。编辑暂复用添加字段并回填；删除暂设二次确认；名称与链接暂按必填处理，地址仅允许 HTTP／HTTPS；分页暂每页 10 条，新增时间使用 UTC+4。以上补足交互的约定不视为用户已确认的业务规则。

待后续补充：Logo 必填性、格式／尺寸、名称与链接唯一性、编辑限制、删除关联影响及权限、正式分页／排序／时区、与合作网站接入及其他模块的数据关系、API 接入协议与校验规则。

设计走查假设：使用者为维护网站资料的后台运营人员；以独立命名入口、固定字段顺序、可选标记、取消关闭及保存反馈降低查找与填表负担。此为五角色综合定性推演，非真实用户研究。

原始参考截图保存在 prototype/assets/references/game-websites-list.png 与 prototype/assets/references/game-websites-add.png。

6. 后续版本需求

6.1 公会与分销归属

已确认：用户侧展示“公会”，业务本质为分销商。前期用户主要来自投放落地页，支持通过 URL 携带公会邀请码，以及手动输入邀请码加入公会。

推广链接路径：

1. 用户访问带公会邀请码的投放落地页 URL。
2. 邀请码沿后续访问、安装及注册路径传递。
3. 注册完成后，利用该邀请码建立用户的公会归属。

手动入会路径：产品提供入口，用户输入公会邀请码，加入对应公会。入口所在页面及是否要求先登录待明确。

待明确：URL 参数名、邀请码有效性、跨安装保留方式、多次访问不同邀请链接的归属优先级、已有公会时的处理、退会或换会规则。分佣、结算、分销层级、分销商端及公会后台的具体功能尚未描述，不自动纳入已确认范围。

6.2 原活动赠送需求的版本调整

当前 MVP 仅保留第 5.5.3 节的打码倍数条件与最后一次充值百分比奖励；其余三类条件和当前余额奖励延后，完整设计见第 6.4 节。更广泛的活动系统扩展尚未定义。

6.3 信号的目标游戏与下注金额配置

已确认：信号会指定游戏及下注金额，因此需要提供相应的配置能力。该配置能力明确不属于 MVP，纳入后续版本。

本节描述信号内容的配置能力，与 MVP 中“代码写死的新手奖励规则”、财务查看的“游戏奖励金额”分别记录。具体入口、配置粒度、下注金额规则及与奖励金额的关系待补充。

MVP 中信号先提供多款游戏选择，选定后给出指定游戏及建议下注金额，只是本次不建设对应配置能力；信号内容来源经用户明确保留为待定项，不默认采用固定值或其他实现方式。本节与第 5.5.3 节的信号奖励配置属于不同能力。

6.4 原完整后台方案（保留，不作为当前 MVP 范围）

以下为 v0.22 完整方案原文，含历史版本归属表述，仅用于追溯和后续评审。当前交付范围以第 5.5 节为准。

v0.18 通用操作要求：后台各页面底部的业务／原型说明移除，规则说明集中在产品文档，保留输入单位和必要的操作影响提示。所有停启用、删除及类似敏感操作须二次确认，包含机器人开关、新手规则开关与删除、活动开关、条件删除及跨网站覆盖。确认弹窗说明对象与影响；取消、关闭或 Escape 均不执行改动。

MVP 后台包含用户信息、悬浮机器人管理、游戏管理、信号赠送配置、财务管理五个模块。以下按用户最新补充记录已确认功能，数据口径及尚未描述的操作保留为待明确。

v0.20 RTP 配置补充

用户已确认：

• 合作网站接入中增加每个网站独立的 RTP 随机范围及刷新时间配置；新增网站可填写，已有网站可编辑。
• 增加独立“游戏管理”页面。本版本不区分游戏，仅用一套 RTP 随机范围及刷新时间配置所有游戏。

原型设计假设：

• 范围使用百分比，0 ≤ 下限 ≤ 上限 ≤ 100，最多两位小数；上下限相等表示固定值。
• 刷新时间按间隔分钟设计，必须为正整数；示例默认 95%–98%、每 5 分钟刷新，正式默认值及单位待确认。
• 网站配置与游戏配置分别维护，不互相覆盖，也不推导实际游戏返奖率。
• 保存后在当前后台会话中保留，取消／撤销不保存；刷新页面恢复默认，与现有静态原型一致。
• 本轮实现配置表单与校验；随机生成、计时刷新及跨端数据同步尚未实现。首页 RTP 是明确标注的展示样例，不是后台实时下发或真实统计。正式随机算法、数据来源、刷新起点、生效方式及两类 RTP 的使用位置待确认。

原 5.5.1 用户信息

v0.17 补充：来源渠道直接展示实际渠道名，如 CC、naoteng、test；指定游戏网站支持复选多选。

筛选与查询条件（已确认）：

列表字段（已确认）：

用户详情（已确认）：

• 查看上述列表及筛选涉及的用户信息。
• 查看用户使用信号的明细。
• 查看关联游戏的 ID、充值等信息。

待明确：信号使用明细的字段、关联游戏充值的展示粒度、筛选条件组合规则，以及注册前体验用户是否纳入该列表。新手权益状态、实际使用记录与预扣／实际扣点记录需要区分；按 v0.34 具体游戏信号的接口倒计时及放弃规则展示新手状态，不能把注册记为实际使用流水。

原 5.5.2 悬浮机器人管理

已确认：每合作一个游戏网站新增一项，按合作网站管理并分发 JS 及配置，查看对应 ID 与 JS；不同合作网站可使用不同配置。

悬浮机器人列表（已确认）：

新增悬浮机器人（已确认）：每新增合作游戏网站，填写对应网站／游戏信息，生成对应配置 ID 并提供 JS。具体信息字段、ID 生成规则、同网站多配置及 JS 更新方式待明确。

导入事件（v0.18，已确认）：事件管理页增加“导入事件”按钮。选择另一个来源网站，将其事件导入当前网站并覆盖；不允许选择当前网站作为来源。原型按全部事件的全部文案条目、每条中文／英语／巴西葡萄牙语消息及毫秒轮换速度整组复制，导入后目标可独立编辑，源网站不变；不会修改机器人开关或新手奖励。执行前二次确认来源网站、目标网站及覆盖范围；取消不写入，没有其他来源时不可导入。覆盖当前未保存表单内容的影响须在确认前说明。

v0.21 事件文案补充（已确认）：

• 每个事件支持增加和删除文案，至少保留一条；主页面默认仅编辑中文。
• 每条文案点击“多语言配置”打开弹窗，当前仅提供英语及巴西葡萄牙语。中文原文在弹窗中只读展示。
• 文字轮换速度单位为毫秒。

原型交互：中文不可为空白；只剩一条时禁用删除，删除前确认并同时删除该条翻译。弹窗“应用多语言”仅更新当前事件草稿，点击“保存事件配置”后在页面会话内保存；取消、关闭或 Escape 丢弃弹窗修改。切换事件或返回列表放弃未保存草稿。原型翻译允许留空，正式回退策略待确认。轮换间隔以正整数毫秒校验，默认 5000 毫秒保持原 5 秒示例时长，多条按列表顺序轮换为设计假设。本轮不新增真实定时轮换或后端分发。

事件管理（已确认）：按指定事件配置消息内容，消息支持多语言。当前明确包含以下事件，尚不视为完整事件全集：

“未下载 PWA”用于安装提示，并需与第 5.1 节最新安装门槛统一。条件奖励没有报名逻辑，原“有活动待参加”事件名称与点击行为需要改为符合自动资格判断的表达；具体文案待定。

已确认按条件配置消息文字及文字轮换速度；条件编辑范围、点击行为和跳转地址是否允许后台编辑仍待明确。当前语言为中文、英语和巴西葡萄牙语；缺失语言回退、多事件同时满足时的优先级和配置分发生效规则待细化。保存发布、版本回滚、外观及默认位置配置未作为已确认功能。

原 5.5.3 信号赠送配置

已确认：该模块纳入 MVP 管理后台，分为两部分。分别为“新手奖励信号”和“信号奖励配置”。

通用配置口径（已确认）：

• 配置时选择对应游戏，涉及的充值和余额均为该游戏的充值和余额。
• 取条件满足时的数据作为计算基数；无充值记录或相关基数为零时，视为不满足条件。
• 金额方式二选一，不同时配置两种方式；金额使用巴西雷亚尔（BRL）。
• 固定金额模式不依赖百分比基数；“无充值或为零不满足”是否也作为固定金额新手奖励的资格门槛，待明确，不自动扩大适用范围。

第一部分：新手奖励信号配置

v0.18 管理链路（已确认）：默认进入新手奖励规则列表，补全新建、编辑、停启用与删除流程。原型按网站展示规则、开关、金额方式及范围，支持网站名和状态筛选；创建／编辑页仍支持多网站复选，至少选择一个。保存前明确哪些网站已有规则将被覆盖并二次确认，成功返回列表；取消返回不保存。停启用与删除均单独二次确认，取消后保持原状态。已发信号在停用、删除后的处理仍待明确，不通过原型自行定义。

v0.17 补充：游戏网站以复选框形式多选，同一组新手奖励规则可应用于多个勾选网站；各网站仍独立计算。

按游戏分别配置，不同游戏可以使用不同的新手奖励开关和金额规则。该开关控制新手奖励信号功能，与悬浮机器人整体的停启用分开记录。

百分比方式的范围表达：设最近一次充值金额为 R，配置的百分比下限、上限分别为 p_min、p_max，则金额范围为 [R × p_min，R × p_max]（百分比按对应比例参与计算）。该表达仅说明范围，不规定最终金额如何在范围内选取。

已确认的首次权益原则：不因注册额外赠送；按 v0.32 允许合资格新手先体验，体验后 5 秒强制登录；不预扣或抵扣注册／登录赠点，已登录新手计费分支见 5.3 待明确项。信号产生且明确具体游戏后按游戏接口倒计时计算有效期，未使用到期视为放弃并触发遮罩。新手资格仅依据第 5.2 节游戏账号是否使用过信号，发放按游戏账号去重，与 VIB 账号及网站关联记录无关，不限制条件奖励的重复获得，见第 5.2 节。

待明确：

• 最终金额在范围内如何确定，以及金额精度和上下限校验规则。
• 固定金额新手奖励是否同样要求用户已有游戏充值记录。
• 奖励金额是否含下注本金的结算字段口径，以及其与实际游戏奖励的对应关系。
• 关闭新手奖励功能后，已发放但未使用的信号是否仍有效；配置变更对已有信号的影响。

新手奖励金额配置与信号的指定下注金额配置属于不同配置概念：前者纳入 MVP，后者明确放在后续版本，不能将两者视为同一字段。新手配置的“对应游戏”用于区分各游戏的奖励规则，不等于本期需要提供信号目标游戏的配置能力。

第二部分：信号奖励配置

v0.17 补充：不需要“有一份未提交的新建内容”或继续编辑功能；返回活动列表、取消或离开页面后不保留未保存内容，重新新建为空白表单。

活动列表与新建流程（v0.16，已确认）：

• 默认进入列表，展示当前已开启的活动；点击“新建活动”后进入配置界面。
• 适用网站直接列出，以复选框支持多选；多个网站可复用同一组活动规则。
• 默认只有一个条件，可继续增加或删除条件，但至少保留一个。条件类型沿用下表四类，组合关系仍仅为“且”。
• 条件与奖励分区设置。每个活动可有多个条件，但只选择一种奖励方式，再填写该方式对应的范围；不再为每个条件分别配置奖励。
• 奖励方式沿用最后一次充值金额百分比范围、当前余额百分比范围。当前两种方式输入的是百分比上下限，计算得到 BRL 金额范围；本次未增加固定金额方式。

原型体验建议（可继续评审）：活动名称和状态筛选、名称／网站搜索、编辑与停启用；网站搜索、当前结果全选和已选数量；实时规则摘要、错误字段定位。上述保存与停启用只操作本地演示，正式生效、冲突与已发信号处理仍待确认。

已确认：配置信号出现的条件，并为整组条件统一配置一份信号奖励金额。该能力纳入 MVP；此前描述的按指定游戏行为赠送信号需求在此细化。用于条件统计的游戏范围与信号目标游戏的配置能力分别记录，后者仍不属于 MVP。

条件奖励资格（本次补充）：

• 条件奖励须满足正常登录与奖励资格；新手信号按 v0.32 允许符合条件的用户在安装／注册 VIB 前体验，见 5.1.3。
• 正常信号获取和使用要求先在游戏内悬浮机器人登录 VIB 账户，不需要、也不存在报名逻辑。
• 已在游戏悬浮组件登录 VIB、但手机未安装 VIB PWA 的情形，用户明确要求由开发评估能否监测到。登录前提已确认；v0.32 新手体验例外和游戏内登录门槛按第 5.1 节更新。不能据此认定检测能力已具备；状态未知及已登录未安装的处理需在技术评估后细化。

计算口径与时间选择（已确认）：

• 打码倍数 = 打码量 ÷ 累计充值金额，统计对象为配置所选游戏。
• 选择输赢比例条件后，还需选择指定时间段，按所选时间段内的输赢比例判断。
• 时间段由后台操作人选择。具体支持的时间选择形式及输赢比例计算公式尚未定义。
• 游戏充值及余额取条件满足时的数据；无充值或相关基数为零视为不满足条件。

组合规则：支持组合条件，组合条件之间仅存在“且”（AND）关系，所有选中的条件均满足才符合组合条件；不支持“或”（OR）。打码条件的向上变化要求在组合中仍然适用，不能仅因当前倍数等于目标值就认定触发。

每个活动统一配置的信号奖励金额（与条件分离，单选一种）：

百分比按对应比例参与计算。上述仅定义范围，不规定范围内最终金额的选取方式；本部分未提出固定金额范围方式。

待明确的计算及发放细则：

• 打码量与累计充值金额的统计起点、有效打码范围，以及从低于目标直接跳到高于目标是否算达到。公式已确认，下降后再次上升达到目标可再次奖励。
• 输赢比例的分母、净输赢口径及判断关系（等于、达到或超过）；操作人选择的时间段支持固定起止时间、预设时段还是滚动窗口。已确认按所选时间段统计，不再将时间段由谁选择列为待定。
• 时间段内充值金额是累计充值还是单笔充值，是否只计成功充值，以及范围边界是否包含端点。
• 每个活动统一配置一种奖励方式及范围，多个条件不分别设置奖励；范围内最终金额的选取仍待明确。
• 在所有条件均满足的前提下，打码上升事件是否只在发生当次参与判断，还是在所选统计周期内保留达成记录。这是事件有效期细节，不改变“且”必须全部满足的规则。
• 范围内最终奖励金额选取、金额精度、自动资格判断后直接到账还是需点击领取，以及跨统计周期、规则修改后的再次命中识别。持续满足期间只奖励一次，已确认；扣点精度已明确为向上取整。

奖励数量及重复获得规则（已确认）：

• 一组组合条件满足后，仅发放一份信号奖励。
• 获得的信号可以叠加，指信号可以累计，不等同于把多个条件的奖励金额相加。
• 每满足一次规则，发放一个信号奖励；条件持续满足属于同一次满足，不持续重复发放。
• 符合规则的获得次数无限制，与单次持续满足只发一次分别处理。
• 打码下降至目标不奖励；下降后再次上升至目标，依然可获得奖励。

以上待明确项不改变已确认的“打码仅上升触发”“条件仅且组合”“组合仅发一份”和“符合规则可无限次获得”原则。

原 5.5.4 财务管理

v0.17 补充：指定游戏网站支持复选多选。原型中的网站筛选在信号游戏奖励查询中展示；多选按任一网站匹配，不勾选表示全部。VIB 充值本身无已确认的网站归属，不新增网站关联口径。

两类数据分别对应平台充值与信号在游戏侧的奖励，不自动合并为 VIB 收入。奖励金额的结算口径、时间字段、明细与汇总展示粒度，以及信号与游戏奖励的关联方式待明确。当前没有提出退款、提现、结算操作或报表导出要求。

游戏数据采集接口、信号生成机制、账户和支付服务的后台实现方式尚未定义；上述查询能力依赖相应数据接入，不视为技术依赖已解决。

7. 体验与原型验证建议

以下为五个项目角色综合形成的建议，不增加已确认功能范围，也不是实际用户研究结论。暂以“首次下载 AI 版游戏、尚无 VIB 账户的用户”为流程验证情境，具体用户画像尚缺失。

• 理解与任务衔接：首次展示时应让用户理解机器人用途、首次权益与后续登录要求；安装或注册后应清楚说明如何返回游戏登录。
• 操作层级：普通浮窗可收起、剧本继续；新手使用后 5 秒强制登录遮罩按已确认要求不可关闭。明确展示返回游戏后仍需在悬浮球登录的下一步，避免把下载误解为已解锁。
• 状态清晰：区分首次权益可用、权益已使用、待安装、待登录及已登录等状态；注册、安装和登录不能在文案中混为一步。
• 多语言与交互：验证长文本、拖动与点击区分，以及悬浮球在不同屏幕中的可操作性。
• 原型范围：优先验证游戏登录 → 新手体验 → 使用后 5 秒遮罩 → PWA 注册 → 悬浮球登录，以及普通信号确认游戏扣点、账号切换和剧本收起继续。原型若使用模拟信号或模拟收益，应明确标识，不将交互演示作为信号效果证据。

8. 进入详细设计前的待明确事项

尚未制定上线时间、需求负责人、量化成功目标或完整验收标准。上述建议优先级用于继续梳理，不代表已承诺排期。

9. 变更记录