游戏内邮件：信件、奖励和礼物

玩家看到什么

• 按分类的标签页：全部、奖励、礼物、系统。
• 信件：以玩家语言显示的正文、发件人、横幅、奖励，以及跳转到某个界面或页面的按钮。
• 一次服务器操作完成的**“领取”和“全部领取”**；其他系统尚未领取的奖励排在最上面。
• “赠送礼物”：给好友的免费每日礼物（一键“给所有人”），以及把自己的金币或物品转赠给某位好友。

如何运作

• 其他系统错过的奖励（排行榜回合、团队活动奖品、邀请奖励）都可以直接在这里领取。
• 被拒绝或过期的转赠会退回给发送者。
• 限制、好友关系检查、有效期以及哪些东西可以转赠，都由服务器负责。

开发者须知

邮箱通过 @idosgames/core 中的 client.mailbox 工作。

// 某一分类的信件，然后一次操作领取所有待领取的内容
const mail = await client.mailbox.getMessages({ category: 'Reward' })
const res = await client.mailbox.claimAll()
// 一次给多位好友赠送免费每日礼物
await client.mailbox.sendGift('daily_coins', [friendA, friendB])

• 转赠给好友是 sendTransfer；好友关系和限制由服务器检查。
• 徽标是 getUnreadCount：未读信件和待领取的奖励。

每个字段都在技能 mailbox-system 中有说明，由 SDK 的 MCP 服务器提供。