活动、七日、时间开放与权限
0. 本篇结论
本篇为 WEN-14 / B2-B 文档整理稿，状态为 draft。原文 producer_review_needed / canonical_candidate 保留，未取得该功能的产品批准凭证。规则编号、参考图与原候选内容不等于已上线行为。
来源为 project2-docs @ ec43be0e13c8624cfafd36c0fd803f3b89733fff 的 docs/planning/project2-game-feature-library-v1/features/activity-timeopen.md；获取时间 2026-10-13（UTC），通过 Git 固定提交阅读。共用归属、来源清单、冲突证据与待裁定项统一见运营总览。本篇后续“必须”“验收”均属于待审规则/预留验收，未在本批执行游戏或平台验证。
1. 功能定位
活动开放系统负责按时间、条件和运营配置控制活动入口、活动数据、七日类数据、活动奖励和功能权限。它是运营内容和功能开放节奏的基础。
2. 范围
In Scope：活动主数据、活动详情、活动奖励领取、七日数据、通关冲刺/推关奖励、时间开放检查、权限/特权数据。
Out of Scope：具体每个活动玩法的独立规则、付费订单、公告展示。
3. 玩家入口、解锁与提示
活动入口一般位于主界面或运营入口。开放依赖活动时间、服务器时间、玩家角色状态、功能开放条件和可能的特权状态。
4. 核心玩家流程
- 玩家进入游戏或打开活动入口。
- 客户端请求活动主数据。
- 展示当前开放活动列表和活动详情。
- 玩家完成活动条件并领取奖励。
- 活动状态、计数和奖励领取状态刷新。
5. 核心规则
5.1 活动开放、时间与校验
ACTIVITY-TIMEOPEN-R-001：活动有开放时间、展示时间、状态和奖励领取条件。ACTIVITY-TIMEOPEN-R-002：七日活动按天或阶段展示数据。ACTIVITY-TIMEOPEN-R-003：活动奖励领取必须后端校验条件。ACTIVITY-TIMEOPEN-R-004：时间开放检查必须使用服务端时间。ACTIVITY-TIMEOPEN-R-005：权限/特权影响功能开放、奖励或加成时必须有明确 contract。
5.2 七日登录活动规则
ACTIVITY-TIMEOPEN-R-006：七日登录默认开服后开放；若项目启用功能开放顺序，则需要绑定功能 ID 并按开放配置显示入口。ACTIVITY-TIMEOPEN-R-007：功能开放后，活动入口显示在主界面；每日首次登录、游戏中跨 0 点或功能刚解锁时自动弹出活动界面。ACTIVITY-TIMEOPEN-R-008：玩家解锁功能后开始记录每日登录数据；当日 0 点至 24 点内有登录行为即视为达成，游戏中跨 0 点也视为达成。ACTIVITY-TIMEOPEN-R-009：玩家每达成一次登录条件，登录天数加一；漏登后再次登录时按累计达成次数顺序推进奖励可领取状态。ACTIVITY-TIMEOPEN-R-010：奖励状态包括不可领取、可领取和已领取；可领取奖励需要玩家手动领取。ACTIVITY-TIMEOPEN-R-011：玩家可跳着领取任意可领取奖励，未领取奖励保持可领取状态。ACTIVITY-TIMEOPEN-R-012：所有奖励均已领取后，七日登录活动结束，入口隐藏。
5.3 通关冲刺达成与奖励
ACTIVITY-TIMEOPEN-R-013：通关冲刺活动根据玩家主线关卡通关进度领取对应档次奖励。ACTIVITY-TIMEOPEN-R-014：通关冲刺使用通用活动开启逻辑，活动开放后永久开放。ACTIVITY-TIMEOPEN-R-015：通关冲刺只要求主线关卡已通关，不要求达到三星或宝箱条件。ACTIVITY-TIMEOPEN-R-016：活动开放时，玩家此前已经通关的关卡应直接回填为已达成，可立即领取对应奖励。ACTIVITY-TIMEOPEN-R-017：通关冲刺奖励按配置的关卡 ID 和奖励列表生成。候选表现文案为“推关送千抽福利”，奖励以抽奖券为主，但配置示例中出现钻石奖励，最终奖励类型需要统一确认。
5.4 通关冲刺领取与列表定位
ACTIVITY-TIMEOPEN-R-018：通关冲刺支持一键领取当前所有可领取奖励。领取后对应行灰化并显示打勾或已领取标记。ACTIVITY-TIMEOPEN-R-019：点击未达成奖励时提示通关指定关卡即可领取，提示中的关卡名或关卡号来自配置。ACTIVITY-TIMEOPEN-R-020：打开通关冲刺界面时，列表定位到已完成要求的奖励行附近，便于玩家领取或查看下一档目标。
5.5 操作矩阵
N/A。当前不在策划案正文中复述核心玩家流程；进入 PLAN 时，仅对状态变化、消耗/产出、奖励发放、跨系统反馈或失败反馈补齐操作矩阵。
6. UI 状态与交互
6.1 界面图与交互说明
以下图片为待评审参考图，已按图片锚点和附近文字绑定到页面/状态；状态均为 仅参考，最终布局、尺寸、按钮位置和视觉风格以制作人/UI 评审确认为准。
图 01：美术UI需求 / 活动入口
- 图状态：仅参考
- 关联页面 / 状态：美术UI需求 / 活动入口
- 关联交互 / 状态说明：活动入口；在主界面增加一个活动入口（7天签到下方即可）；需要新增一个对应的活动图标；界面上方需要标记文本说明：
图 02：红点需求
- 图状态：仅参考
- 关联页面 / 状态：红点需求
- 关联交互 / 状态说明：红点需求；七日登录；有奖励可领取时；主界面七日登录图标（红点）；没有奖励可领取后消失；界面需求；主界面7日图标进入，点击该图标打开界面；1、功能开启后，显示在主界面，每日首次登录时直接弹出界面（在主界面跨天时也自动弹出，功能解锁时也弹出）
图 03：界面需求
- 图状态：仅参考
- 关联页面 / 状态：界面需求
- 关联交互 / 状态说明：七日登录；有奖励可领取时；主界面七日登录图标（红点）；没有奖励可领取后消失；界面需求；主界面7日图标进入，点击该图标打开界面；1、功能开启后，显示在主界面，每日首次登录时直接弹出界面（在主界面跨天时也自动弹出，功能解锁时也弹出）；2、所有奖励已领取后，功能隐藏关闭，图标隐藏
图 04：英雄tips用下图
- 图状态：仅参考
- 关联页面 / 状态：英雄tips用下图
- 关联交互 / 状态说明：可领取：条件达成后标记为可领取，打开界面更新或跨天时请求更新。奖励框高亮，点击框体即可领取奖励，弹出获得奖励通用界面；已领取：领取后的奖励框置灰，并打上已领取标签，点击框体弹出道具tips或英雄tips；英雄tips用下图
图 05：英雄tips用下图
- 图状态：仅参考
- 关联页面 / 状态：英雄tips用下图
- 关联交互 / 状态说明：可领取：条件达成后标记为可领取，打开界面更新或跨天时请求更新。奖励框高亮，点击框体即可领取奖励，弹出获得奖励通用界面；已领取：领取后的奖励框置灰，并打上已领取标签，点击框体弹出道具tips或英雄tips；英雄tips用下图
6.2 页面结构与交互
活动入口需展示开放状态、倒计时、可领取、已领取、未达成、过期。七日类活动应展示天数、进度和补签/错过规则（若存在）。
七日登录入口位于主界面活动图标。界面头图应突出关键天数奖励，可展示第 2 日或第 7 日英雄立绘、品质、名称、领取天数和说明。奖励框展示天数、奖励道具图标、数量；英雄奖励可用头像或立绘特殊展示。不可领取状态保持锁定并可查看 tips；可领取状态高亮，点击领取后弹出通用奖励界面；已领取状态置灰并显示已领取标签。
通关冲刺入口位于主界面活动区域，候选位置在七日签到下方。界面上方展示活动说明、累计领取进度和总奖励进度；中央奖励列表支持上下滑动，露出半行内容暗示可滚动；底部提供批量领取按钮。可领取奖励需要有道具特效提示。
6.3 UI 页面状态表
N/A。当前仅保留已绑定页面/状态的参考图和页面结构说明；具体可执行状态在 UI 评审或 UI brief 中确认。
7. 配置、数据与 Contract
本节只记录策划案需要的逻辑数据与跨部门 contract，不预设物理配置表、协议文件、service 文件或 仓库落点。正式命名、字段名、接口名、协议对象名、文件名和仓库落点进入执行前由 Work Package 的 contract-registry.yaml、execution brief 和对应执行任务确认。
7.1 策划数据需求
策划数据需求只描述逻辑数据域、逻辑字段或规则语义，不等同于配置表字段名、协议字段名或数据库字段名。正式字段命名进入 contract-registry.yaml、execution brief 和对应执行任务确认。
| 数据域 | 逻辑字段 / 规则 | 设计含义 | 必填 / 边界 | 产出责任 |
|---|---|---|---|---|
| 活动开放规则 | 活动 ID、展示时间、开放时间、关闭时间、服务器时间基准、功能开放条件 | 定义活动展示、开放、结束和奖励可领取时间 | 进入执行前补齐默认值、边界和可选性 | Planning |
| 七日登录规则 | 天数、达成条件、奖励组、可领取态、已领取态、入口隐藏条件 | 定义累计登录、奖励状态和活动结束条件 | 进入执行前补齐默认值、边界和可选性 | Planning |
| 通关冲刺规则 | 关卡目标、奖励档位、回填规则、一键领取、未达成提示 | 定义按主线进度领取活动奖励 | 进入执行前补齐默认值、边界和可选性 | Planning |
| 特权影响规则 | 特权类型、影响对象、加成方式、有效期 | 定义特权对活动开放、奖励或加成的影响 | 进入执行前补齐默认值、边界和可选性 | Planning |
7.2 运行时数据与接口需求
| Contract | 设计含义 | 使用方 | 说明 |
|---|---|---|---|
| 活动状态数据 | 保存活动进度和奖励领取状态 | 服务端 / 客户端 | 后端以服务端时间判定开放和奖励状态 |
| 活动奖励接口 | 处理活动奖励领取和一键领取 | 服务端 / 客户端 | 所有奖励领取需后端校验条件和防重复 |
| 活动入口刷新 | 活动解锁、跨日和首次登录时刷新入口与弹窗 | 服务端 / 客户端 | 需要明确跨 0 点和功能刚解锁的刷新行为 |
7.3 跨部门 Contract 命名清单
| Contract 类型 | 逻辑对象 | 命名状态 | 阻塞阶段 | 说明 |
|---|---|---|---|---|
| 配置数据 | 活动开放、七日登录、通关冲刺、奖励档位、特权影响 | 待 PLAN 确认 | PLAN 前 | 不预设物理配置表名 |
| 协议 / API | 活动主页、活动详情、奖励领取、活动状态通知 | 待 PLAN 确认 | 执行前 | 由服务端 / UI brief 确认 |
| 错误码 | 活动未开放、奖励不可领取、奖励已领取、配置缺失 | 待 PLAN 确认 | 执行前 | 需要对应玩家提示 |
| 语言 Key | 活动入口、奖励状态、通关提示、领取成功/失败 | 待 PLAN 确认 | 执行前 | 进入语言 brief |
| 埋点事件 | 活动打开、奖励领取、活动完成 | 待 PLAN 确认 | PLAN 前 | 由 analytics 方案确认 |
8. 系统边界
| 方向 | 负责内容 | 备注 |
|---|---|---|
| Planning | 逻辑数据、数值、文本需求、资源需求 | 进入执行前由 PL 任务细化 |
| 服务端 | 协议、校验、持久化、奖励发放、幂等与安全 | 仅相关功能需要 |
| 客户端 | UI、交互、表现、本地状态、红点和跳转 | 仅相关功能需要 |
| 美术 | 图标、模型、特效、音频和导出资源 | 仅相关功能需要 |
| Ops / GM | 后台配置、运营投放、公告、补偿和数据看板 | 仅相关功能需要 |
客户端与表现
当前 Unity 侧未发现完整 Activity feature 目录；可能未接入或被合并到其他运营入口。若要生产使用，需要补 Unity 入口和 UI 证据。
美术与音频需求
需要活动入口图标、活动 banner、倒计时、奖励展示、领取反馈。
9. 数值、经济与奖励
活动奖励引用 item-resource。活动开放和奖励配置需要在 PLAN 中确认配置来源、状态权威和跨端 contract。
通关冲刺奖励表至少需要关卡 ID 和奖励字段；若主打“千抽福利”，还需要统计已领取抽奖券数量和总可领取抽奖券数量，例如 80/1520 类进度。
10. 异常、安全与运营边界
10.1 异常与安全
活动时间、奖励领取和特权状态必须以状态权威为准。生产活动配置、发奖和补偿需要人工审核。
10.2 埋点与运营
本功能的候选采集行为统一见埋点与数据分析的业务事件目录。本篇只拥有业务触发和状态含义；事件名、属性类型、归因与跨端去重归埋点文档。候选目录不代表已有正式事件或已接入平台。
11. Feature Relations 与回归范围
Feature Relations
依赖账号登录、主界面、道具资源、邮件、公告、充值礼包。写入活动状态和奖励领取记录。
红点与 main-entry-red-dot 共享：七日登录存在可领取奖励时，主界面七日登录入口显示红点；没有可领取奖励后消失。通关冲刺存在可领取奖励时，主界面活动入口和通关冲刺入口应显示红点；一键领取后刷新或消失。
回归范围
以 Feature Relations 影响功能、核心玩家流程、配置与系统边界为基础；进入执行前由 PLAN / QA brief 细化最小回归范围。
12. 验收标准
12.1 关键验收结论
活动开放、关闭、奖励领取、七日数据、时间切换、重登恢复和过期处理正确；迁移资料 为 未完整确认 状态，生产验收前必须补齐业务逻辑。
补充验收：默认开服开放、功能开放顺序、每日首次登录弹出、跨 0 点达成、漏登后顺序推进、跳领、所有奖励领取后隐藏入口、奖励三态、tips 和红点均需验证。
通关冲刺补充验收：活动永久开放、历史通关回填、通关即达成、不要求三星、一键领取、未达成提示、领取后灰化打勾、列表自动定位、累计抽奖券进度和红点均需验证。
12.2 规则验收清单
规则正文集中在本篇第 5 节，原有 *-R-* 编号保留。原第 12.2 节逐条重复正文已合并到第 5 节；未来人工验收按这些编号记录结果，本批未验证也未勾选。共用规则按运营总览的归属引用，不另立副本。
12.3 执行层验收
- 如填写操作矩阵，成功路径、失败场景、玩家反馈和状态权威均已覆盖。
- 如填写 UI 页面状态表，页面 / 弹窗状态均已覆盖，或明确标记为
N/A。 - Section 7 中标记为 PLAN 前或执行前阻塞的 contract 已在
contract-registry.yaml、execution brief 或执行任务中确认。 - 相关 Feature Relations 回归通过。
13. 待澄清问题 / Open Questions
acvitity文件命名是否历史拼写，是否需要标准化为 activity。- 当前版本是否已上线活动 UI。
- 七日活动已按活动开放子功能迁入候选规则；是否需要拆成独立 canonical feature 仍需确认。
- 迁移资料 中活动/七日 处理逻辑 大量逻辑被注释，是否为预留或暂停上线需要确认。
- 通关冲刺奖励文案强调抽奖券，但配置示例出现钻石奖励；最终奖励口径、活动名和统计单位需要确认。
14. 变更记录
| 日期 | 版本 | 修改人 | 变更摘要 |
|---|---|---|---|
| 2026-10-13 | draft / WEN-14 | AutoDev Symphony | 保留原审核状态与固定来源；明确共用归属及待裁定问题；合并重复规则清单与空图入口，不变更玩法 |
| 2026-06-16 | v0.2 | Codex | 补充规则编号、操作矩阵、UI 状态表、逻辑字段和执行层验收锚点 |
| 2026-06-16 | v0.1 | Codex | 按新版功能策划案模板重排章节；保留既有规则内容并映射参考图 |