Skip to main content

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.

​
分析平台

Kira 使用 PostHog 进行用户行为分析。

​
当前在用事件清单（权威）

event_name侧触发位置关键属性
kira_signupbackend (supabase function)auth.users INSERT webhookemail, name
chatbackend (kira-be)POST /agent/streamingthread_id, model
chat_completionbackend (kira-be)主 agent onFinishmodel / input_tokens / output_tokens / duration_ms / tool_calls
sub_callbackend (kira-be)工具内 LLM 子调用tool_name / model / input_tokens / output_tokens / duration_ms
media_usagebackend (workers)视频/音乐生成 finalizetask_id / tool_name / provider / model / output_duration_ms
tool_usagebackend (kira-be / workers)tool 完成tool_name、success、duration_ms、credits_consumed
thread_createdbackendPOST /thread/thread_id
feed_publishedbackendPOST /publish/*feed_id、media_type、feed_image_id/video_id/audio_id、flag
feed_deletedbackendDELETE /feed/:idfeed_id、media_type
csam.blocked.image_uploadbackend图片上传 CSAM 命中user_id、image_id
csam.blocked.avatar_uploadbackend头像 CSAM 命中user_id、file_id、removed
user_input_confirmedfrontend only用户 Selector 确认tool、source (ai/toolbar)、extra
feed_liked / feed_unlikedfrontendlike 按钮feed_id
filter_liked / filter_unlikedfrontend滤镜收藏
homecard_clickedfrontend首页 HomeCard 点击card_id
announcement_clickedfrontend
booster_purchasekira-sg-billingStripe webhook (checkout.session.completed mode=payment)

​
已知缺口（尚未追踪）

以下事件当前代码中没有埋点，执行时请注意：
  • user_registered / user_deleted（目前只有 signup webhook 一条路径）
  • Feed like/unlike 后端侧 (PUT/DELETE /like/:feedId) 无 PostHog capture，只有前端自己埋
  • Trending 点击无专门事件
  • CSAM 相关事件在后端使用 log() 而非 posthog.capture()，可能只到 BetterStack 日志不到 PostHog

​
自动采集

以下属性由 PostHog 自动采集，无需手动传递：
属性说明
$os操作系统
$browser浏览器
$device_type设备类型
$current_url当前页面 URL
$referrer来源页面
$screen_height屏幕高度
$screen_width屏幕宽度

​
前端 Analytics Hook

import { useAnalytics } from '@/lib/analytics';

const { trackUserInputConfirmed } = useAnalytics();

trackUserInputConfirmed(
  'applyFilter',     // tool
  threadId,          // threadId
  'toolbar',         // source: 'ai' | 'toolbar'
  {                  // extra (可选)
    image_id: image?.imageId,
    filter_id: filter.id,
  }
);

​
Source 判断逻辑

触发路径Source 值说明
AI 对话 → SubPageai图片不在 currentImages 中
AI 对话 → EditModeai通过 editModeData.source 传递
工具栏点击 → EditModetoolbar默认值

​
事件流转图

2026-04 弃用 ai_cost。Token 用量由 chat_completion (主 agent) 和 sub_call (工具内子调用) 上报；视频/音乐输出时长由 worker 的 media_usage 上报。埋点不再计算金额。