首页功能卡片管理,用于配置首页展示的 AI 功能卡片。
功能入口
在 Admin 侧边栏 → Operation → Home Cards
https://op.illasoft.com/admin/globals/home-cards
字段说明
| 字段 | 类型 | 必填 | 说明 |
|---|
| cardId | text | ✓ | 卡片唯一标识符(不能有空格),如 ai_filter, prank |
| image | upload | ✓ | 卡片封面图片 |
| arcadeLink | text | | 桌面端 Arcade 教程链接 |
| mobileArcadeLink | text | | 移动端 Arcade 教程链接 |
| requiredPlan | select | ✓ | 最低订阅等级要求(free/basic/pro/max) |
| mediaType | select | ✓ | 卡片类型(image/video/audio),显示为底部 badge |
| model | select | ✓ | AI 模型(lite/nova/crazy/ultra) |
| ratio | select | ✓ | 图片比例(auto/1:1/4:3/3:4/16:9/9:16) |
| inputImages | array | | 点击卡片后自动填充的初始图片 |
Plan Badge
当 requiredPlan 不是 free 时,卡片标题旁会显示渐变 Badge:
| requiredPlan | Badge 显示 |
|---|
| free | 无 |
| basic / basic_year | Basic |
| pro / pro_year | Pro |
| max / max_year | Max |
Badge 使用渐变背景:from-[#a1e60e] via-[#15b5ff] to-[#4574ff]
点击行为
用户点击卡片时的处理逻辑:
- 未登录 → 弹出登录弹窗,登录后自动应用卡片配置
- 已登录但订阅等级不足 → 弹出会员升级弹窗
- 已登录且满足订阅要求 → 直接应用卡片配置进入编辑器
多语言内容
| 字段 | 必填 | 说明 |
|---|
| prompt_en | ✓ | 英文 AI 提示词 |
| prompt_ | | 其他语言提示词 |
| title_en | ✓ | 英文标题 |
| title_ | | 其他语言标题 |
| description_en | ✓ | 英文描述 |
| description_ | | 其他语言描述 |
自动翻译
- 填写英文内容(prompt_en, title_en, description_en)
- 点击”🌐 Translate from English”按钮
- 系统自动翻译为 11 种语言:zh_CN, zh_TW, ja, ko, de, es, fr, it, ms, pt, ru
Arcade 教程引导
当配置了 arcadeLink 或 mobileArcadeLink 后,用户可以通过 ?guide={cardId} 参数访问教程引导弹窗。
工作流程:
- 用户访问
kira.art?guide=ai_filter
- 弹出 Arcade 教程引导弹窗
- 根据设备自动选择桌面端或移动端链接
- 教程进行中显示 “Skip” 文字按钮(低调)
- 教程完成后显示 “Get Started” 按钮(醒目),右上角显示 Plan Badge(如有)
- 点击按钮后根据用户状态处理(见上方”点击行为”)
响应式布局:
- 桌面端:16:9 横屏比例
- 移动端:9:16 竖屏比例
Arcade 教程完成检测需要 Arcade Growth 订阅。系统通过监听 Step Reached 事件的 isFinalStep 字段来判断用户是否完成教程。重要:Arcade 必须放在 Team folder 中,不能放在 “My Arcade” 个人文件夹,否则 postMessage 事件不会发送。