KIRAKIRA 的 Android 客户端，使用 Kotlin + Jetpack Compose，设计语言为 Material 3 Expressive，图标采用官方 Material Symbols Rounded。
当前已接入 Rosales 账号 API，支持登录、注册、找回密码及本机多账号会话。首页视频、关键词／多标签搜索、作者资料、评论与弹幕接入真实数据，支持 Media3 播放、应用内小窗和系统画中画。
| 功能 | 当前状态 |
|---|---|
| 主界面 | 首页、搜索、关注、我四个 Tab，支持切换动效和页面状态恢复；关注仍为占位内容 |
| 视频搜索 | 关键词提交、多标签交集搜索、候选标签多选、网格／列表切换及返回结果的本地排序，支持刷新与失败重试 |
| 历史记录 | 云端视频历史、标题／作者搜索、日期分组和进度展示，首 P 支持进度同步与自动续播 |
| 视频页 | 真实视频详情与分 P 播放、全屏、应用内小窗和系统画中画，支持关注、赞踩、评论分页、弹幕叠加显示与评论／弹幕发布 |
| 外观 | 明暗模式、统一经典强调色、预设／壁纸／自定义颜色、毛玻璃应用栏和固定阴影，设置持久保存 |
| 账户与认证 | 密码登录、邮箱／TOTP 二步验证、四步邀请码注册、系统密码选择与保存、找回密码、加密会话、游客／多账号切换及登出 |
| 用户主页与图片 | “我”展示真实账号资料；设置中可编辑完整资料、裁剪与上传头像；本人和作者主页支持关注／粉丝分页列表，头像可放大、保存或复制，作者作品来自 API |
| 账号安全 | 修改邮箱与密码、邮箱二步验证、TOTP 绑定／解绑及一次性备用码与恢复码展示，使用 Material 3 Expressive 页面 |
| 屏蔽与邀请 | 五类屏蔽／隐藏规则管理，邀请码统计、生成、筛选与复制，按账号接入真实 API |
| 关于与开源组件 | AboutLibraries 组件列表、详情与离线许可证阅读 |
| 语言与启动体验 | 中英文界面、跟随系统浅深色的品牌启动屏，以及遵循系统动画设置的启动过渡 |
界面默认跟随系统语言，Android 13+ 可使用系统应用语言设置；用户发布内容保留原文。主题默认使用项目粉色，壁纸取色为 Android 12+ 的可选颜色来源。
外观、播放与弹幕显示设置、加密账号会话会持久保存；小窗与视频页共用播放会话，关闭小窗后停止播放；进程重建不自动恢复播放。历史记录与首 P 播放进度保存至云端；自己与作者的资料、视频均来自 API，收藏等入口及部分设置仍未接入业务。具体交互、保存范围和已知限制见功能现状。
运行设备最低要求为 Android API 27。开发需要兼容当前工具链的 Android Studio、JDK 25，以及匹配 compileSdk 37（minor API 2） 的 Android SDK Platform。开发环境及配置来源见开发指南。
- 使用 Android Studio 打开项目根目录，配置 Gradle JDK，并安装所需 SDK。
- 同步 Gradle；首次同步需要下载 Gradle 与依赖，由 IDE 生成本机
local.properties，不要提交该文件。 - 连接启用 USB 调试的设备，或准备满足最低版本要求的模拟器，选择
app运行配置运行。
也可从项目根目录构建 Debug APK：
./gradlew :app:assembleDebugAPK 输出到 app/build/outputs/apk/debug/。需要安装到设备时执行 ./gradlew :app:installDebug，随后从设备桌面打开应用。Windows 使用 gradlew.bat 替换 ./gradlew。
API 默认连接 https://rosales.kirakira.moe/，构建时可覆盖 HTTPS 地址，见API 环境配置。
代码或构建变更默认只做 Debug 构建；纯文档修改只检查内容与链接。测试、Lint 和设备检查仅按用户明确要求执行，见构建与检查。
| 文档 | 阅读用途 |
|---|---|
| 功能现状 | 各页面能做什么、状态保存与限制 |
| 开发指南 | 环境配置、运行安装、目录结构与可选检查命令 |
| 实现说明 | 导航、主题、认证、共享顶栏接入与动效实现 |
| 贡献指南 | 技术选型、代码与 UI 规范、依赖、检查及提交要求 |
| 代理执行摘要 | 开发者与代码代理的执行约定 |
参与开发前阅读贡献指南，启用 .editorconfig 支持。使用 PR 模板记录变更原因与检查结果。
第三方来源与维护记录：Material Symbols、AOSP 页面转场、开源组件声明。