Skip to main content

​
架构图

​
服务清单

服务技术栈部署平台用途
kira-beBun + Hono + MastraFly.io (sjc)后端 API
kira-webNext.js 16 + React 19Fly.io (sjc)Web 前端
kira-queueBun + PGMQFly.io (sjc)后台任务
kira-cmsPayload CMS 3.xFly.io (sjc)内容管理
kira-imgproxyimgproxyFly.io (sjc)图片处理
kira-infisicalInfisicalFly.io (sjc)密钥管理

​
数据库 & 存储

​
Supabase (PostgreSQL)

主数据库，提供：
  • PostgreSQL 数据库
  • 实时订阅 (Realtime)
  • 用户认证 (Auth)
  • 对象存储 (Storage)
  • PGMQ 消息队列
主要表：
  • threads - 对话容器
  • messages - 用户和 AI 消息
  • thread_version - 生成图片快照
  • user_profiles - 用户信息和订阅
  • feeds - 公开分享的作品
  • user_liked_feeds - 用户点赞

​
Redis (Upstash)

缓存和临时存储：
  • 会话缓存
  • 速率限制
  • 临时数据

​
LanceDB

向量数据库：
  • 图片 embedding 存储
  • 相似度搜索（防止重复发布）

​
AWS S3

CMS 媒体存储：
  • 博客图片
  • 静态资源

​
AI 服务

​
LLM 提供商

提供商模型用途SDK
xAIGrok-4, Grok-4-Fast主要对话模型@ai-sdk/xai
GoogleGemini 3 FlashThinking 模式@ai-sdk/google
OpenAIGPT-4备用模型@ai-sdk/openai
MistralMistral Large分类任务@ai-sdk/mistral
OpenRouter多模型路由备用@openrouter/ai-sdk-provider

​
图片生成

服务模型/功能用途
BytePlus/Seedreamseedream图片生成、编辑、背景替换
FAL.aiFlux-Pro, Kontext高质量图片生成
Illustrious自定义模型插画风格
OpenAIgpt-image-1图片编辑
Google GeminiFlash Image图片生成（备用）
Replicate多模型通用图片处理

​
图片处理工具

工具功能
generateImageWithAIAI 生图
imageEdit图片编辑
redux图片微调（Seedream）
replaceBackgroundWithImage用图片替换背景（Seedream）
replaceBackgroundWithPrompt用提示词替换背景（Seedream）
upscale图片放大
removeBackground移除背景
inpaint局部重绘
expand图片扩展

​
图片处理

组件用途
Sharp图片缩放、格式转换、压缩
imgproxy动态图片处理和 CDN 优化
blurhash图片模糊占位符

​
监控 & 遥测

​
BetterStack

OpenTelemetry 集成，收集：
  • Logs - 应用日志
  • Traces - 请求追踪
  • Metrics - 性能指标
覆盖服务：kira-be, kira-imgproxy

​
Sentry

错误追踪：
  • 异常捕获
  • 性能监控
  • 用户上下文关联
覆盖服务：kira-be, kira-web

​
PostHog

产品分析：
  • 用户行为追踪
  • 功能使用统计
  • 漏斗分析
覆盖服务：kira-be, kira-web, supabase functions

​
支付

​
Stripe

  • 订阅管理 (Pro/Max 计划)
  • 一次性购买 (Booster)
  • Webhook 集成
  • 客户门户

​
邮件

​
Resend

  • 交易邮件
  • 每日摘要
  • 欢迎邮件

​
其他服务

​
Serper API

Google 搜索功能，用于 Agent 的 googleSearch 工具。

​
Front Chat

客服聊天组件，集成在 kira-web。

​
Voyage AI

文本 embedding 生成，用于向量搜索。

​
Tinify

图片压缩 API。

​
环境变量汇总

​
数据库 & 存储

SUPABASE_URL
SUPABASE_KEY
SUPABASE_JWT_SECRET
POSTGRES_URL
REDIS_URL
LANCEDB_URI
LANCEDB_API_KEY

​
AI 提供商

# LLM
OPENAI_API_KEY
ANTHROPIC_API_KEY
GOOGLE_GENERATIVE_AI_API_KEY
XAI_API_KEY

# 图片生成
FAL_API_KEY
REPLICATE_API_TOKEN
ILLUSTRIOUS_API_KEY
BYTEPLUS_API_KEY
IDEOGRAM_API_KEY
RECRAFT_API_KEY

# 其他
SERPER_API_KEY
VOYAGE_API_KEY

​
监控

BETTERSTACK_HOST
BETTERSTACK_TOKEN
SENTRY_DSN
POSTHOG_API_KEY
POSTHOG_PROJECT_ID

​
支付 & 邮件

STRIPE_SECRET_KEY
STRIPE_WEBHOOK_SECRET
RESEND_API_KEY

​
图片处理

IMGPROXY_URL
IMGPROXY_KEY
IMGPROXY_SALT

​
部署架构

所有服务部署在 Fly.io，主区域为 sjc (San Jose)。 
┌─────────────────────────────────────────────────────────────┐
│                        Fly.io (sjc)                         │
├─────────────────────────────────────────────────────────────┤
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐    │
│  │ kira-be  │  │ kira-web │  │ kira-cms │  │kira-queue│    │
│  │  8080    │  │   3000   │  │   3000   │  │  worker  │    │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘    │
│                                                             │
│  ┌────────────────┐  ┌────────────────────┐                │
│  │ kira-imgproxy  │  │  kira-infisical    │                │
│  │ img.kira.art   │  │ infisical.kira.art │                │
│  └────────────────┘  └────────────────────┘                │
└─────────────────────────────────────────────────────────────┘