Skip to main content
首页功能卡片管理,用于配置首页展示的 AI 功能卡片。

功能入口

在 Admin 侧边栏 → Operation → Home Cards https://op.illasoft.com/admin/globals/home-cards

字段说明

字段类型必填说明
cardIdtext卡片唯一标识符(不能有空格),如 ai_filter, prank
imageupload卡片封面图片
arcadeLinktext桌面端 Arcade 教程链接
mobileArcadeLinktext移动端 Arcade 教程链接
requiredPlanselect最低订阅等级要求(free/basic/pro/max)
mediaTypeselect卡片类型(image/video/audio),显示为底部 badge
modelselectAI 模型(lite/nova/crazy/ultra)
ratioselect图片比例(auto/1:1/4:3/3:4/16:9/9:16)
inputImagesarray点击卡片后自动填充的初始图片

Plan Badge

requiredPlan 不是 free 时,卡片标题旁会显示渐变 Badge:
requiredPlanBadge 显示
free
basic / basic_yearBasic
pro / pro_yearPro
max / max_yearMax
Badge 使用渐变背景:from-[#a1e60e] via-[#15b5ff] to-[#4574ff]

点击行为

用户点击卡片时的处理逻辑:
  1. 未登录 → 弹出登录弹窗,登录后自动应用卡片配置
  2. 已登录但订阅等级不足 → 弹出会员升级弹窗
  3. 已登录且满足订阅要求 → 直接应用卡片配置进入编辑器

多语言内容

字段必填说明
prompt_en英文 AI 提示词
prompt_其他语言提示词
title_en英文标题
title_其他语言标题
description_en英文描述
description_其他语言描述

自动翻译

  1. 填写英文内容(prompt_en, title_en, description_en)
  2. 点击”🌐 Translate from English”按钮
  3. 系统自动翻译为 11 种语言:zh_CN, zh_TW, ja, ko, de, es, fr, it, ms, pt, ru
翻译后请检查内容准确性,必要时可手动修改。

Arcade 教程引导

当配置了 arcadeLinkmobileArcadeLink 后,用户可以通过 ?guide={cardId} 参数访问教程引导弹窗。 工作流程
  1. 用户访问 kira.art?guide=ai_filter
  2. 弹出 Arcade 教程引导弹窗
  3. 根据设备自动选择桌面端或移动端链接
  4. 教程进行中显示 “Skip” 文字按钮(低调)
  5. 教程完成后显示 “Get Started” 按钮(醒目),右上角显示 Plan Badge(如有)
  6. 点击按钮后根据用户状态处理(见上方”点击行为”)
响应式布局
  • 桌面端:16:9 横屏比例
  • 移动端:9:16 竖屏比例
Arcade 教程完成检测需要 Arcade Growth 订阅。系统通过监听 Step Reached 事件的 isFinalStep 字段来判断用户是否完成教程。重要:Arcade 必须放在 Team folder 中,不能放在 “My Arcade” 个人文件夹,否则 postMessage 事件不会发送。