道具、资源与背包

本功能统一描述物品身份、库存、使用、奖励反馈与背包。奖励何时产生、购买价格和关卡奖励数值归各业务功能；装备、符文实例分别归养成功能。本文合并原功能说明与《背包道具功能文档》的正文、界面批注和流程图，区别设计要求、暂不制作内容及实现事实。

入口与物品分类

背包从主界面的角色信息区进入。普通与可使用物品在背包展示；货币是账号数值资产，通过统一道具 ID 被其他系统引用，在主界面或对应资源栏展示。

大类	含义	细分示例
普通	本身没有直接使用功能，供解锁、养成、建造等系统消耗	普通、碎片、材料
可使用	在背包直接使用，按使用方式决定操作界面	随机宝箱、自选宝箱、合成、挂机资源
货币	账号资产，以道具身份统一显示和获得	资源、金币、钻石

细类是扩展例子，并不意味着交易行等举例功能已经存在。物品定义需要唯一 ID、名字、大类/细类、品质、图标、说明、堆叠上限、使用方式和参数、单次最大使用数量、限时与获取途径。来源品质枚举为绿/蓝/紫/金/红；实际配置的品质枚举不得根据这张历史表直接修改。

限时设计中，0 表示永久，正数表示有效秒数，到期删除；这是待确认的产品设计，不能仅因表中存在字段就判断当前已经执行到期清理。获取途径允许多个入口，也允许没有入口。

背包展示与交互

• 普通与可使用物品全部展示，不设置筛选分页。优先按品质从高到低，再按 ID 从大到小排列。
• 同种可堆叠物品放在一格，超出堆叠上限另开一格。来源写“暂不限格数，程序可给最大 9999 格”，9999 是建议值而非已确认运行上限。
• 新获得的物品显示 NEW 角标。格子展示品质底框、图标和数量；点击普通物品进入详情，可使用物品按类型进入操作界面。
• 中文及繁体数量超过 9999 使用“万”，保留两位小数；非中文超过 999 使用 k，超过 999k 使用 m。进位/舍入细节尚无进一步设计依据。
• 详情显示品质底图、名称、描述、当前数量、获取途径。获取途径点击后跳到对应功能。
• 2026-06-15 的明确补充限定：专用效果图仅用于背包点击物品；其他界面继续使用黑色 tips。随机宝箱只能在背包使用，其他界面只显示图标、名称、详情和数量。
• 同次补充要求物品 tips 也增加获取途径展示和跳转，覆盖更早图中“仅背包展示获取按钮”的说明；具体未解锁入口反馈需结合目标功能规则。

使用规则

类型	计算与操作	当前设计范围
随机宝箱	参数指定随机池；每个宝箱独立按权重获得奖励；批量开启执行相应次数随机	来源明确需要制作
自选宝箱	从池中选择奖励；每份选择消耗一个箱子，记录总选择数；确认后统一扣除和发奖	来源明确暂不制作、暂无投放计划
合成物品	消耗指定数量获得指定产物；批量次数向下取整，不足一份的余数保留	来源明确暂不制作、暂无投放计划
挂机资源物品	使用时按当前产量乘配置时长计算；多个物品叠加时长收益	来源明确暂不制作、暂无投放计划

“暂不制作”是来源中的设计限定，不代表今天没有相关代码。最新后端 ItemUse 已处理 HeroCompose、NormalCompose 和 RandomItem，其他使用类型返回“未开放的道具使用类型”；因此合成的设计范围与当前实现有明确差异，需要结合实际投放确认，而自选/挂机资源不能从这条接口推定支持。随机宝箱池由池 ID、奖励物品数组、数量数组和权重数组组成；自选池不需要权重。挂机计算示例：100 水晶/分钟 × 2 小时 = 12000 水晶，仅说明公式，不是当前经济数值。

随机宝箱界面同时显示全部可能奖励的品质、图标与数量，奖励列表露出两行半并可滚动，奖励图标可查看详情。批量使用上限取库存与单次使用上限中较小者；确认后依据真实响应扣除、显示奖励，不能用动画完成代替成功。

自选方案中，各项允许分配选择数量，总数不得超过可用箱子；合成的数量选择表示产物份数，上限取材料可支持的份数；挂机物品随选择数量重算收益总量。自选与挂机未由上述接口支持；合成已有后端分支，但实际投放、界面批量行为与这些设计规则是否一致仍待核实。

共用资产与奖励规则

各业务统一使用道具身份，资源变化由服务端权威状态同步。使用或购买需检查库存、条件、批量数量、价格和业务限制；奖励响应区分真实发放与展示。资源变化应有来源和数量变动信息，供经济分析定位。

奖励界面展示本次获得的全部产物，支持品质排序与允许合并的物品聚合。英雄、装备等业务有特殊展示语义时，由对应功能规定，不能全部按背包堆叠方式合并。重复请求、失败响应、资源不足和客户端库存暂未同步不能产生第二次发奖。

红点与界面图

背包有可开启随机宝箱时，从物品条目逐级汇总到背包标签、主界面角色入口；无可开启宝箱时消失。合成材料足够的红点属于暂不制作方案，原表将出现条件和消失条件都写为“数量达到合成要求”，这是未决错误，不能直接当作有效消失规则。

下图集中呈现背包、普通物品详情、随机/自选箱、合成和挂机资源操作之间的关系。后四类中是否制作，以上方范围表为准，图示不扩大实现范围。

核实边界与待确认

后端 88b24abec878dfbd269df5627ca2ce3d37513e12 的 service/role/handler/items/items.go 对角色、物品 ID、数量大于零、整数范围、配置存在与 UseCount 上限进行检查，再检查库存并按物品类型执行使用，统一通过 SubAwards 更新资产并在响应中返回变化；这是静态源码事实，不是联机成功记录。

旧 Markdown 将自选箱、合成、挂机资源写成统一必备规则，遗漏了飞书的“暂不制作”限定；本页恢复该限定。容量、过期删除、当前实际品质与数量格式、获取途径在未解锁功能下的反馈，需要以实现和实际游戏结果继续核实。源表中的 NEW 清除时机没有明确规定。

本文不是测试通过证明；本次只进行文档和源码审计。功能修改、测试执行和缺陷应引用稳定功能标识 item-resource。

依据

• 文档仓库整理前的 features/item-resource.md，原状态为候选。
• 飞书固定来源 ZElUbHUGWoM9jex9NSVclpv8nVc，2026-10-13 采集：《背包道具功能文档》工作表、2026-06-15 补充、两个流程画布；原审核状态未知。
• 本页已将正文及图中文字整合为规则，旧文件仅通过 Git 历史追溯。