VIP会员运维管控

一、插件简介

独立 VIP 会员：后台配置多档时长与价格（积分 / 金币 / 现金）。有效期内可按套餐跳过指定发布者用户组、指定板块的付费阅读、附件、隐藏内容、网盘门槛，次数按全局权限周期统计。积分/金币名称读取支付中心，未填写时默认「积分」「金币」。

二、核心能力

三、依赖与安装

1. 将插件目录置于 plugins/vip/。
2. 在应用中心安装「VIP会员」。
3. 安装时创建 vip_member、vip_order、vip_bypass_log 表，注册后台「VIP会员」菜单。
4. 硬依赖：社区插件（会员中心、用户组、板块、资产账户）。
5. 软依赖：支付中心（现金购买、汇率、积分/金币名称、沙箱）；付费阅读 / 附件 / 隐藏 / 网盘等插件（有对应插件时 VIP 才跳过该门槛）。

四、应用中心基础配置

在应用中心 → VIP会员 → 配置，字段来自 configSchema：

套餐档位、价格、权益次数、发布者用户组、板块均在后台「VIP会员 → 套餐配置」中编辑，不在应用中心弹窗。

五、后台重点配置

套餐配置

/admin/vip_settings/plans：多档可增删。

• 名称、天数、价格、币种（积分 / 金币 / 现金；现金按元填写，库内以分存储）
• 高亮色、图标（Remix 类名或图片 URL）
• 发布者用户组：内容作者属于勾选组时才可跳过；不选则该套餐无法跳过任何门槛
• 生效板块：不选=全站；勾选后仅这些板块
• 四项内置权益：开关、次数（-1 不限）、前台文案（可用 {N}）
• 自定义展示项：仅卡片文案

默认示例：月卡 30 天 100 积分、季卡 90 天 250 积分（安装后请按站点改价并勾选用户组）。

会员列表

/admin/vip_member：按用户 ID / 昵称查询。可增加天数，或指定到期时间。

购买记录

/admin/vip_order：积分 / 金币 / 现金订单与支付状态。

六、前台用户流程

1. 登录后进入 /vip，查看当前到期时间、本周期剩余次数与套餐卡片。
2. 选择档位与支付方式：余额支付即时开通/续期；现金创建支付中心订单，回调后到账；沙箱可走测试通道。
3. 有效期内阅读命中范围的付费/隐藏/附件/网盘内容时自动跳过并计入周期次数（同一内容不重复扣次）。
4. 次数用尽或作者用户组/板块不在范围内，仍走原插件付费或权限逻辑。
5. /vip/orders 查看已支付记录。

七、后台审核与运维

前台路由

八、特殊说明

• 跳过判定：须同时满足 VIP 未过期、作者用户组在套餐名单内、板块在范围内（空=全站）、该权益次数未用尽。
• 次数：按权限周期统计 vip_bypass_log；同一用户 + 功能 + 内容唯一，重复打开不扣第二次。
• 自定义展示项：营销文案，不会真正发红包或改权限。
• 现金价格：后台填元；不足 1 元的历史整数可能被按「元→分」兼容放大，改价后请核对前台显示。
• 汇率：积分/金币套餐改用扫码时，按支付中心「1 元 = N 金币」换算。
• 名称约定：套餐币种与余额文案随支付中心积分/金币名称变化。
• 菜单：会员列表、购买记录从套餐页按钮进入，不再单独占一级菜单。

九、推荐上线清单

• 开启「启用 VIP 会员」，选定权限周期与默认支付方式
• 至少一档上架套餐：天数、价格、币种正确
• 务必勾选发布者用户组，否则前台买了也无法跳过门槛
• 按运营勾选板块与四项次数（含 -1 不限的测试档）
• 抽检积分/金币扣款、现金回调到账、续费延期
• 用 VIP 账号打开命中范围的付费帖/附件/隐藏/网盘，再换非范围内作者帖对照
• 次数用尽后应恢复原插件付费墙
• 到支付中心确认币种名称与现金通道

十、常见问题

Q：买了 VIP 仍要付费？ 最常见是套餐未勾选「发布者用户组」。其次检查是否过期、板块是否命中、该项次数是否为 0 或已用尽，以及对应内容插件是否已安装。

Q：前台没有 VIP 入口？ 应用中心总开关须开启，并登录后访问 /vip。

Q：只有积分价没有现金？ 现金档须把套餐币种设为现金并填写价格；在线支付还需支付中心就绪。积分/金币档改扫码依赖汇率与已启用通道。

Q：次数什么时候重置？ 按应用中心「权限周期」（每日/每周/每月）重新计算，不是按开通日单独滚动（同一内容周期内只记一次）。

Q：-1 和 0 有什么区别？ 0 或不勾选该权益=不跳过；-1=周期内不限次数；正数=该周期最多跳过 N 次。

Q：自定义权益不生效？ 自定义项只展示在卡片上，不改变跳过逻辑。

Q：价格单位名称不对？ 到支付中心修改积分名称、金币名称后刷新。

Q：关掉总开关后会员数据还在吗？ 在。仅前台入口与权益暂停，后台仍可改套餐与开通记录。