道具、资源、奖励与背包
0. 本篇结论
本功能定义道具、资源、奖励与背包的功能定位、玩家流程、核心规则、UI 状态、配置与系统边界；当前文档状态为 producer_review_needed，待制作人确认后可作为后续拆分、实现和验收依据。
WEN-9 整理状态与来源（draft）
本节及本批改写为 draft；原 front matter 审核状态保留，不把配置推导升级为批准规则。固定文档来源为 project2-docs master @ ec43be0e13c8624cfafd36c0fd803f3b89733fff，本批基准为 9b54ae56329847babb44b14556c2a6f35402e576；四篇正文及两份查询 JSON 在这两版之间没有变化。获取时间：2026-10-13T06:18:01Z（UTC），方式为 Git 源码与已提交 JSON 只读阅读。
已确认基线只指可复核的来源版本与原审核声明；原候选规则没有新增逐条产品批准凭证。游戏部署版本、库存、发奖、背包 UI 和解锁运行表现均缺运行或人工验收证据。源码/配置 SHA 不是上线版本。
0.1 规则层级与查询入口（draft）
本篇是公共资源与奖励候选规则的正文归属，系统目录只作导航。§5 的 ITEM-RESOURCE-R-001～014 是原候选规则，§12 只检查这些规则，不维护第二份规则正文。§7 的参考图/背包显示方案、§6 的逻辑数据需求与§13 待澄清项均未因此获批。
具体 ID、类型、名称、描述等查道具库（新站不提供配置查询）；具体开放节点查功能开放时间线（新站不提供配置查询）。两者是固定配置快照或外部构建时重新生成的 derived 事实，不是本篇规则的批准记录。玩法/任务/邮件/活动决定奖励条件与数值，商店/充值/抽奖决定交易规则；本篇维护共用资产变化、使用校验与奖励展示，不覆盖上述业务决定。
1. 功能定位
道具和资源系统是 Project2 经济闭环的底层 contract。它统一承载奖励发放、资源消耗、背包展示、道具使用、购买、随机包、合成、奖励弹窗和资源变化通知，服务于战斗、任务、邮件、商店、抽奖、装备、符文、活动、充值和挂机收益。
2. 范围
In Scope：道具定义、货币/材料/消耗品、背包、道具数量、使用、购买、合成、随机奖励、奖励展示、资源变化通知、来源追踪、语言和图标。
Out of Scope：具体投放来源的业务规则、充值订单支付、装备/符文实例规则、单个活动奖励配置。
3. 玩家入口、解锁与提示
玩家通过战斗、任务、邮件、商店、抽奖、活动、充值、挂机和运营补偿获得道具或资源。背包入口展示可见道具，消耗入口分布在各功能系统中。部分道具可在达到功能开放条件后显示或使用。
4. 核心玩家流程
- 玩家从某个系统获得奖励或触发消耗。
- 后端校验发放/消耗规则并更新资源或道具数量。
- 客户端通过响应或通知更新道具模型。
- 客户端展示奖励弹窗、资源变化、背包数量或消耗结果。
- 玩家在背包中查看道具详情，使用可用道具或跳转来源。
- 道具不足时，系统展示获取途径或资源不足提示。
5. 核心规则
5.1 道具定义与分类
ITEM-RESOURCE-R-001：每个道具必须有唯一 ID、类型、名称、描述、品质、图标、堆叠规则、可见规则和使用规则。ITEM-RESOURCE-R-002：道具大类至少包括普通、可使用和货币；普通道具服务于解锁、养成、建造等系统，可使用道具服务于礼包、宝箱、合成、挂机资源等场景，货币以道具 ID 方式映射账号资产并可在 UI 中展示。ITEM-RESOURCE-R-003：道具可继续按细类扩展，例如普通/碎片/材料、礼包/宝箱/挂机、资源/金币/钻石。ITEM-RESOURCE-R-004：道具基础字段需要覆盖 ID、名称、大类、细类、品质、icon、描述、最大堆叠数量、使用方式、使用参数、单次最大使用数量、限时规则和获取途径。
5.2 资源变更与使用校验
ITEM-RESOURCE-R-005：资源变化必须包含物品 ID、数量变化、来源、变化前后状态或足够的审计信息。ITEM-RESOURCE-R-006：使用道具必须校验数量、使用条件、批量规则、奖励产出和背包容量。
5.3 宝箱、合成与挂机资源
ITEM-RESOURCE-R-007：随机宝箱按奖励池和权重随机发放；批量使用时每个宝箱独立随机。ITEM-RESOURCE-R-008：自选宝箱按奖励池展示可选项，玩家确认后获得所选奖励；批量使用时需要分别选择或按规则多选。ITEM-RESOURCE-R-009：合成道具消耗指定数量生成新道具，可批量合成；不足一次合成的余数保留给玩家。ITEM-RESOURCE-R-010：挂机资源道具按当前挂机产量和配置时长计算一次性资源收益。
5.4 购买、随机包与奖励弹窗
ITEM-RESOURCE-R-011：购买道具必须校验价格、货币、限购、广告状态或付费状态。ITEM-RESOURCE-R-012：随机道具包必须定义权重、保底、展示规则和日志追踪。ITEM-RESOURCE-R-013：合成必须定义材料、数量、产物、消耗确认和失败/异常处理。ITEM-RESOURCE-R-014：奖励弹窗应支持多来源奖励合并、排序、品质展示和重复打开保护。
5.5 操作矩阵
N/A。当前不在策划案正文中复述核心玩家流程；进入 PLAN 时，仅对状态变化、消耗/产出、奖励发放、跨系统反馈或失败反馈补齐操作矩阵。
6. 配置、数据与 Contract
本节只记录策划案需要的逻辑数据与跨部门 contract，不预设物理配置表、协议文件、service 文件或 仓库落点。正式命名、字段名、接口名、协议对象名、文件名和仓库落点进入执行前由 Work Package 的 contract-registry.yaml、execution brief 和对应执行任务确认。
6.1 策划数据需求
策划数据需求只描述逻辑数据域、逻辑字段或规则语义，不等同于配置表字段名、协议字段名或数据库字段名。正式字段命名进入 contract-registry.yaml、execution brief 和对应执行任务确认。
| 数据域 | 逻辑字段 / 规则 | 设计含义 | 必填 / 边界 | 产出责任 |
|---|---|---|---|---|
| 道具基础定义 | 道具 ID、名称、类型、品质、图标、描述、堆叠上限、可见规则 | 定义道具 ID、类型、品质、展示和堆叠规则 | 进入执行前补齐默认值、边界和可选性 | Planning |
| 可使用道具规则 | 使用条件、使用参数、批量规则、奖励产出、背包容量 | 定义礼包、宝箱、合成和挂机资源道具的使用方式 | 进入执行前补齐默认值、边界和可选性 | Planning |
| 资源变化来源 | 来源类型、变化前后、数量、变化原因、是否高价值 | 定义所有产出和消耗来源的审计语义 | 进入执行前补齐默认值、边界和可选性 | Planning / Backend |
| 奖励展示规则 | 奖励来源、合并规则、排序、品质表现、重复保护 | 定义奖励弹窗合并、排序和重复打开保护 | 进入执行前补齐默认值、边界和可选性 | Planning / Frontend |
6.2 运行时数据与接口需求
| Contract | 设计含义 | 使用方 | 说明 |
|---|---|---|---|
| 玩家道具库存 | 保存玩家道具数量和资产状态 | 服务端 / 客户端 | 所有发放和消耗以状态权威为准 |
| 道具使用与购买 | 处理使用、批量使用、合成、购买和随机奖励 | 服务端 / 客户端 | 需校验数量、条件、价格、广告和付费状态 |
| 资源变更通知 | 向客户端同步道具和货币变化 | 服务端 / 客户端 / Analytics | 需要足够审计信息和埋点上下文 |
6.3 跨部门 Contract 命名清单
| Contract 类型 | 逻辑对象 | 命名状态 | 阻塞阶段 | 说明 |
|---|---|---|---|---|
| 配置数据 | 道具本体、合成、随机包、公共参数、奖励组和来源枚举 | 待 PLAN 确认 | PLAN 前 | 不预设物理配置表名 |
| 协议 / API | 库存同步、道具使用、购买、资源变化通知 | 待 PLAN 确认 | 执行前 | 由服务端 / UI brief 确认 |
| 错误码 | 数量不足、使用条件不满足、背包容量不足、购买失败 | 待 PLAN 确认 | 执行前 | 需要玩家提示 |
| 语言 Key | 道具名、描述、来源、错误提示和奖励弹窗文案 | 待 PLAN 确认 | 执行前 | 进入语言 brief |
| 资源引用 | 道具图标、品质框和奖励弹窗资源 | 待 PLAN 确认 | 执行前 | 由美术 / UI brief 确认 |
7. UI 状态与交互
7.1 界面图与交互说明
以下图片为待评审参考图，已按图片锚点和附近文字绑定到页面/状态；状态均为 仅参考，最终布局、尺寸、按钮位置和视觉风格以制作人/UI 评审确认为准。
图 01：背包道具设定 / UI设定
- 图状态：仅参考
- 关联页面 / 状态：背包道具设定 / UI设定
- 关联交互 / 状态说明：UI设定
图 02：背包道具设定 / 背包页签不显示红框区域的按钮
- 图状态：仅参考
- 关联页面 / 状态：背包道具设定 / 背包页签不显示红框区域的按钮
- 关联交互 / 状态说明：背包页签不显示红框区域的按钮
图 03：背包道具设定 / 红点需求
- 图状态：仅参考
- 关联页面 / 状态：背包道具设定 / 红点需求
- 关联交互 / 状态说明：红点需求；背包；有随机宝箱；主界面主角图标（红点）——背包标签（红点）——背包中可开启宝箱（红点）；无随机宝箱；合成类型的道具>=合成要求；主界面主角图标（红点）——背包标签（红点）——背包中合成型道具（红点）；合成类型的道具>=合成要求；UI设定
图 04：背包道具设定 / 红点需求
- 图状态：仅参考
- 关联页面 / 状态：背包道具设定 / 红点需求
- 关联交互 / 状态说明：红点需求；背包；有随机宝箱；主界面主角图标（红点）——背包标签（红点）——背包中可开启宝箱（红点）；无随机宝箱；合成类型的道具>=合成要求；主界面主角图标（红点）——背包标签（红点）——背包中合成型道具（红点）；合成类型的道具>=合成要求；UI设定
图 05：背包道具设定 / 红点需求
- 图状态：仅参考
- 关联页面 / 状态：背包道具设定 / 红点需求
- 关联交互 / 状态说明：红点需求；背包；有随机宝箱；主界面主角图标（红点）——背包标签（红点）——背包中可开启宝箱（红点）；无随机宝箱；合成类型的道具>=合成要求；主界面主角图标（红点）——背包标签（红点）——背包中合成型道具（红点）；合成类型的道具>=合成要求；UI设定
图 06：背包道具设定 / UI设定
- 图状态：仅参考
- 关联页面 / 状态：背包道具设定 / UI设定
- 关联交互 / 状态说明：UI设定
图 07：背包道具设定
- 图状态：仅参考
- 关联页面 / 状态：背包道具设定
- 关联交互 / 状态说明：参考图待补充具体交互说明。
图 08：背包道具设定
- 图状态：仅参考
- 关联页面 / 状态：背包道具设定
- 关联交互 / 状态说明：参考图待补充具体交互说明。
图 09：背包道具设定
- 图状态：仅参考
- 关联页面 / 状态：背包道具设定
- 关联交互 / 状态说明：参考图待补充具体交互说明。
图 10：背包道具设定 / 红点需求
- 图状态：仅参考
- 关联页面 / 状态：背包道具设定 / 红点需求
- 关联交互 / 状态说明：红点需求；背包；有随机宝箱；主界面主角图标（红点）——背包标签（红点）——背包中可开启宝箱（红点）；无随机宝箱；合成类型的道具>=合成要求；主界面主角图标（红点）——背包标签（红点）——背包中合成型道具（红点）；合成类型的道具>=合成要求；UI设定
2 张 EMF 格式草稿图因浏览器不可直接显示，暂未映射；如需保留，需先转成 PNG/JPEG。
7.2 页面结构与交互
UI 需要背包列表、道具详情、使用按钮、批量选择、购买弹窗、消耗确认、资源不足提示、奖励弹窗、来源跳转和红点/新获得提示。货币类资源应在顶栏或对应功能入口保持一致展示。
背包只展示普通和可使用道具；货币类道具展示在主界面或对应资源栏。背包格数量暂按不限处理，但客户端和后端仍需有可承载上限。相同可堆叠道具达到最大堆叠数后应另起一格。数量显示需本地化：中文环境大数显示为万并保留小数，非中文环境按 k/m 规则缩写。默认不设置分页筛选，排序优先级为品质高优先，同品质 ID 大优先。
7.3 UI 页面状态表
N/A。当前仅保留已绑定页面/状态的参考图和页面结构说明；具体可执行状态在 UI 评审或 UI brief 中确认。
8. 系统边界
| 方向 | 负责内容 | 备注 |
|---|---|---|
| Planning | 逻辑数据、数值、文本需求、资源需求 | 进入执行前由 PL 任务细化 |
| 服务端 | 协议、校验、持久化、奖励发放、幂等与安全 | 仅相关功能需要 |
| 客户端 | UI、交互、表现、本地状态、红点和跳转 | 仅相关功能需要 |
| 美术 | 图标、模型、特效、音频和导出资源 | 仅相关功能需要 |
| Ops / GM | 后台配置、运营投放、公告、补偿和数据看板 | 仅相关功能需要 |
客户端与表现
PanelGetRewards提供奖励弹窗展示。- 本地展示维护物品数量、锁定/可见状态、背包展示和资源变化。
美术与音频需求
需要道具图标、品质框、货币图标、奖励弹窗表现、获得音效、消耗反馈、资源不足提示和高价值物品特殊展示。所有图标引用需要与配置表和 Unity 资源路径一致。
9. 数值、经济与奖励
道具配置 定义道具本体，道具合成配置 定义合成，随机道具配置 定义随机奖励，公共参数配置 承载通用参数。所有系统发放和消耗都应引用统一道具/资源 ID，避免本地硬编码。经济审核需要覆盖产出、消耗、库存变化、付费货币、免费货币和高价值材料。
10. 异常、安全与运营边界
10.1 异常与安全
需要处理负数数量、重复发放、重复消耗、并发使用、随机包结果篡改、客户端本地数量不同步、奖励弹窗重复展示、配置缺图标/语言和高价值资源误消耗。资源变化必须以服务端为准。
10.2 埋点与运营
建议记录资源获得、资源消耗、道具使用、购买、合成、随机包开启、奖励弹窗曝光、资源不足和来源跳转。经济系统应支持按来源、按物品、按玩家阶段追踪产出消耗。
11. Feature Relations 与回归范围
Feature Relations
被 battle-mission、equipment、rune、shop、lottery、task、mail、recharge-giftpack、home-idle-reward-science、activity-timeopen 依赖。它是多数跨部门 contract 的基础节点。
红点与 main-entry-red-dot 共享：有随机宝箱可开启、合成型道具数量达到合成要求时，需要从背包条目聚合到背包页签和主界面入口。
回归范围
以 Feature Relations 影响功能、核心玩家流程、配置与系统边界为基础；进入执行前由 PLAN / QA brief 细化最小回归范围。
12. 验收标准
12.1 关键验收结论
道具数量、获得、消耗、使用、购买、合成、随机奖励、背包展示、奖励弹窗、资源不足提示、通知同步和埋点来源均正确；所有跨系统奖励和消耗使用统一 contract。
补充验收：道具分类、最大堆叠、限时删除、获取途径跳转、随机宝箱、自选宝箱、合成余数、挂机资源道具、本地化数量缩写、排序和背包红点均需验证。
12.2 规则验收清单
以下仅引用 §5 的原规则正文，编号和验收范围保持不变；勾选记录仍待实际验收，不表示本批已验证。
-
ITEM-RESOURCE-R-001～004：核对 §5.1 道具定义与分类。 -
ITEM-RESOURCE-R-005～006：核对 §5.2 资源变更与使用校验。 -
ITEM-RESOURCE-R-007～010：核对 §5.3 宝箱、合成与挂机资源。 -
ITEM-RESOURCE-R-011～014：核对 §5.4 购买、随机包与奖励弹窗。
12.3 执行层验收
- 如填写操作矩阵，成功路径、失败场景、玩家反馈和状态权威均已覆盖。
- 如填写 UI 页面状态表，页面 / 弹窗状态均已覆盖，或明确标记为
N/A。 - Section 6 中标记为 PLAN 前或执行前阻塞的 contract 已在
contract-registry.yaml、execution brief 或执行任务中确认。 - 相关 Feature Relations 回归通过。
13. 待澄清问题 / Open Questions
- 正式道具类型分类需要确认：货币、材料、消耗品、碎片、礼包、随机包是否全部已覆盖。
- 道具合成是否已在前后端完整实现，还是配置预留。
- 背包容量、过期道具、限时道具和绑定货币是否存在。
- 经济审计要求和资源来源枚举是否已经统一。
14. 变更记录
| 日期 | 版本 | 修改人 | 变更摘要 |
|---|---|---|---|
| 2026-06-16 | v0.2 | Codex | 补充规则编号、操作矩阵、UI 状态表、逻辑字段和执行层验收锚点 |
| 2026-06-16 | v0.1 | Codex | 按新版功能策划案模板重排章节；保留既有规则内容并映射参考图 |
WEN-9 差异与待裁定记录（draft）
| 编号 | 来源与证据 | 影响与待用户裁定 |
|---|---|---|
| B1B-Q01 | 原 §5.1 普通/可使用/货币为候选；固定 docs SHA 下 src/data/item-catalog.json（来源/哈希见道具库（新站不提供配置查询））的类型为普通道具、英雄合成、英雄道具、装备符文、角色装备、随机道具；ID 1 金币、ID 2 钻石的 itemType 均为普通道具、display 为 false | 分类口径与货币展示不能直接等同；请确认两套分类如何对应及采用哪个产品版本。保留两种来源，不修改配置或规则 |
| B1B-Q02 | 原 R-001/004 要求名称和描述；同版 src/data/item-catalog.json 864 条，缺名称 0，缺描述 648（细节见道具库） | 完整描述候选要求与语言快照覆盖不同；请确认缺描述是待补语言还是不适用，不凭备注补造描述 |
| B1B-Q03 | 原 §6.2（本稿§7.2）背包“不限”但需可承载上限，§5.2 要校验容量；§13 容量/限时/绑定仍待确认 | 容量边界缺值，不能作为实现默认值；请明确规则是否保留及上限/有效期适用范围 |
| B1B-Q04 | 原客户端段落提及 PanelGetRewards，没有对应本批实现 SHA/运行证据；B0仅固定源码 refs | 发奖幂等、随机池/保底、合成、UI和红点不能宣布已实现；请提供目标发布版本和外部运行/人工证据 |
重复整理记录：§12.2 原逐条重复的14条规则改为引用§5；原规则及原审核状态仍可在固定来源 SHA 的本路径追溯。末尾重复“7.1 界面图与交互说明/暂无”删除，原实际图文§6.1迁入本稿§7.1，配置原§7迁入§6，同篇引用同步更新；源码检索未发现范围外消费者引用旧UI/配置锚点。既有validator要求的§7.1现在指向真实图文，不设空入口；未删功能入口或迁移路径，范围外引用与导航不需要切换。未新增或扩写测试。本地验证：根据项目策略禁止执行。