# 1. 插件定位

插件名称：下载增强

应用目录：paymentplus

当前版本：1.0

适配 CMS：4.7.1

类型：下载计费与下载配额增强插件

# 2. 核心功能

- 多下载字段计费：支持为模块内多个下载字段独立定价。

- 字段级价格体系：支持全局价、用户组价、内容发布时覆盖价三层定价。

- 组合下载：支持 combo__ 组合项，一次购买可打包下载多个字段资源。

- 自动压缩包分发：组合下载时自动创建 zip，并生成临时授权下载链接。

- 已购判定增强：支持字段级已购、组合反向解锁、零价自动视作已购。

- 下载次数限制：按周期（天/周/月/年）限制下载次数，支持游客与会员策略。

- 游客免费下载：基于“游客配额”自动覆盖价格为 0，超额后恢复原价。

- 支付回调与分账：接入支付中心回调，成功后为作者记账并记录支付日志。

# 3. 后台能力

- 模块级配置：选择启用字段、定价模式、下载限制、游客策略。

- 记录中心：提供支付记录、下载记录、会员端购买/收入/下载记录页。

- 字段兼容升级：自动将旧字段升级到 Paymentplus::Fieldprices。

- 运维工具：支持按 UID 批量清除购买记录、清除当前周期下载统计。

# 4. 前台能力

- 下载页展示可下载项与价格（字段/组合）。

- 购买后自动解锁下载，未购时提示支付。

- 下载链接文件名规范化，减少非法字符导致的下载问题。

- 外链与附件下载两种资源类型均可处理。

# 5. 安装与启用

1) 部署插件文件到应用与模板目录。

2) 后台安装并启用 paymentplus。

3) 在模块中创建或升级“付费下载”字段（Paymentplus::Fieldprices）。

4) 在“下载增强 -> 模块配置”中选择下载字段与计费策略。

5) 配置支付中心方式后进行前台购买/下载联调。

# 6. 注意事项

- 插件依赖支付中心，需确保支付方式已在系统内可用。

- 组合下载会在服务器临时目录生成 zip，请确保写权限与磁盘空间。

- 配置下载次数限制后，请注意游客与会员口径差异（全站周期统计）。

- 若模板是自定义主题，需要同步对应主题的 paymentplus 前台/会员模板。