主线通行证

通行证按主线进度开放档位，每档包含免费奖励和付费奖励。达到条件后可领免费档；购买通行证才解锁付费档，已达成档位的付费奖励允许补领。

状态与展示

进度/购买状态	免费档	付费档
未达到关卡条件	不可领、展示要求	不可领；未购买同时显示锁
已达条件，未购买	可领未领免费奖励	锁定
已达条件，已购买	可领未领免费奖励	可领未领付费奖励，包括购买前已达成档
对应奖励已领取	显示领取标识	显示领取标识

领取互不重复，领取免费档不自动领取付费档。购买预览区“立即获得”是当前已达标的全部付费奖励，“总计获得”是整条付费轨奖励总和，不扣除已经领过的奖励，也不把未来档位说成购买即发。

列表定位到最早可领档，否则首个尚未达标档；用户可以滚动查看全部。原表要求下一档自动滚动，当前实现的优先级以上述可领优先逻辑为准。一键领取用 CollectClaimableTaskIds 得到的同一集合计算数量、红点和请求，避免按钮显示可领但请求为空。

入口、红点与按钮

通行证位于活动主界面，旧“特惠”标题不再是唯一入口定义。存在任一已解锁且可领取的奖励时亮红点；尚未购买的锁定付费奖励不单独触发可领红点。主界面预载详情，共享活动刷新负责领取后状态。

无可领项时一键领取按钮灰态，但仍接受点击并提示暂无可领取；不能将外观灰态与完全禁用点击混为同一约定。界面说明、商品名、领取提示随当前语言变化。

当前实现与明确限制

ActivityModel.GetMissionPassStageConfigs 已读取 TbActivityPassconfig，主线通行证购买面板 PanelBuyMissionPass 已注册，旧“没有配置/没有入口”的结论已失效。UnlockMissionPassCommand 当前下单商品 ID 固定为 Product.10usd.Mission；这是配置通用性限制，不是完全没有实现。回执 PassDetail.ActivityId 用于刷新所属活动，不能假设所有通行证永远共用一个活动。

购买、补领、跨档、退款或登录补发本轮没有操作证据；登录补发消费链和特权缓存缺口由充值与礼包集中记录。

界面信息

依据

飞书《活动》通行证规则及界面；frontend Docs/WorkPackages/SevenGoal/ui-plan.md 中通行证后续决定、GiftPack 框架与当前购买/活动实现。两份前端稿重复的 UI 说明合并于本页，技术接线继续归前端技术文档。