# 都客AI直播系统

**Repository Path**: mou18/dkailive

## Basic Information

- **Project Name**: 都客AI直播系统
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-11
- **Last Updated**: 2026-10-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DKAliveSys · AI 直播工作台系统

一套面向「抖音 / 快手手游录屏直播」的 AI 店播解决方案，覆盖 **桌面控制中心、手机画面机、局域网远程伴侣、商家后台** 四个部分，实现：本地台词配音 + AI 实时互动口播 + 多直播间监控 + 商家佣金管理。

> 命名：DK = 多快（品牌），Alive = 直播（Alive / 生动）。

---

## 仓库结构（Monorepo）

| 目录 | 定位 | 技术栈 |
| --- | --- | --- |
| [`ailive/`](./ailive) | 桌面端 AI 直播控制中心（WebRTC 互动口播推流 + HLS 语音解说） | Tauri 2 + Vue 3 + Rust + Tailwind CSS |
| [`ailiveapp/`](./ailiveapp) | 手机端「画面机」：本地台词配音包 + 浮动素材叠加 + 互动口播自动插入 | Android 原生 Kotlin + WebRTC + Media3 ExoPlayer |
| [`aliveapp2/`](./aliveapp2) | 副 App「AI 直播伴侣」：局域网远程控制器，一键推送图片层 / 配音包并热切换 | Android 原生 Kotlin + OkHttp WebSocket |
| [`mysite/`](./mysite) | 商家后台单站点：会员佣金 / 直播管理 | .NET Framework 4.8 Web Site（SQL Server）+ Vue 3 + Vite 前端 |
| [`tools/`](./tools) | 开发工具链（Perl、CMake 等，不随源码提交） | - |

四个子项目可独立构建，运行时通过 **局域网 / 公网信令** 协同：

```
┌─────────────┐   WebRTC 口播 / 信令   ┌─────────────┐
│   ailive    │ ──────────────────────▶ │ ailiveapp   │  （主 App 直播画面机）
│ 桌面控制端    │ ◀────────────────────── │             │
└─────────────┘                          └──────┬──────┘
                                                │ 局域网 WS (端口 18932)
                                                ▼
                                          ┌─────────────┐
                                          │  aliveapp2  │  （副 App 远程伴侣）
                                          └─────────────┘

        CosyVoice2 TTS 服务  ◀──── 台词 / 欢迎语合成（HTTP /synthesize）
        mysite 商家后台        ◀──── 会员佣金 / 直播统计（SQL Server）
```

---

## 核心端口

| 端口 | 服务 | 说明 |
| --- | --- | --- |
| `18930` | HLS 本地 HTTP（`ailive`） | 语音解说：文字 → Edge TTS → ffmpeg 转 HLS，手机扫码收听 |
| `18931` | WebRTC 信令（`ailive`） | 桌面端 offerer，手机 answerer；房间号机制 |
| `18932` | 远程控制（`ailiveapp`） | 副 App `aliveapp2` 局域网连接主 App，配对码默认 `dl8888` |

---

## 各子项目快速上手

### 1. 桌面端 `ailive/`

```bash
cd ailive
npm install              # 安装前端依赖
npm run tauri dev        # 启动（需 Rust 工具链 + CMake）
# 或仅前端（无 Tauri 时自动降级为模拟数据）：
npm run dev              # http://127.0.0.1:5173
```

详见 [`ailive/README.md`](./ailive/README.md)。

> Windows 编译 Rust 依赖（webrtc/openssl）需 Perl 与 CMake，路径见 `tools/`，并设置 `CMAKE_POLICY_VERSION_MINIMUM=3.5`。

### 2. 手机画面机 `ailiveapp/`

用 Android Studio 打开 `ailiveapp/`，Gradle Sync 后 `Build → Build APK(s)`，产物在 `app/build/outputs/apk/debug/`。详见 [`ailiveapp/README.md`](./ailiveapp/README.md)。

### 3. 远程伴侣 `aliveapp2/`

副 App，配套 `ailiveapp` 使用。详见 [`aliveapp2/README.md`](./aliveapp2/README.md)。

### 4. 商家后台 `mysite/`

后端为 .NET 4.8 Web Site（`api.ashx` / `admin.ashx`），数据库脚本 `db.sql`（SQL Server，需 `-f 65001` 导入）；前端在 `web/`（Vue 3 + Vite），`npm run build` 直接输出到 `dist/`。

---

## 协议约定（易错点）

- **CosyVoice2 TTS**：`POST /synthesize` 入参 `{text, speaker_id, speed, mode}`；`POST /synthesize/raw` 直接返回 WAV 二进制（优先，省 base64）；`GET /health` 返回 `available_speakers`。
- **互动口播信令**：桌面端在注入音频前后经 WebSocket 广播 `interaction_start` / `interaction_end`，手机端据此在「一句话结束后」让出并插入互动口播。
- **远程控制**：回执 / 状态帧字段为 `message`（非 `msg`），状态帧 `{type:remote_state, data:{...}}` 须读嵌套 `data`；`file_id` 两端统一安全字符规则。

---

## 通用约定

- 界面严格 **Windows 11 Fluent Design**（桌面端）/ Material 3（移动端）。
- 命名规范：Rust `snake_case` / `PascalCase`；前端 `camelCase` / `kebab-case`；详见各子项目。
- 配置仅内存使用，退出时统一写入 `my.json`，启动自动恢复（不落实时文件）。
- 所有参数提供合理默认值，功能闭环：输入 → 处理 → 输出 + 状态提示 + 异常处理。

---

## 免责声明

本项目为个人 / 内部用途的 AI 店播工具集合，涉及第三方平台（抖音、快手）采集与推流，请遵守相关平台服务条款与法律法规。