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

玩家看到什么

• 带“复制”和“分享链接”（系统分享面板或剪贴板）的玩家自己的短邀请码。
• 通过邀请码来了多少好友，以及对应的奖励阶梯，可单个或全部领取。
• 输入好友的邀请码：显示新玩家礼物并发放一次。
• 通过邀请链接登录并已绑定的玩家会看到**“你是通过好友的邀请码加入的”**。

如何运作

• 服务器在界面打开时生成邀请码；共 8 个字母，分隔符和大小写会被忽略。
• 通过邀请链接到来的新玩家，会在登录时自动绑定到邀请者。
• 邀请关闭期间，界面会说明这一点，并且不发送任何请求。

开发者须知

邀请通过 @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 一次领取所有已就绪的奖励。

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