Skip to main content

邮件、附件、收藏、删除与跳转

0. 本篇结论与阅读边界（WEN-8 draft）​

本篇是 B1-A 文档整理草稿。固定文档来源为 ec43be0e13c8624cfafd36c0fd803f3b89733fff 的 features/mail.md；原审核声明为 producer_review_needed / canonical_candidate，保留为历史事实，整理稿状态为 draft。原规则、参考图和验收清单是候选要求，不能视为已批准规则或已执行验证。

先由基础系统入口查看初始化、入口、红点和开放规则归属，以及来源、合并追溯和待裁定问题。本文负责自己的功能规则；引用其他功能的共用规则时不再复制。代码/配置与游戏运行现状未在本批重新核对，缺证见系统入口。

1. 功能定位​

邮件系统用于向玩家发送文本、参数化内容、附件奖励、系统通知和跳转链接，并提供读取、领取、删除、收藏和 URL 点击行为。

2. 范围​

In Scope：邮件列表、邮件详情、读取、附件领取、删除、收藏、URL 点击、红点、后台发信。

Out of Scope：具体奖励来源功能、公告、客服。

3. 玩家入口、解锁与提示​

入口位于主界面，参考图定位为右上侧任务图标下方（仅参考）。未读或未领取附件时显示红点；邮件状态产生、读取/领取后的刷新归本篇，主入口聚合、入口开放及跳转异常归 主界面入口与红点。具体邮件开放条件、初次登录是否随角色快照初始化邮件未取得固定证据，不补造默认值；现有打开界面请求列表的流程保留。

4. 核心玩家流程​

  1. 玩家打开邮件界面。
  2. 客户端请求邮件列表和默认详情。
  3. 玩家查看邮件内容。
  4. 玩家读取、领取附件、删除、收藏或点击链接。
  5. 邮件状态刷新并更新红点。

5. 核心规则​

5.1 邮件结构与参数化内容​

  • MAIL-R-001：邮件分简要信息和详情内容。
  • MAIL-R-002：邮件内容支持参数化标题和正文。

5.2 附件、收藏与清理边界​

  • MAIL-R-003：领取附件后状态必须改变，避免重复领取。
  • MAIL-R-004：收藏邮件不应被普通清理误删。
  • MAIL-R-005：邮件存在数量上限；超过上限时按最早时间清理，是否保护未过期、未领取奖励邮件需要制作人确认。
  • MAIL-R-006：邮件存在时效，超过保存时间后自动删除，奖励也不可再领取。

5.3 列表操作与排序​

  • MAIL-R-007：邮件列表应支持分批加载；打开界面默认展示最新一批邮件，玩家继续下拉时加载更早邮件。
  • MAIL-R-008：一键删除只处理已读且无未领取奖励的邮件；未读邮件和仍有未领取奖励的邮件不应被删除。
  • MAIL-R-009：一键领取会领取所有未领取附件，不受已读/未读状态影响；同类道具在通用奖励弹窗中合并展示。
  • MAIL-R-010：邮件排序优先级为未读优先、奖励未领取优先、时间较晚优先。

5.4 操作矩阵​

N/A。当前不在策划案正文中复述核心玩家流程；进入 PLAN 时，仅对状态变化、消耗/产出、奖励发放、跨系统反馈或失败反馈补齐操作矩阵。

6. UI 状态与交互​

6.1 界面图与交互说明​

以下图片为待评审参考图，已按图片锚点和附近文字绑定到页面/状态；状态均为 仅参考，最终布局、尺寸、按钮位置和视觉风格以制作人/UI 评审确认为准。

图 01：邮件入口​

邮件、附件、收藏、删除与跳转 - 邮件入口

  • 图状态：仅参考
  • 关联页面 / 状态：邮件入口
  • 关联交互 / 状态说明：邮件入口；主界面右上侧，任务图标下方

图 02：邮件红点​

邮件、附件、收藏、删除与跳转 - 邮件红点

  • 图状态：仅参考
  • 关联页面 / 状态：邮件红点
  • 关联交互 / 状态说明：邮件红点；邮件；有未读邮件；主界面邮件入口（红点）-----无奖励邮件图标（红点）；未读邮件已读 / /；有未领取奖励的邮件；主界面邮件入口（红点）-----有奖励邮件图标（礼盒）；邮件奖励已领取 /；邮件列表界面；显示功能标题和关闭按钮

图 03：邮件红点​

邮件、附件、收藏、删除与跳转 - 邮件红点

  • 图状态：仅参考
  • 关联页面 / 状态：邮件红点
  • 关联交互 / 状态说明：邮件红点；邮件；有未读邮件；主界面邮件入口（红点）-----无奖励邮件图标（红点）；未读邮件已读 / /；有未领取奖励的邮件；主界面邮件入口（红点）-----有奖励邮件图标（礼盒）；邮件奖励已领取 /；邮件列表界面；显示功能标题和关闭按钮

图 04：邮件红点​

邮件、附件、收藏、删除与跳转 - 邮件红点

  • 图状态：仅参考
  • 关联页面 / 状态：邮件红点
  • 关联交互 / 状态说明：邮件红点；邮件；有未读邮件；主界面邮件入口（红点）-----无奖励邮件图标（红点）；未读邮件已读 / /；有未领取奖励的邮件；主界面邮件入口（红点）-----有奖励邮件图标（礼盒）；邮件奖励已领取 /；邮件列表界面；显示功能标题和关闭按钮

图 05：邮件列表界面​

邮件、附件、收藏、删除与跳转 - 邮件列表界面

  • 图状态：仅参考
  • 关联页面 / 状态：邮件列表界面
  • 关联交互 / 状态说明：有未领取奖励的邮件；主界面邮件入口（红点）-----有奖励邮件图标（礼盒）；邮件奖励已领取 /；邮件列表界面；显示功能标题和关闭按钮；关闭后回到主界面；展示所有邮件条目

图 06：邮件列表界面​

邮件、附件、收藏、删除与跳转 - 邮件列表界面

  • 图状态：仅参考
  • 关联页面 / 状态：邮件列表界面
  • 关联交互 / 状态说明：有未领取奖励的邮件；主界面邮件入口（红点）-----有奖励邮件图标（礼盒）；邮件奖励已领取 /；邮件列表界面；显示功能标题和关闭按钮；关闭后回到主界面；展示所有邮件条目

图 07：有奖励邮件界面​

邮件、附件、收藏、删除与跳转 - 有奖励邮件界面

  • 图状态：仅参考
  • 关联页面 / 状态：有奖励邮件界面
  • 关联交互 / 状态说明：有奖励邮件界面；显示邮件标题和关闭按钮；关闭后返回邮件列表；显示邮件正文；显示奖励发送人、奖励图标、奖励数量、领取按钮

图 08：无奖励邮件界面​

邮件、附件、收藏、删除与跳转 - 无奖励邮件界面

  • 图状态：仅参考
  • 关联页面 / 状态：无奖励邮件界面
  • 关联交互 / 状态说明：【一键删除】【一键领取】按钮灰化，点击无响应；无奖励邮件界面；显示邮件标题和关闭按钮；关闭后返回邮件列表；显示邮件正文

6.2 页面结构与交互​

邮件列表展示标题、时间、未读、附件、收藏状态；详情展示正文、附件和链接按钮。

列表入口位于主界面右上侧任务入口下方。未读邮件显示红点；含奖励邮件使用礼盒状态区分未领取和已领取。空邮箱显示空状态，并灰化一键删除和一键领取按钮。邮件详情分无奖励和有奖励两类：无奖励邮件展示标题、正文和关闭；有奖励邮件额外展示发送人、奖励图标、数量和领取按钮，领取后按钮变为已领取状态。

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 / Backend
附件与领取规则奖励列表、领取状态、防重复、奖励合并定义附件结构、领取状态和一键领取进入执行前补齐默认值、边界和可选性Planning / Backend
清理与排序规则保存时间、上限、收藏保护、清理条件、排序权重定义过期、收藏、数量上限、一键删除和排序优先级进入执行前补齐默认值、边界和可选性Planning

7.2 运行时数据与接口需求​

Contract设计含义使用方说明
邮件列表数据分批加载邮件简要信息和详情服务端 / 客户端默认展示最新一批，下拉加载更早邮件
邮件操作接口处理阅读、领取、删除、收藏和跳转点击服务端 / 客户端附件领取和删除需后端校验
后台发信通道支持服务端或运营发放邮件和奖励Backend / Ops需要审计和防重复

7.3 跨部门 Contract 命名清单​

Contract 类型逻辑对象命名状态阻塞阶段说明
配置数据邮件模板、跳转类型、保存时间、清理规则待 PLAN 确认PLAN 前不预设物理配置表名
协议 / API邮件列表、详情、阅读、领取、删除、收藏、链接点击、后台发信待 PLAN 确认执行前由服务端 / 客户端 / 运营 brief 确认
错误码邮件不存在、附件已领取、邮件过期、删除条件不满足待 PLAN 确认执行前需要玩家提示
语言 Key邮件标题、正文模板、按钮和错误提示待 PLAN 确认执行前进入语言 brief

8. 系统边界​

方向负责内容备注
Planning逻辑数据、数值、文本需求、资源需求进入执行前由 PL 任务细化
服务端协议、校验、持久化、奖励发放、幂等与安全仅相关功能需要
客户端UI、交互、表现、本地状态、红点和跳转仅相关功能需要
美术图标、模型、特效、音频和导出资源仅相关功能需要
Ops / GM后台配置、运营投放、公告、补偿和数据看板仅相关功能需要

客户端与表现​

  • PlayMode 测试覆盖打开、领取、删除。

美术与音频需求​

需要邮件入口、未读标识、附件标识、收藏标识、领取反馈。

9. 数值、经济与奖励​

附件通过 ItemData 发放，必须接入 item-resource。

10. 异常、安全与运营边界​

10.1 异常与安全​

附件领取必须幂等。删除和收藏并发、邮件过期、重复点击领取要有服务端保护。

10.2 埋点与运营​

记录邮件打开、读取、附件领取、删除、链接点击、后台发信批次。

11. Feature Relations 与回归范围​

Feature Relations​

依赖 item-resource、main-entry-red-dot；被排行榜、活动、补偿、运营系统调用。

回归范围​

以 Feature Relations 影响功能、核心玩家流程、配置与系统边界为基础；进入执行前由 PLAN / QA brief 细化最小回归范围。

12. 验收标准​

12.1 关键验收结论​

邮件读取、附件领取、删除、收藏、详情、未读数、红点和参数化内容正确。

补充验收：邮件数量上限、过期删除、列表分批加载、一键删除、一键领取、排序、空状态、未读红点、礼盒状态和奖励已领取态均需验证。

12.2 规则验收清单​

  • MAIL-R-001：邮件分简要信息和详情内容。
  • MAIL-R-002：邮件内容支持参数化标题和正文。
  • MAIL-R-003：领取附件后状态必须改变，避免重复领取。
  • MAIL-R-004：收藏邮件不应被普通清理误删。
  • MAIL-R-005：邮件存在数量上限；超过上限时按最早时间清理，是否保护未过期、未领取奖励邮件需要制作人确认。
  • MAIL-R-006：邮件存在时效，超过保存时间后自动删除，奖励也不可再领取。
  • MAIL-R-007：邮件列表应支持分批加载；打开界面默认展示最新一批邮件，玩家继续下拉时加载更早邮件。
  • MAIL-R-008：一键删除只处理已读且无未领取奖励的邮件；未读邮件和仍有未领取奖励的邮件不应被删除。
  • MAIL-R-009：一键领取会领取所有未领取附件，不受已读/未读状态影响；同类道具在通用奖励弹窗中合并展示。
  • MAIL-R-010：邮件排序优先级为未读优先、奖励未领取优先、时间较晚优先。

12.3 执行层验收​

  • 如填写操作矩阵，成功路径、失败场景、玩家反馈和状态权威均已覆盖。
  • 如填写 UI 页面状态表，页面 / 弹窗状态均已覆盖，或明确标记为 N/A。
  • Section 7 中标记为 PLAN 前或执行前阻塞的 contract 已在 contract-registry.yaml、execution brief 或执行任务中确认。
  • 相关 Feature Relations 回归通过。

13. 待澄清问题 / Open Questions​

  • 邮件最大数量、保存时长、批量加载每批数量和系统邮件优先级需要确认。
  • 超过数量上限时，未过期或带未领取奖励的旧邮件是否仍会被强制删除，需要制作人确认。

14. 变更记录​

日期版本修改人变更摘要
2026-10-13B1-A draftAutoDev SymphonyWEN-8 整理规则归属、来源状态与待裁定项；原审核事实保留，不修改游戏行为或发布 SDK brief。
2026-06-16v0.2Codex补充规则编号、操作矩阵、UI 状态表、逻辑字段和执行层验收锚点
2026-06-16v0.1Codex按新版功能策划案模板重排章节；保留既有规则内容并映射参考图

7.1 界面图与交互说明​

暂无