更新记录

1.1.0（2026-08-26）

新增独立示例项目：随插件附带完整 uni-app x 演示工程（release/ls-cps-demo），页面填写 apikey/sid 即可一键发起「活动列表」「转链」「订单查询」请求并查看原始返回，帮助快速接入与联调。 平台兼容性校准：按 uni-app x 实际支持能力调整兼容声明 支持：App-Android、App-iOS、Web（H5）、微信小程序 暂不支持：支付宝小程序（需 uni-app x 5.25+）、百度/抖音/快手小程序（uni-app x 不支持） App-HarmonyOS：代码兼容，待鸿蒙环境实测通过后另行发布支持 版本要求 uni-app 最低兼容版本：4.11（仅 App 端可用） uni-app x 最低兼容版本：4.41 API 无变更，1.0.0 用户可直接升级，无破坏性改动。

1.0.0（2026-08-26）

首次发布：

• 提供本地生活 CPS 聚合能力，内置聚推客（jutuihe）平台适配
• 统一 API：getHotList / getCategoryTree / createLink / getOrderList 等
• 统一数据模型与 CpsResult 返回协议，适配器架构支持扩展其他 CPS 平台
• 支持 uni-app x 全端编译（App / H5 / 小程序） 默认：聚推客开放平台接口 http://api.jutuike.com
• /union/act_list：活动列表
• /union/act：活动转链
• /union/orders：订单查询 若开发者在 LocalLife.init 中配置了 baseUrl，则请求发往开发者指定的中转网关地址。

平台兼容性

uni-app(4.11)

uni-app x(4.41)

ls-cps 本地生活 CPS 聚合插件（UTS）

适用于 uni-app x 的本地生活 CPS（按成交付费）导购聚合插件。开发者只需填入所选 CPS 平台的 apiKey / sid，即可快速构建自己的本地生活返利/推广类应用，覆盖外卖、到店团购、酒店、电影、打车等全类目。

特性

• 纯 API 封装层，不绑定 UI，可与任意应用结构集成
• 平台抽象架构：当前内置 聚推客（jutuihe） 适配，预留适配器接口，可扩展市面其他同类 CPS 平台（高佣联盟、好省、美团联盟等）
• 统一数据模型（活动/商品 / 推广链接 / 订单 / 类目 / 分页）
• 统一返回结构 CpsResult<T>，业务层只认一套协议
• 接口地址、请求方式、字段映射全部配置化，平台调整字段无需改代码
• 一套 UTS 代码，编译到 App（Android/iOS）+ 小程序 + H5 全端
• 已通过 HBuilderX Android 编译与聚推客真实接口联调验证

支持的 uni-app 版本与前端平台兼容性

uni-app 版本要求

前端平台兼容性

兼容性注意事项

• 插件只依赖 uni.request 与标准全局对象（Date/Map/Promise/encodeURIComponent），不依赖任何平台私有 API，无需额外安装依赖
• 聚推客官方接口为 http://api.jutuike.com（明文 http）：
  • App-Android：Android 7.0（API 24）起系统默认限制明文 http（Network Security Configuration），若请求失败请确认明文流量配置
  • 小程序端：必须在平台后台将接口域名加入 request 合法域名白名单，微信/支付宝普遍要求 https
  • H5 端：存在跨域（CORS）问题
  • 推荐方案：生产环境将请求转发到自己的服务端（同时解决密钥不落地），插件内 baseUrl 指向中转网关

安装

1. 将 uni_modules/ls-cps 目录复制到你的 uni-app x 项目的 uni_modules 目录下
2. 在页面中 import 使用即可

插件按 uni-app x UTS 插件标准目录结构组织，源码入口为 utssdk/（uni-app x 编译时识别 UTS 插件的约定目录），页面中请通过 @/uni_modules/ls-cps 导入，勿直接引用 utssdk 内部文件：

uni_modules/ls-cps/
├── package.json        # 插件描述与依赖
├── readme.md
└── utssdk/             # UTS 插件源码（入口）
    ├── index.uts       # 对外入口：LocalLife 类
    ├── common/         # http 封装、JSON 工具、签名工具
    ├── models/         # 统一数据模型
    └── providers/      # 各 CPS 平台适配器（ICpsProvider + 具体实现）

快速接入（聚推客示例）

import { LocalLife } from '@/uni_modules/ls-cps'

// 1. 初始化：填入你的聚推客开放平台 Key
LocalLife.init({
  platform: 'jutuihe',
  apiKey: '你的聚推客apikey', // 单密钥鉴权
  sid: '你的跟单标识',        // 生成推广链接时必传的自定义跟单参数
  baseUrl: ''                // 留空使用插件内置默认地址
})

// 2. 获取类目（外卖 / 团购 / 打车 / 酒店 / 电影 ...）
const cats = await LocalLife.getCategoryTree()

// 3. 拉取活动列表（categoryId 传分类名，如 "美团"；空串为全部）
const hot = await LocalLife.getHotList('', 1, 20)

// 4. 生成推广链接（productId 传活动 act_id；返回 H5 短链/长链、小程序路径/小程序码）
const link = await LocalLife.createLink(hot.data.list[0].id, 'h5')

// 5. 查询订单与佣金（插件自动按平台规则补全时间窗口）
const orders = await LocalLife.getOrderList('', 1, 20)

所有方法均返回 Promise<CpsResult<T>>，调用时请使用 try/catch 或 await 处理网络异常。 search / getBalance 为通用接口预留，聚推客联盟活动模式不提供，调用会抛出明确业务提示。

数据模型

CpsResult\<T>（统一返回）

CpsProduct（活动/商品）

CpsPageResult\<T>（分页）

list / page / pageSize / total / hasMore

CpsLink（推广链接）

url / shortUrl / posterImage / expireTime / extra（含小程序 app_id、page_path、miniCode）

CpsOrder（订单）

orderId / productId / productTitle / status / statusText / commission / estimatedTime / settleTime / extra（含 sid、act_id、brand_id、pub_id、下单/付款时间等）

安全提醒

• apiKey / appSecret 属于敏感凭据，切勿硬编码进前端代码或提交到仓库
• H5 / 小程序端无法隐藏密钥，建议生产环境将请求转发到自己的服务端，由服务端保管密钥并签名，插件内改为调用服务端中转接口

扩展其他 CPS 平台

1. 新建目录 providers/<platform>/
2. 实现 ICpsProvider 接口（实现 providers/ICpsProvider.uts 中的全部方法）
3. 在 LocalLife.init() 中通过 ProviderFactory.register('平台名', () => new XxxProvider()) 注册
4. 在 LocalLifeConfig.platform 传入对应平台名即可切换

API 一览

注意

• 插件内置的聚推客接口地址与字段映射位于 providers/jutuihe/jutuihe.config.uts，请以聚推客官方开放平台最新文档为准，必要时在 LocalLife.init 的 baseUrl 中传入官方域名
• 不同 CPS 平台的接口路径、鉴权方式、字段名可能不同，切换平台时请核对对应平台的 config 与 Provider 实现
• 聚推客订单接口要求开始/结束时间间隔不超过 1 小时，插件默认自动补最近 1 小时窗口

系统权限申请

本插件不申请任何系统权限。无需相机、定位、相册、麦克风、通讯录、存储等权限。插件仅通过 uni.request 发起网络请求，网络访问能力由应用基础框架默认提供，插件不额外申请、不修改任何权限配置。

数据采集与服务器地址说明

本插件为纯 API 封装层，不采集任何个人隐私信息（设备信息、位置、相册、通讯录、账号、行为数据等均不采集）。

插件处理的数据仅为开发者主动配置与业务请求所需的参数：

发送的服务器地址：

• 默认：聚推客开放平台接口 http://api.jutuike.com（/union/act_list 活动列表、/union/act 活动转链、/union/orders 订单）
• 若开发者在 LocalLife.init 中配置了 baseUrl，则请求发往开发者指定的中转网关地址

数据用途：仅在开发者应用内完成 CPS 推广能力（展示活动、生成推广链接、查询订单与佣金），不做任何其他用途，不向第三方共享或出售。

广告声明

本插件不包含任何广告：不含广告 SDK、无广告组件、无广告展示、无广告频率设置。插件提供的活动/推广链接属于 CPS 导购内容，是否在应用内展示由开发者自行决定，与广告无关。

更新日志

1.1.0

• 新增独立示例项目（uni-app x 完整工程）：下载插件后可一键导入并体验 getHotList / getCategoryTree / createLink / getOrderList 全流程，页面上输入 apikey 与 sid 即可运行测试

1.0.0（首发）

• 提供本地生活 CPS 聚合能力，内置聚推客（jutuihe）平台适配：活动列表、活动转链、订单/佣金查询
• 统一 API：getHotList / getCategoryTree / createLink / getOrderList / search / getBalance
• 统一数据模型与 CpsResult<T> 返回协议，一次接入多端复用
• 适配器架构（ICpsProvider + ProviderFactory），支持扩展其他 CPS 平台
• 支持 uni-app x 全端编译：App（Android/iOS）、H5、小程序（微信/支付宝/百度/头条）
• 纯 API 封装、零权限、不含广告，密钥与接口地址均可配置