# Empyrean

**Repository Path**: zhangkede/empyrean

## Basic Information

- **Project Name**: Empyrean
- **Description**: 苍穹AI短剧：一个专注于利用AI技术创作高质量短剧的开源项目，结合自然语言处理与机器学习，为创作者提供便捷的剧本生成与角色表演工具。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-05
- **Last Updated**: 2026-10-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Empyrean - AI 短剧平台

基于 Kotlin Multiplatform 构建的 AI 驱动短剧内容平台，支持 Android、iOS、Web、Desktop 多端一致体验。

---

## 📋 目录

- [项目简介](#-项目简介)
- [目标用户](#-目标用户)
- [功能特性](#-功能特性)
- [技术架构](#-技术架构)
- [核心用户流程](#-核心用户流程)
- [项目结构](#-项目结构)
- [快速开始](#-快速开始)
- [配置说明](#-配置说明)
- [功能预览](#-功能预览)
- [API 接口](#-api-接口)
- [风险与应对](#-风险与应对)
- [贡献指南](#-贡献指南)
- [许可证](#-许可证)
- [联系方式](#-联系方式)

---

## 🎯 项目简介

Empyrean 是一个创新的短剧内容平台，采用 **"AI 生成 + 人工创作"** 混合模式，降低创作门槛的同时保证内容质量。

### 核心目标

1. **AI 驱动创作**: 基于大语言模型的智能剧本生成，支持多种风格和主题
2. **跨平台体验**: 一套代码，多端运行（Android、iOS、Web、Desktop）
3. **沉浸式阅读**: 流畅的场景切换和个性化阅读体验
4. **互动社区**: 点赞、评论、收藏、分享一应俱全
5. **内容生态**: 完整的内容创作、消费和管理体系

### Non-Goals（不在范围内）

- ❌ 不包含视频剪辑和后期制作功能（聚焦文字/图文短剧）
- ❌ 不提供真人演员和拍摄服务
- ❌ 不涉及直播功能
- ❌ 不开发独立的支付系统（初期使用第三方支付或免费）
- ❌ 不开发独立的 IM 聊天功能（初期使用评论互动）
- ❌ 不做深度的 AI 视频生成（MVP 阶段聚焦文字剧本）

---

## 👥 目标用户

| 用户类型 | 描述 | 需求 |
|----------|------|------|
| **内容创作者** | 希望快速生成短剧剧本、降低创作成本的个人/团队 | AI 辅助创作、便捷编辑、作品管理 |
| **普通用户** | 喜欢观看短剧、追求新鲜娱乐体验的年轻群体 | 优质内容推荐、沉浸式阅读、个性化设置 |
| **社交分享爱好者** | 乐于创作和分享有趣内容的社交活跃用户 | 便捷分享、互动评论、社区交流 |
| **营销从业者** | 需要快速生成营销内容的品牌/广告从业者 | 高效内容生产、品牌曝光 |

---

## ✨ 功能特性

### 1. AI 创作中心
- ✅ AI 剧本生成（支持多种风格和主题）
- ✅ 创作模板选择（都市、言情、悬疑、搞笑等）
- ✅ 关键词驱动生成
- ✅ 风格/调性选择（轻松、紧张、治愈、烧脑）
- ✅ 短剧长度自定义（3-50 场景）
- ✅ 生成结果实时编辑调整
- ✅ 草稿自动保存与恢复
- ✅ 生成历史记录管理
- ✅ 短剧预览与发布流程

### 2. 内容浏览系统
- ✅ 首页推荐短剧列表（个性化推荐）
- ✅ 短剧分类浏览（题材、时长、热度）
- ✅ 全文搜索功能（关键词、作者、标签）
- ✅ 排行榜系统（热度榜、新书榜、好评榜）
- ✅ 下拉刷新与无限滚动
- ✅ 短剧卡片展示（封面、标题、作者、热度）

### 3. 内容播放系统
- ✅ 场景顺序浏览播放
- ✅ 自动播放与手动切换
- ✅ 播放速度调节（0.5x ~ 2x）
- ✅ 字体大小调整
- ✅ 阅读背景色切换
- ✅ 全屏模式支持
- ✅ 阅读进度记忆
- ✅ 章节快速跳转
- ✅ 夜间模式支持

### 4. 用户互动系统
- ✅ 点赞/取消点赞（实时更新、可撤销）
- ✅ 收藏/取消收藏（加入收藏列表）
- ✅ 评论发表与回复（实时显示）
- ✅ 评论删除（本人评论）
- ✅ 分享功能（微信、微博、QQ、复制链接）
- ✅ 关注/取消关注作者
- ✅ 评论点赞功能
- ✅ 评分系统（1-5星）

### 5. 用户系统
- ✅ 匿名登录
- ✅ 手机号登录（验证码验证）
- ✅ 用户名密码登录
- ✅ 用户状态持久化（重启保持登录）
- ✅ Token 自动刷新
- ✅ 个人资料管理（头像、昵称、简介）
- ✅ 登出功能（清除用户数据）

### 6. 个人中心
- ✅ 我的作品列表（编辑/删除）
- ✅ 我的收藏列表（取消收藏）
- ✅ 浏览历史记录（清除历史）
- ✅ 作者个人主页（作品列表、统计数据）
- ✅ 关注/粉丝列表
- ✅ 消息通知列表
- ✅ 设置页面（主题、字体、通知）

### 7. 离线阅读功能
- ✅ 短剧内容离线缓存（SQLDelight存储）
- ✅ 自动缓存收藏的短剧
- ✅ 手动下载指定短剧（支持暂停/取消）
- ✅ 缓存空间管理（清理、大小上限）
- ✅ 离线自动切换到缓存内容

### 8. 内容审核机制
- ✅ AI内容审核API集成（百度、阿里云）
- ✅ 用户举报功能（多种举报类型）
- ✅ 内容发布前预审核
- ✅ 违规内容自动下架机制
- ✅ 审核管理后台API

### 9. 创作者激励机制
- ✅ 作品打赏功能（微信支付、支付宝）
- ✅ 创作者分成体系（平台30%:创作者70%）
- ✅ 创作排行榜和荣誉体系（5个等级）
- ✅ 创作者数据统计面板
- ✅ 粉丝打赏排行榜

### 10. 数据统计与分析
- ✅ 用户行为分析（浏览、点赞、收藏、分享）
- ✅ 内容热度统计和趋势分析
- ✅ 用户留存率分析（DAU/WAU/MAU、LTV）
- ✅ 创作者数据分析面板
- ✅ 运营后台数据可视化（Dashboard API）

### 11. 多语言支持
- ✅ 应用多语言国际化（中文、英文）
- ✅ 语言切换功能
- ✅ UI文本国际化
- ✅ 内容语言检测和筛选

### 12. 推送通知系统
- ✅ 消息推送服务架构（多渠道支持）
- ✅ 通知类型定义（新作品、评论、点赞、打赏、系统通知）
- ✅ 推送渠道集成（FCM、极光、个推、Web Push）
- ✅ 客户端推送接收处理
- ✅ 消息订阅/退订（免打扰时段）

### 13. 社交动态订阅
- ✅ 动态订阅服务（全部/仅新作品/仅互动）
- ✅ 动态信息流（分页加载、下拉刷新）
- ✅ 动态推送（新作品自动推送）
- ✅ 动态管理（隐藏、已读/未读、清除历史）

### 14. 高级搜索与智能推荐
- ✅ 全文搜索（标题、描述、内容）
- ✅ 多条件筛选（分类、标签、作者、时长、热度）
- ✅ 排序选项（相关度、热度、最新、最多点赞）
- ✅ 搜索建议和热词推荐
- ✅ 智能推荐系统（协同过滤、内容相似度）
- ✅ 个性化推荐（用户画像）
- ✅ 热门推荐（全局热度）

### 15. 私信系统
- ✅ 用户间一对一私信会话
- ✅ 实时消息推送（WebSocket）
- ✅ 未读消息计数和角标
- ✅ 消息已读状态标记
- ✅ 会话管理（创建、删除、查询）
- ✅ 消息历史记录分页加载
- ✅ 黑名单功能（屏蔽特定用户）

### 16. 付费内容和会员
- ✅ 创作者可设置短剧价格
- ✅ 付费内容解锁机制
- ✅ 会员订阅系统（月度、季度、年度）
- ✅ 会员权益展示
- ✅ 支付功能集成（支付宝、微信）
- ✅ 支付历史记录
- ✅ 自动续费设置
- ✅ 会员专属内容访问

### 17. AI写作助手
- ✅ 智能续写功能
- ✅ 内容改写（多种风格）
- ✅ 内容优化建议
- ✅ 内容质量评分
- ✅ SEO优化建议
- ✅ 创作效率提升

### 18. 创作工具箱
- ✅ AI助手界面集成
- ✅ 续写选项展示
- ✅ 质量检测面板
- ✅ SEO优化建议面板
- ✅ 批量管理工具
- ✅ 与现有编辑器风格一致

### 19. 无障碍访问
- ✅ UI语义化标签（符合WCAG 2.1 AA标准）
- ✅ 图片替代文本
- ✅ 字体缩放功能（0.8x-2.0x）
- ✅ 高对比度模式
- ✅ 键盘导航完整支持
- ✅ 屏幕阅读器兼容性

### 20. 数据导出
- ✅ 个人数据导出（个人信息、互动记录等）
- ✅ 创作内容导出（作品、草稿等）
- ✅ JSON格式导出
- ✅ ZIP格式打包导出
- ✅ 异步导出任务管理

### 21. 运营管理后台
- ✅ 用户管理（列表、封禁、角色管理）
- ✅ 内容管理（审核队列、批量操作、分类管理）
- ✅ 创作者管理（认证、等级、收益管理）
- ✅ 客服工单系统（提交、处理、统计）
- ✅ 系统配置（参数配置、功能开关、安全设置）

### 22. 深度数据分析
- ✅ 用户画像分析（兴趣标签、行为特征）
- ✅ 用户分群API
- ✅ 用户生命周期分析
- ✅ LTV预测分析
- ✅ A/B测试平台（实验配置、流量分配、结果分析）

### 23. 开放API生态
- ✅ API网关（认证、限流、日志）
- ✅ API Key管理（申请、审批、权限）
- ✅ OpenAPI文档生成
- ✅ Webhook通知系统（配置、订阅、重试）

### 24. 社交平台集成
- ✅ 微信小程序内容同步
- ✅ 微信公众号登录集成
- ✅ 微信分享增强
- ✅ 微信支付集成

### 25. 用户成长体系
- ✅ 积分获取和消耗机制
- ✅ 用户等级系统（经验值、等级规则）
- ✅ 用户勋章系统（成就体系）
- ✅ 每日任务和签到奖励
- ✅ 成长值展示和排行榜

### 26. 内容协作创作
- ✅ 多人协作编辑短剧
- ✅ 版本历史记录和回滚
- ✅ 协作权限管理
- ✅ 协作邀请和加入
- ✅ 实时编辑同步

### 27. 剧本模板市场
- ✅ 模板发布和分享
- ✅ 模板分类和搜索
- ✅ 模板使用记录
- ✅ 模板评价和收藏
- ✅ 模板推荐和热门榜

### 28. AI 能力增强
- ✅ AI 封面图片生成（根据内容生成封面）
  - 支持多种艺术风格（动漫、写实、水彩、像素等）
  - 智能提示词构建（基于短剧内容）
  - 多图片生成供选择
  - 封面历史记录管理
  - Mock 模式（开发测试用）
- ✅ 情节分支选择（多结局剧情）
- ✅ AI 角色对话（生成角色互动）
- ✅ AI 配乐推荐（根据内容推荐音乐）

### 29. 多媒体内容支持
- ✅ 图片上传和管理
- ✅ 音频播放和上传
- ✅ 图文混排展示
- ✅ 背景音乐支持

### 30. 个性化首页配置
- ✅ 首页模块自定义
- ✅ 内容排序自定义
- ✅ 主题和配色自定义
- ✅ 自动播放设置

### 31. 全局悬浮 AI 助手
- ✅ 悬浮按钮组件
  - 可拖动并吸附到屏幕边缘
  - 显示/隐藏动画效果
  - 设置选项控制显示
- ✅ AI 对话面板
  - 多轮对话支持
  - 消息列表展示
  - 消息输入和发送
  - 面板展开/收起动画
- ✅ 快捷操作功能
  - 快速生成（跳转到创作页面）
  - 智能续写
  - 内容改写
  - 内容优化
- ✅ 对话历史管理
  - 历史记录保存
  - 历史对话加载和继续
- ✅ 上下文感知
  - 当前页面类型感知
  - 编辑状态感知
  - 根据上下文动态显示快捷操作

---

## 🛠️ 技术架构

### 整体架构

```
┌─────────────────────────────────────────────────────────┐
│                     客户端层 (KMP)                       │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌────────────┐  │
│  │ Android │  │   iOS   │  │   Web   │  │  Desktop   │  │
│  └─────────┘  └─────────┘  └─────────┘  └────────────┘  │
├─────────────────────────────────────────────────────────┤
│                   共享业务层 (KMP)                       │
│  ┌────────────┐  ┌────────────┐  ┌──────────────────┐   │
│  │  UI 组件库  │  │  状态管理  │  │  网络/数据存储   │   │
│  └────────────┘  └────────────┘  └──────────────────┘   │
├─────────────────────────────────────────────────────────┤
│                    服务端层 (Ktor)                       │
│  ┌────────────┐  ┌────────────┐  ┌──────────────────┐   │
│  │ API 网关   │  │ 业务服务   │  │ AI 集成服务      │   │
│  └────────────┘  └────────────┘  └──────────────────┘   │
├─────────────────────────────────────────────────────────┤
│                    数据层                                │
│  ┌────────────┐  ┌────────────┐  ┌──────────────────┐   │
│  │ PostgreSQL │  │   Redis    │  │  对象存储 (OSS)  │   │
│  └────────────┘  └────────────┘  └──────────────────┘   │
└─────────────────────────────────────────────────────────┘
```

### 核心技术栈

| 分类 | 技术 | 版本 | 说明 |
|------|------|------|------|
| 客户端框架 | Compose Multiplatform | 1.11.0 | 跨平台 UI 框架 |
| 服务端框架 | Ktor | 3.4.3 | Kotlin Web 框架 |
| 语言 | Kotlin | 2.3.21 | 主开发语言 |
| 状态管理 | ViewModel + StateFlow | - | 响应式状态管理 |
| 网络请求 | Ktor Client | 3.4.3 | 多平台 HTTP 客户端 |
| 数据持久化 | SQLDelight + DataStore | - | 数据库 + 键值存储 |
| 依赖注入 | Koin | 3.5.0 | 轻量级 DI 框架 |
| AI 集成 | OpenAI / 文心一言 / 通义千问 | - | 多服务商支持 |

### 关键设计

- **模块化架构**: 清晰的模块划分，便于维护和扩展
- **MVVM 模式**: ViewModel + StateFlow 实现响应式 UI
- **Repository 模式**: 数据访问抽象层
- **策略模式**: 支持切换多个 AI 服务商
- **乐观更新**: 点赞/收藏等操作即时响应，失败后回滚

---

## 🔄 核心用户流程

### 1. 内容消费流程
```
首页浏览 → 选择短剧 → 播放短剧 → 互动（点赞/评论/收藏）→ 分享 → 推荐更多
```

### 2. 内容创作流程
```
进入创作中心 → 选择创作方式（AI生成/手动创作）→ 输入/编辑内容 → 预览 → 发布 → 管理作品
```

### 3. AI 创作流程
```
选择模板/主题 → 输入关键词 → 选择风格/调性 → AI生成 → 编辑调整 → 保存/发布
```

### 4. 用户登录流程
```
选择登录方式 → 验证身份 → 获取 Token → 持久化状态 → 进入首页
```

---

## 📁 项目结构

```
Empyrean/
├── app/                    # 客户端应用
│   ├── androidApp/         # Android 平台
│   │   ├── src/main/       # 主源码目录
│   │   └── build.gradle.kts
│   ├── iosApp/             # iOS 平台
│   │   ├── iosApp/         # Swift 桥接代码
│   │   └── build.gradle.kts
│   ├── desktopApp/         # Desktop 平台
│   │   ├── src/main/       # 主源码目录
│   │   └── build.gradle.kts
│   ├── webApp/             # Web 平台
│   │   ├── src/webMain/    # Web 源码
│   │   └── build.gradle.kts
│   └── shared/             # 共享 UI 代码（Compose Multiplatform）
│       └── src/commonMain/ # 多平台共享代码
├── core/                   # 核心模块（多平台共享）
│   ├── src/commonMain/     # 共享代码（数据模型、网络、存储）
│   ├── src/jvmMain/        # JVM 平台特定代码
│   ├── src/jsMain/         # JavaScript 平台特定代码
│   └── src/nativeMain/     # Native 平台特定代码
├── server/                 # 服务端代码（Ktor）
│   ├── src/main/kotlin/    # Kotlin 服务端代码
│   └── src/main/resources/ # 配置文件（application.conf、数据库迁移）
├── gradle/                 # Gradle 配置
│   └── libs.versions.toml  # 依赖版本管理
├── gradle.properties       # Gradle 属性配置
└── settings.gradle.kts     # 项目模块配置
```

---

## 🚀 快速开始

### 环境要求

| 平台 | 要求 |
|------|------|
| JDK | 21+ |
| Android Studio | Hedgehog (2023.1.1) |
| Xcode | 15+ (for iOS) |
| Node.js | 20+ (for Web) |

### 构建命令

```bash
# 编译所有模块
./gradlew build

# 运行 Android 应用
./gradlew :app:androidApp:installDebug

# 运行 iOS 应用
./gradlew :app:iosApp:run

# 运行 Web 应用
./gradlew :app:webApp:jsBrowserRun

# 运行 Desktop 应用
./gradlew :app:desktopApp:run

# 运行服务端
./gradlew :server:run
```

### 开发环境配置

```bash
# 首次构建前，确保已安装必要依赖
./gradlew wrapper --gradle-version 8.5

# 清理构建缓存
./gradlew clean

# 仅编译共享模块
./gradlew :app:shared:compileKotlinJvm
```

---

## 🔧 配置说明

### 环境变量

在 `core/src/commonMain/kotlin/com/pragmatic/empyrean/core/config/AppConfig.kt` 中配置：

```kotlin
object AppConfig {
    const val API_BASE_URL = "https://api.empyrean.com"
    const val API_VERSION = "v1"
    const val DEBUG = true
    // ...
}
```

### AI 服务配置

服务端 `server/src/main/resources/application.conf`：

```hocon
ktor {
    ai {
        openai {
            api-key = "your-openai-api-key"
            base-url = "https://api.openai.com/v1"
        }
        wenxin {
            api-key = "your-wenxin-api-key"
            secret-key = "your-wenxin-secret-key"
        }
        tongyi {
            api-key = "your-tongyi-api-key"
        }
        default-provider = "openai"
    }
    image {
        openai {
            api-key = "your-openai-api-key"
            base-url = "https://api.openai.com/v1"
        }
        stability {
            api-key = "your-stability-api-key"
            base-url = "https://api.stability.ai"
        }
    }
}
```

### 数据库配置

```hocon
ktor {
    database {
        url = "jdbc:postgresql://localhost:5432/empyrean"
        driver = "org.postgresql.Driver"
        user = "postgres"
        password = "password"
    }
}
```

---

## 📱 功能预览

### 创作流程
1. 选择创作模板 → 输入关键词 → 选择风格 → AI 生成 → 编辑调整 → 发布

### 阅读流程
1. 浏览首页 → 选择短剧 → 阅读场景 → 互动（点赞/评论/收藏）→ 分享

### 个人中心流程
1. 进入"我的" → 查看作品/收藏/历史 → 编辑资料 → 设置偏好

---

## 🌐 API 接口

### 内容模块

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/api/v1/dramas` | 获取短剧列表（分页） |
| GET | `/api/v1/dramas/{id}` | 获取短剧详情 |
| POST | `/api/v1/dramas` | 创建短剧 |
| PUT | `/api/v1/dramas/{id}` | 更新短剧 |
| DELETE | `/api/v1/dramas/{id}` | 删除短剧 |
| GET | `/api/v1/dramas/search` | 搜索短剧 |
| GET | `/api/v1/categories` | 获取分类列表 |
| GET | `/api/v1/tags` | 获取标签列表 |
| GET | `/api/v1/ranking` | 获取排行榜 |

### AI 生成模块

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/v1/ai/generate` | AI 生成短剧 |
| POST | `/api/v1/ai/templates` | 获取创作模板 |

### 用户模块

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/v1/auth/login` | 用户登录 |
| POST | `/api/v1/auth/register` | 用户注册 |
| POST | `/api/v1/auth/anonymous` | 匿名登录 |
| POST | `/api/v1/auth/refresh` | 刷新 Token |
| GET | `/api/v1/users/me` | 获取当前用户 |
| PUT | `/api/v1/users/me` | 更新用户资料 |

### 互动模块

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/v1/dramas/{id}/like` | 点赞 |
| POST | `/api/v1/dramas/{id}/unlike` | 取消点赞 |
| POST | `/api/v1/dramas/{id}/favorite` | 收藏 |
| POST | `/api/v1/dramas/{id}/unfavorite` | 取消收藏 |
| POST | `/api/v1/dramas/{id}/comments` | 发表评论 |
| GET | `/api/v1/dramas/{id}/comments` | 获取评论列表 |
| DELETE | `/api/v1/comments/{id}` | 删除评论 |
| POST | `/api/v1/users/{id}/follow` | 关注用户 |
| POST | `/api/v1/users/{id}/unfollow` | 取消关注 |

### 创作者激励模块

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/api/v1/rewards/amounts` | 获取推荐打赏金额 |
| POST | `/api/v1/rewards` | 创建打赏 |
| GET | `/api/v1/rewards/me` | 获取当前用户打赏记录 |
| GET | `/api/v1/dramas/{id}/rewards` | 获取短剧打赏记录 |
| GET | `/api/v1/dramas/{id}/rewards/stats` | 获取短剧打赏统计 |
| GET | `/api/v1/creator/wallet` | 获取创作者钱包 |
| POST | `/api/v1/creator/withdraw` | 创建提现申请 |
| GET | `/api/v1/creator/stats` | 获取创作者统计数据 |
| GET | `/api/v1/rankings/creators` | 获取创作者排行榜 |
| GET | `/api/v1/rankings/rewards` | 获取打赏排行榜 |
| GET | `/api/v1/rankings/fan-rewards` | 获取粉丝打赏排行榜 |

### 数据统计模块

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/api/v1/statistics/dashboard` | 仪表盘概览 |
| GET | `/api/v1/statistics/metrics` | 核心指标 |
| GET | `/api/v1/statistics/browse` | 浏览行为统计 |
| GET | `/api/v1/statistics/interaction` | 互动行为统计 |
| GET | `/api/v1/statistics/funnel` | 用户行为漏斗分析 |
| GET | `/api/v1/statistics/retention` | 用户留存率统计 |
| GET | `/api/v1/statistics/active-users` | 活跃用户统计 |
| GET | `/api/v1/statistics/ltv` | 用户LTV统计 |
| GET | `/api/v1/statistics/content` | 内容热度统计 |
| GET | `/api/v1/statistics/content/trend` | 内容趋势数据 |
| GET | `/api/v1/statistics/user-growth` | 用户增长数据 |
| GET | `/api/v1/statistics/content-production` | 内容生产分析 |
| GET | `/api/v1/statistics/engagement` | 互动数据统计 |
| GET | `/api/v1/statistics/revenue` | 收益数据统计 |
| GET | `/api/v1/statistics/creator/{authorId}` | 创作者统计数据 |
| GET | `/api/v1/statistics/creator/{authorId}/growth` | 创作者粉丝增长 |
| GET | `/api/v1/statistics/creator/{authorId}/revenue` | 创作者收益数据 |

### 推送通知模块

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/v1/push/devices` | 注册推送设备 |
| DELETE | `/api/v1/push/devices/{deviceId}` | 注销推送设备 |
| PUT | `/api/v1/push/devices/{deviceId}` | 更新设备信息 |
| GET | `/api/v1/push/subscriptions` | 获取订阅配置 |
| PUT | `/api/v1/push/subscriptions` | 更新订阅配置 |
| GET | `/api/v1/push/history` | 获取推送历史 |
| POST | `/api/v1/push/send` | 发送推送 |
| GET | `/api/v1/push/stats` | 获取推送统计 |

### 社交动态模块

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/api/v1/feed` | 获取动态信息流 |
| POST | `/api/v1/subscriptions` | 订阅动态 |
| DELETE | `/api/v1/subscriptions/{authorId}` | 取消订阅 |
| GET | `/api/v1/subscriptions/{authorId}` | 获取订阅状态 |
| PUT | `/api/v1/feed/{feedId}/read` | 标记动态已读 |
| PUT | `/api/v1/feed/{feedId}/hide` | 隐藏动态 |
| DELETE | `/api/v1/feed/history` | 清除动态历史 |

### 智能推荐模块

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/api/v1/recommendations/personalized` | 个性化推荐 |
| GET | `/api/v1/recommendations/for-you` | 猜你喜欢 |
| GET | `/api/v1/recommendations/hot` | 热门推荐 |
| GET | `/api/v1/recommendations/similar/{dramaId}` | 相似内容 |
| GET | `/api/v1/recommendations/mixed` | 混合推荐 |
| GET | `/api/v1/search` | 全文搜索 |
| GET | `/api/v1/search/suggestions` | 搜索建议 |
| GET | `/api/v1/search/hot-keywords` | 热词推荐 |
| POST | `/api/v1/search/history` | 添加搜索历史 |
| DELETE | `/api/v1/search/history` | 删除搜索历史 |
| POST | `/api/v1/feedback` | 推荐反馈 |

### 私信系统模块

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/v1/conversations` | 创建或获取会话 |
| GET | `/api/v1/conversations` | 获取会话列表 |
| GET | `/api/v1/conversations/{id}` | 获取会话详情 |
| DELETE | `/api/v1/conversations/{id}` | 删除会话 |
| POST | `/api/v1/messages` | 发送消息 |
| GET | `/api/v1/messages/conversation/{id}` | 获取指定会话的消息 |
| PUT | `/api/v1/messages/{id}/read` | 标记消息已读 |
| PUT | `/api/v1/messages/conversation/{id}/read-all` | 标记会话所有消息已读 |
| DELETE | `/api/v1/messages/{id}` | 删除消息 |
| GET | `/api/v1/messages/unread-count` | 获取未读消息数 |

### 付费内容和会员模块

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/api/v1/dramas/{id}/price` | 获取短剧价格信息 |
| PUT | `/api/v1/dramas/{id}/price` | 设置短剧价格（创作者） |
| GET | `/api/v1/dramas/{id}/unlock` | 验证内容是否解锁 |
| POST | `/api/v1/payments/create` | 创建支付订单 |
| POST | `/api/v1/payments/{id}/notify` | 支付回调 |
| GET | `/api/v1/payments/{id}` | 获取支付状态 |
| GET | `/api/v1/payments/history` | 获取支付历史 |
| POST | `/api/v1/subscriptions` | 购买会员 |
| GET | `/api/v1/subscriptions/current` | 获取当前订阅状态 |
| PUT | `/api/v1/subscriptions/renew` | 设置自动续费 |
| DELETE | `/api/v1/subscriptions` | 取消订阅 |
| GET | `/api/v1/subscriptions/benefits` | 获取会员权益列表 |

### AI写作助手模块

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/v1/writing/continue` | 续写内容 |
| POST | `/api/v1/writing/rewrite` | 改写内容 |
| POST | `/api/v1/writing/optimize` | 优化内容 |
| POST | `/api/v1/writing/score` | 内容质量评分 |
| GET | `/api/v1/writing/seo-suggestions/{dramaId}` | SEO优化建议 |

### 数据导出模块

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/v1/export/request` | 创建导出任务 |
| GET | `/api/v1/export/tasks` | 获取导出任务列表 |
| GET | `/api/v1/export/tasks/{id}` | 获取单个导出任务 |
| GET | `/api/v1/export/tasks/{id}/download` | 下载导出文件 |
| DELETE | `/api/v1/export/tasks/{id}` | 删除导出任务 |
| POST | `/api/v1/export/contents` | 创建创作内容导出任务 |

### 用户成长体系模块

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/api/v1/growth/stats` | 获取用户成长统计 |
| GET | `/api/v1/growth/points` | 获取积分记录 |
| GET | `/api/v1/growth/level` | 获取用户等级 |
| GET | `/api/v1/growth/badges` | 获取用户徽章 |
| PUT | `/api/v1/growth/badges/{id}/display` | 设置徽章显示 |
| GET | `/api/v1/growth/tasks/daily` | 获取每日任务 |
| POST | `/api/v1/growth/tasks/claim` | 领取任务奖励 |
| POST | `/api/v1/growth/checkin` | 每日签到 |
| GET | `/api/v1/growth/checkin/history` | 获取签到记录 |
| GET | `/api/v1/growth/leaderboard/{type}` | 获取排行榜 |
| GET | `/api/v1/growth/badges/config` | 获取徽章配置 |
| GET | `/api/v1/growth/levels/config` | 获取等级配置 |

### 剧本模板市场模块

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/v1/templates/search` | 搜索模板 |
| GET | `/api/v1/templates/trending` | 获取热门模板 |
| GET | `/api/v1/templates/recommendations` | 获取推荐模板 |
| GET | `/api/v1/templates/categories` | 获取模板分类 |
| GET | `/api/v1/templates/{id}` | 获取模板详情 |
| GET | `/api/v1/templates/{id}/ratings` | 获取模板评价 |
| POST | `/api/v1/templates` | 创建模板 |
| PUT | `/api/v1/templates/{id}` | 更新模板 |
| DELETE | `/api/v1/templates/{id}` | 删除模板 |
| POST | `/api/v1/templates/{id}/favorite` | 收藏/取消收藏模板 |
| GET | `/api/v1/templates/favorites` | 获取收藏的模板 |
| POST | `/api/v1/templates/{id}/rate` | 评价模板 |
| POST | `/api/v1/templates/{id}/use` | 使用模板创建短剧 |
| GET | `/api/v1/templates/usage` | 获取使用记录 |
| GET | `/api/v1/templates/my` | 获取我的模板 |

### 响应格式

```json
{
    "code": 200,
    "message": "success",
    "data": { ... },
    "timestamp": 1704067200000
}
```

---

## ⚠️ 风险与应对

| 风险 | 影响 | 概率 | 应对措施 |
|------|------|------|----------|
| **AI API 费用过高** | 运营成本增加 | 中 | 1. 实现调用限流 2. 缓存热门生成结果 3. 提供用户每日免费额度 |
| **AI 生成内容质量不稳定** | 用户体验下降 | 高 | 1. 优化 Prompt 工程 2. 提供多轮生成选项 3. 支持人工编辑 |
| **违规内容风险** | 法律合规问题 | 中 | 1. 接入内容审核 API 2. 用户举报机制 3. 人工审核抽检 |
| **KMP 平台兼容性问题** | 功能不一致 | 中 | 1. 充分的多平台测试 2. 封装平台差异层 3. 准备降级方案 |
| **用户增长超预期** | 服务性能下降 | 低 | 1. 服务端弹性扩容 2. 数据库读写分离 3. CDN 加速静态资源 |

---

## 📊 性能指标

| 指标 | 目标值 | 说明 |
|------|--------|------|
| AI 剧本生成响应时间 | < 10 秒（95% 请求） | 最长不超过 30 秒 |
| 应用冷启动时间 | < 2 秒 | 热启动 < 500ms |
| 短剧列表页面加载时间 | < 1 秒 | 包含图片和数据 |
| 短剧详情页面加载时间 | < 500ms | 详情数据加载 |
| 接口成功率 | > 99.5% | 核心接口可用性 |
| 支持并发用户 | 10000+ | 系统容量 |
| 帧率 | 50fps+ | 中低端设备 |

---

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

### 贡献步骤

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

### 代码规范

- ✅ 遵循 Kotlin 官方编码规范
- ✅ 使用 KDoc 注释公共 API
- ✅ 保持代码简洁清晰
- ✅ 添加适当的单元测试
- ✅ 遵循 Git Flow 工作流

### 提交规范

```
<type>(<scope>): <description>

<optional body>

<optional footer>
```

**类型**: feat(新功能)、fix(修复)、docs(文档)、style(格式)、refactor(重构)、test(测试)、chore(构建)

---

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

---

## 📞 联系方式

- **项目地址**: [https://gitee.com/zhangkede/empyrean](https://gitee.com/zhangkede/empyrean)
- **作者**: 张科 (Zhang Kede)
- **邮箱**: 834959743@qq.com
- **微信**: 16657156689

---

**Empyrean** - 让创作更简单，让阅读更精彩 🎭

*Built with ❤️ using Kotlin Multiplatform*