更新记录

1.0.0（2026-07-23）

【首发】UniRisk 分销防作弊插件 V1.0

• 新增 checkDistributeInvite 接口，校验邀请关系，拦截本机自邀
• 新增 checkDistributeOrder 接口，订单佣金风控检测
• 新增 reportDistributeEvent 接口，分销行为事件上报
• 支持 App 端原生设备指纹，小程序辅助特征采集
• 后端规则引擎：自推自买拦截、同设备多账号阈值、订单团伙检测
• 后台管理面板：规则配置、风险设备/账号、日志查询导出、白名单
• 集成离线重试队列，网络异常自动缓存重试

平台兼容性

uni-app(3.8.0)

🛡️ UniRisk 分销防作弊插件

UniRisk 主 SDK 的商城场景付费扩展模块

解决多级分销商城「小号自推自买、多账号薅佣金、虚假上下级刷单」

功能简介

基于 UTS 原生设备指纹技术，精准识别同一台手机切换多个马甲账号的行为，在 3 个关键节点拦截作弊：

核心优势：

• 🚀 UTS 原生设备指纹，识别一台手机多个马甲账号
• 🎯 精准拦截【小号自推自买薅分销佣金】
• 🔌 不用大规模改造商城，3 处接口快速接入
• ⚙️ 后台可视化配置风控策略，支持仅记录/预警/强制拦截
• 📋 配套风险日志，追溯作弊账号

接入流程

1. 初始化插件

在 App.vue 或首页 onLaunch 中调用：

import { initDistribute } from '@/uni_modules/unirisk-distribute'

export default {
  onLaunch() {
    initDistribute({
      apiBaseUrl: 'https://your-domain.com',  // 后端API地址
      apiKey: 'your-api-key',                  // 与后端 config.php 一致
      cacheDeviceId: true,
      enableRetryQueue: true
    })
  }
}

2. 场景一：绑定上下级前校验

import { checkDistributeInvite } from '@/uni_modules/unirisk-distribute'

async function onBindInvite(inviterUid: number, inviteeUid: number) {
  const result = await checkDistributeInvite(inviterUid, inviteeUid)

  if (!result.pass) {
    uni.showModal({
      title: '不允许绑定',
      content: result.reason || '系统检测到异常邀请行为',
      showCancel: false
    })
    return false
  }

  // 校验通过，执行绑定逻辑
  await api.bindInviter(inviterUid, inviteeUid)
  return true
}

3. 场景二：提交订单时校验

import { checkDistributeOrder } from '@/uni_modules/unirisk-distribute'

async function onSubmitOrder(orderInfo: any) {
  const result = await checkDistributeOrder({
    orderId: orderInfo.orderId,
    uid: orderInfo.uid,
    amount: orderInfo.totalAmount,
    inviterUid: orderInfo.inviterUid || 0
  })

  if (!result.pass) {
    // 方案B（推荐）：允许下单，标记为风险订单，延迟结算
    orderInfo.riskTag = result.riskTag
  }

  await api.submitOrder(orderInfo)
}

4. 场景三：上报分销行为（非阻塞）

import { reportDistributeEvent } from '@/uni_modules/unirisk-distribute'

// 注册成功
reportDistributeEvent('register', { uid: 1001 })
// 点击邀请链接
reportDistributeEvent('click_invite', { uid: 1001, inviterUid: 500 })
// 领取推广奖励
reportDistributeEvent('claim_reward', { uid: 1001, rewardAmount: 10.00 })

API 文档

initDistribute(config: DistConfig)

初始化插件。

checkDistributeInvite(inviterUid, inviteeUid): Promise<RiskResult>

校验邀请关系，绑定上下级前调用。

返回值：

{
  pass: boolean,      // true=通过 false=拦截
  code: string,       // 错误码
  reason: string,     // 原因描述
  riskTag: 'self_invite' | 'multi_account' | 'normal'
}

checkDistributeOrder(orderInfo): Promise<RiskResult>

订单佣金风控校验。

reportDistributeEvent(eventType, data): void

分销行为日志上报，非阻塞，自动离线缓存重试。

后端部署要求

部署步骤详见插件包内的 DEPLOY.md。

⚠️ 平台能力限制

重要：小程序端特征采集有限，仅作为辅助风控，不能单独依靠小程序端校验。 最终风控判断在后端执行，前端仅负责采集与上报。

免责声明

• 本模块主要防御普通羊毛党同一设备多账号作弊
• 更换真机、硬改设备特征的专业黑产无法 100% 拦截
• 建议结合佣金冻结周期（如 7 天冻结期）等业务规则多重防护

更新日志

V1.0（2026-07-23）

• 新增 checkDistributeInvite 接口，校验邀请关系，拦截本机自邀
• 新增 checkDistributeOrder 接口，订单佣金风控检测
• 新增 reportDistributeEvent 接口，分销行为事件上报
• 支持 App 端原生设备指纹，小程序辅助特征采集
• 后端规则引擎：自推自买拦截、同设备多账号阈值、订单团伙检测
• 后台管理面板：规则配置、风险设备/账号、日志查询导出、白名单
• 集成离线重试队列，网络异常自动缓存重试