用途：本参考面向《魔兽世界》正式服插件开发者，整理每周奖励（大宝库）系统的 API，仅适用于正式服，内容对应补丁 12.0.0（构建 65655，2026 年 1 月 28 日）。
主要能力：C_WeeklyRewards 覆盖大宝库界面、活动、奖励与物品选择。活动追踪函数包括 GetActivities(type)、HasAvailableRewards()、CanClaimRewards()、HasGeneratedRewards()、GetNumCompletedDungeonRuns(level)。活动类型枚举 Enum.WeeklyRewardChestThresholdType 含 Activities(0)、RankedPvP(1)、MythicPlus(2)、Raid(3)、World(4)。每条活动含 type、index、threshold、progress、id、level、rewards、rewardOptions 字段。奖励选择相关函数有 ClaimReward(id)、GetItemHyperlink(rewardInfo)、GetExampleRewardItemHyperlinks(id)、AreRewardsForCurrentRewardPeriod()；另有 GetConquestWeeklyProgress() 返回征服进度。
使用方式：在插件中调用上述函数获取活动进度与奖励信息，并监听事件 WEEKLY_REWARDS_UPDATE、WEEKLY_REWARDS_SHOW、WEEKLY_REWARDS_HIDE、WEEKLY_REWARDS_ITEM_CHANGED 做界面更新。
限制与注意事项：奖励在每周重置时生成，重置前 API 不返回数据；ClaimReward() 需要用户交互（硬件事件）；活动类型随赛季变化；每类型有 3 个奖励槽且阈值递增；level 字段含义随类型不同（M+ 为钥石层数、团本为难度、PvP 为评级区间）；示例奖励为可能掉落而非保证；未领取的往期奖励可能失效；HasGeneratedRewards() 表示已生成，HasAvailableRewards() 表示当前可领取。