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 Web 使用 Next.js App Router，所有页面位于 app/ 目录。
路由目录说明
/(home)/首页，产品介绍和入口
/authauth/登录/注册页面
/auth/callbackauth/callback/OAuth 回调 API 路由
/auth/mobile-callbackauth/mobile-callback/移动端 OAuth 回调 API 路由
/generatorgenerator/重定向到 /，实际页面为 /generator/[threadId]
/generator/[threadId]generator/[threadId]/生成器 (核心功能)
/gallerygallery/图库浏览（支持 image / video / audio 三类 feed）
/gallery/@feed/[feedId]gallery/@feed/[feedId]/并行路由 — Feed 详情面板（Image + Video + Audio）
/rewind/[feedId]rewind/[feedId]/时间回溯
/timelinetimeline/时间线
/settingsetting/用户设置
/setting/accountsetting/account/账户设置
/setting/appearancesetting/appearance/外观设置
/setting/billingsetting/billing/订阅与计费
/setting/languagesetting/language/语言设置
/user/[userId]user/[userId]/用户主页

​
页面详情

页面路由说明功能点
首页/产品落地页响应式布局、SEO 优化、多语言支持
认证/auth登录/注册邮箱密码、OAuth (Google, Apple)
生成器/generator/[threadId]核心工作区AI 对话生成、编辑工具栏、实时预览
图库/gallery社区图片浏览瀑布流布局、无限滚动、点赞收藏
时间回溯/rewind/[feedId]编辑历史版本时间线展示、版本对比、一键恢复
时间线/timeline时间线浏览时间线展示
设置/setting/*账户设置账户、外观、计费、语言子页面
用户主页/user/[userId]用户公开信息用户资料、作品列表、关注/粉丝

​
中间件

没有根目录 middleware.ts。鉴权 session 刷新在 lib/supabase/middleware.ts，通过 layout/route 组件显式调用。 辅助 proxy.ts 处理：
  • 域名重定向: app.kira.art → kira.art
  • Locale URL 重写: 剥离 [locale] 前缀，设置 x-locale 请求头
  • Supabase session 刷新: 自动续期用户会话
  • X-Robots-Tag 注入: 控制搜索引擎爬取
i18n locale 由 next-intl 插件在构建时处理；app/ 目录不使用 [locale]/ 前缀，locale 选择由 getUserLocale() 按 URL header / cookie / Accept-Language 优先级决定。
中间件 不会 将未登录用户重定向到 /auth。路由保护在客户端通过 useAuthStore 实现。

​
路由保护（客户端）

路由保护通过客户端 useAuthStore 实现，而非中间件： 
// 客户端路由保护示例
const { isAuth } = useAuthStore();
// 未登录时在组件内重定向或显示登录提示
需要登录的路由:
  • /generator/[threadId]
  • /rewind/[feedId]
  • /setting/*
公开路由:
  • /
  • /auth
  • /gallery
  • /user/[userId]
  • /timeline