首页功能卡片管理，用于配置首页展示的 AI 功能卡片。2026-03 起使用 V2 架构（Global），V1 已完全删除（Documentation Index
Fetch the complete documentation index at: https://tech.illasoft.com/llms.txt
Use this file to discover all available pages before exploring further.
commit e73bac9）。
功能入口
在 Admin 侧边栏 → Operation → Home Cards V2 https://op.kira.art/admin/globals/home-cards-v2Category Tabs
Admin 界面使用自定义的HomeCardTabs 组件（src/components/HomeCardTabs.tsx:15），按 mediaType 和 isFeatured 分为 4 个标签：
| Tab | 过滤条件 | Add Card 按钮 |
|---|---|---|
| Featured | isFeatured === true | 隐藏（HomeCardTabs.tsx:73-78，commit 71df4f2） |
| Image | mediaType === "image" | 显示 |
| Video | mediaType === "video" | 显示 |
| Audio | mediaType === "audio" | 显示 |
一张卡片可通过切换 isFeatured 布尔进入 Featured。
字段说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cardId | text | ✓ | 卡片唯一标识符（不能有空格），如 ai_filter |
| coverType | select | ✓ | image / video — 决定封面用图还是视频 |
| image | upload | ✓(若 coverType=image) | 卡片封面图 |
| coverVideo | upload | ✓(若 coverType=video) | 卡片封面视频 |
| arcadeLink | text | 桌面端 Arcade 教程链接 | |
| mobileArcadeLink | text | 移动端 Arcade 教程链接 | |
| requiredPlan | select | ✓ | free / basic / basic_year / pro / pro_year / max / max_year |
| isFeatured | checkbox | ✓ | 是否精选（Featured tab 显示） |
| mediaType | select | ✓ | image / video / audio — 决定进入的生成器模式 |
| model | select | ✓ | lite / nova / crazy / ultra AI 模型 |
| ratio | select | ✓ | auto / 1:1 / 4:3 / 3:4 / 16:9 / 9:16 |
| inputMedias | array | 点击卡片自动填充的初始媒体（取代旧 inputImages，支持 {type, url}） |
Plan Badge
当requiredPlan 不是 free 时，卡片标题旁会显示渐变 Badge：
| requiredPlan | Badge 显示 |
|---|---|
| free | 无 |
| basic / basic_year | Basic |
| pro / pro_year | Pro |
| max / max_year | Max |
from-[#a1e60e] via-[#15b5ff] to-[#4574ff]
点击行为
用户点击卡片时的处理逻辑：- 未登录 → 弹出登录弹窗，登录后自动应用卡片配置
- 已登录但订阅等级不足 → 弹出会员升级弹窗
- 已登录且满足订阅要求 → 直接应用卡片配置进入编辑器
多语言内容
| 字段 | 必填 | 说明 |
|---|---|---|
| prompt_en | ✓ | 英文 AI 提示词 |
| prompt_ | 其他语言提示词 | |
| title_en | ✓ | 英文标题 |
| title_ | 其他语言标题 | |
| description_en | ✓ | 英文描述 |
| description_ | 其他语言描述 |
自动翻译
- 填写英文内容（prompt_en_US, title_en_US, description_en_US）
- 点击
HomeCardTranslateButton（🌐 Translate from English） - 系统调用
/api/translate自动翻译为 11 种 locale：zh_CN, zh_TW, ja_JP, ko_KR, de_DE, es_ES, fr_FR, it_IT, ms_MY, pt_PT, ru_RU
Field 命名遵循
{field}_{locale} 模式（如 title_zh_CN）。翻译按钮源码：src/components/TranslateButton.tsx:26。翻译后请检查内容准确性，必要时可手动修改。
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 事件不会发送。