邀请好友：邀请码、链接和奖励

玩家看到什么

• 带“复制”和“分享链接”（系统分享面板或剪贴板）的玩家自己的短邀请码。
• 通过邀请码来了多少好友，以及对应的奖励阶梯，可单个或全部领取。
• 输入好友的邀请码：显示新玩家礼物并发放一次。
• 通过邀请链接登录并已绑定的玩家会看到**“你是通过好友的邀请码加入的”**。
• “仍在完成条件”：已输入邀请码、但尚未完成游戏条件的好友。还有条件未完成的新玩家会看到剩余条件和 检查 按钮。

如何运作

• 服务器在界面打开时生成邀请码；共 8 个字母，分隔符和大小写会被忽略。
• 通过邀请链接到来的新玩家，会在登录时自动绑定到邀请者。
• 邀请关闭期间，界面会说明这一点，并且不发送任何请求。
• 如果设置了邀请计入条件，好友只有完成条件后才会计入。在此之前一切都会等待：邀请人的 +1 和排行榜分数、奖励阶梯、新玩家礼物以及好友消费的分成。没有期限。
• 好友登录、打开邀请界面、存入代币或点击 检查 时会检查条件。

开发者须知

邀请通过 @idosgames/core 中的 client.referral 工作。

// 玩家的邀请码和邀请状态，然后新玩家输入好友的邀请码
await client.referral.getUserState()
const res = await client.referral.activateReferralCode('KD7QPX2M') // 整条链接也可以
if (!res.ok) return showError(res.error)
await client.referral.claimInviteRewardsBatch(['friends_1', 'friends_3'])

• activateReferralCode 既接受纯邀请码，也接受玩家粘贴的整条链接。
• 用 claimInviteRewardsBatch 一次领取所有已就绪的奖励。
• 好友等待期间，getUserState() 返回 QualificationPending，剩余条件在 Qualification 中；client.referral.checkQualification() 立即检查。登录后 SDK 会自动检查，且只针对仍在等待的玩家。

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