# 怎快去水印 - 视频去水印插件

## 项目概述

**怎快去水印** 是一个基于怎快后台管理系统开发的视频去水印解析插件，支持多平台视频、图集一键去水印下载。插件采用接口池架构，支持多API故障轮备，灵活配置解析接口。

## 核心功能

### 1. 视频解析功能

- **多平台支持**：抖音、快手、小红书、微博、西瓜视频等主流短视频平台

- **智能识别**：自动识别视频链接所属平台

- **去水印下载**：解析后提供无水印视频/图集下载

- **接口池管理**：支持配置多个解析API接口

- **故障轮备**：当前接口失败自动切换备用接口

- **字段映射**：自定义接口返回字段映射，适配不同API格式

### 2. 会员系统

- **会员套餐**：支持多种会员套餐配置（月卡、季卡、年卡等）

- **会员权益**：会员用户无解析次数限制

- **支付集成**：支持微信支付、支付宝支付、余额支付

- **会员状态**：实时查询会员到期时间

### 3. 积分系统

- **积分任务**：签到、分享、邀请等任务获取积分

- **积分记录**：完整的积分获取/消耗记录

### 4. 广告系统

- **激励视频广告**：观看广告获得免费下载

- **模板广告**：首页、预览页原生模板广告

- **广告配置**：后台灵活配置广告单元ID

- **广告统计**：广告观看次数统计

## 核心配置

### 基础设置

| 配置项 | 说明 |

|--------|------|

| `app_name` | 应用名称 |

| `app_desc` | 应用描述 |

| `footer_copyright` | 底部版权文字 |

| `enable_ad_reward` | 是否开启广告奖励 |

| `point_cost_download` | 积分抵扣下载次数 |

| `ad_unit_id` | 微信激励视频广告单元ID |

### 模板广告设置

| 配置项 | 说明 |

|--------|------|

| `enable_template_ad` | 是否开启模板广告 |

| `index_ad_unit_id` | 首页模板广告单元ID |

| `preview_ad_unit_id` | 预览页模板广告单元ID |

| `ad_theme_type` | 广告主题样式（white/black） |

### 接口设置

| 配置项 | 说明 |

|--------|------|

| `api_switch_mode` | 接口切换模式（single/failover） |

| `request_timeout` | 请求超时时间（秒） |

| `retry_count` | 失败重试次数 |

### 会员设置

| 配置项 | 说明 |

|--------|------|

| `enable_vip` | 是否开启会员功能 |

| `vip_no_limit` | 会员无解析限制 |

## 解析流程

```

用户输入链接

   ↓

识别平台类型

   ↓

获取启用的接口列表

   ↓

调用解析接口

   ↓

字段映射解析

   ↓

返回解析结果

   ↓

记录解析日志

```

### 解析结果格式

```json

{

 "status": 1,

 "data": {

   "url": "视频地址",

   "type": "video",

   "cover": "封面图片",

   "text": "视频标题",

   "music_url": "音乐地址",

   "author": {

     "name": "作者名称",

     "avatar": "作者头像"

   },

   "images": []

 }

}

```

## 支付流程

### 创建订单

```php

$payData = [

   'uid' => $uid,

   'text' => '会员充值-月卡',

   'money' => intval($price * 100),  // 转为分

   'order_id' => $packageId,

   'types' => 'zkqushuiyin_vip',

];

$common = new Common();

$payOrder = $common->pay_order($payData);

```

### 支付回调

支付成功后，在 `Common::pay_completed()` 中处理：

```php

if ($order_find['types'] == 'zkqushuiyin_vip') {

   // 处理会员开通逻辑

}

```

## 广告集成

### 激励视频广告

```vue

<ad-reward-video

   v-if="showAd"

   :ad-unit-id="adUnitId"

   @close="onAdClose"

   @success="onAdSuccess">

</ad-reward-video>

```

### 模板广告

```vue

<ad

   unit-id="adunit-xxx"

   ad-type="template"

   ad-theme-type="black">

</ad>

```

## API 接口列表

### 用户端接口

| 接口 | 方法 | 说明 |

|------|------|------|

| `/plugin.php/zkqushuiyin/api/Parse/index` | POST | 视频解析 |

| `/plugin.php/zkqushuiyin/api/Vip/get_packages` | GET | 获取会员套餐 |

| `/plugin.php/zkqushuiyin/api/Vip/open` | POST | 开通会员 |

| `/plugin.php/zkqushuiyin/api/Ad/watch` | POST | 记录广告观看 |

| `/plugin.php/zkqushuiyin/api/point/Point/sign` | POST | 积分签到 |

| `/plugin.php/zkqushuiyin/api/point/PointTask/list` | GET | 积分任务列表 |

### 后台管理接口

| 接口 | 方法 | 说明 |

|------|------|------|

| `/plugin.php/zkqushuiyin/admin/ApiConfig/lists` | GET | 接口列表 |

| `/plugin.php/zkqushuiyin/admin/ApiConfig/add` | POST | 添加接口 |

| `/plugin.php/zkqushuiyin/admin/Statistics/getStats` | GET | 获取统计数据 |

| `/plugin.php/zkqushuiyin/admin/VipPackage/lists` | GET | 会员套餐列表 |

## 版本信息

- **插件名称**：怎快去水印-视频去水印

- **版本号**：1.0.0

- **支持设备**：H5、微信小程序

- **开发框架**：ThinkPHP 8 + uni-app

## 技术支持

- 项目基于怎快后台管理系统开发

- 遵循怎快插件开发规范

- 支持微信小程序