用途:在应用顶部导航栏右侧接入 ibl.ai 积分余额组件 CreditBalance,展示用户剩余积分、当前套餐,并提供升级、添加积分和管理账单流程。组件由 SDK 渲染,底层使用 Stripe,不应自行实现或改样式。
主要能力:触发按钮为 SDK 提供的 Lucide CreditCard 图标按钮,余额偏低时右上角显示状态点;点击展开宽 320px 下拉面板,显示剩余积分、已用积分、重置日期和账单标签;免费套餐显示升级计划 CTA,添加支付方式后切换为管理用量和添加积分;升级或管理账单会跳转 Stripe Checkout 或客户门户,完成后返回应用 origin。
使用方式:前置条件为已配置认证、导航栏、安装 @iblai/iblai-js SDK、Tailwind v4 并配置 SDK 的 @source 指令,且租户启用 paywall。该技能不生成新文件,只把 SDK 的 CreditBalance 接入现有导航栏。需在 iblai-styles.css 中同时加入两条 @source 指令,分别指向 web-containers/source 和 source/next;从 @iblai/iblai-js/web-containers 导入组件,不要从 /next 导入;在导航栏右侧、通知铃之前渲染,传入 tenant、enabled=true、redirectUrl=window.location.origin、mainPlatformKey、currentUserEmail、username。
限制:不要添加自定义样式、颜色或 CSS 覆盖,不要用 className 替换图标或改尺寸;redirectUrl 只能用 origin,不能用 href 或路径;必须同时满足租户 show_paywall 为 true、用户为管理员或试用用户、已登录三个条件才渲染,否则面板会显示错误或操作无效;enabled 不能替代可见性判断。若图标尺寸异常,通常是 SDK 源目录未被 Tailwind 扫描。具体收费、价格和平台支持范围暂未提供。