收藏是一本卡牌图鉴：玩家打开卡包、集齐套组，并和其他玩家交换缺少的卡牌。 每集齐一个套组都有奖励，集齐整本图鉴有大奖。
玩家看到什么
- 图鉴：按顺序排列的每个套组、已有的卡牌（及数量）和空缺。
- 每集齐一个套组的奖励，以及整本图鉴的大奖。
- 卡包：每种卡包和支付方式，可单开或十连开。
- 交换：其他玩家的请求、你自己的请求，以及把多余的卡牌送给好友。
收藏
12 450
320
图鉴1
卡包
交换
“森林”套组 · 8/9
狐狸x2
猫头鹰x1
驼鹿x3
?
集齐图鉴：大奖
打开卡包
1图鉴、卡包和与其他玩家的交换。
2每个套组显示已有卡片和空缺；集齐一套即得奖励。
3集齐整本图鉴得大奖；卡包可单开或十连开。
如何运作
- 卡包由服务器抽取：会显示新卡和重复卡。
- 重复卡变成积分；积分可以购买收藏宝箱。
- 交换在好友之间以及同一游戏的玩家之间进行。
步骤 01把系统加入项目
告诉 AI 编程助手：“加一个卡牌收藏”。它会安装现成的系统，附带一本小图鉴、一种卡包和一个宝箱。
步骤 02在后台中设置
打开后台，选择你的项目，进入 实时运营 → v2 → 收藏。
- 创建图鉴：套组、卡牌和稀有度。
- 设置每个套组的奖励和大奖。
- 创建卡包种类，设置价格和内容，以及用积分购买的宝箱。
页面上的 AI 按钮会打开助手：描述你的需求，它会提出修改，你检查后点击保存。
步骤 03测试并发布
在应用的测试版中检查系统。设置通过单独的操作发送到正式应用，请看发布与链接。
开发者须知
收藏通过 @idosgames/core 中的 client.collection 工作。
// 打开十个卡包，然后领取已集齐套组的奖励
const packs = await client.collection.openPack('forest_album', 'basic_pack', 10)
const res = await client.collection.claimSetReward('forest_album', 'forest_set')
if (!res.ok) return showError(res.error)- 交换是一个由对方接受或拒绝的请求：
sendTradeOffer、acceptTradeOffer。 - 用
claimSetRewardsBatch一次领取所有待领取的套组奖励。
每个字段都在技能 collection-system 中有说明，由 SDK 的 MCP 服务器提供。
常见问题
玩家可以交换卡牌吗？
可以。玩家发送交换请求、接受或拒绝，还可以把多余的卡牌送给好友。
重复的卡牌会怎样？
会变成积分，积分可以购买收藏宝箱。