更新记录

1.0.0(2026-11-05) 下载此版本

1.0.0

  • 首个版本:崩溃/错误/指标/用户反馈统一对接中台
  • 内置反馈通道:异常自动上报自有中台,按指纹聚类,不丢现场

平台兼容性

pk-feedback · 反馈套件

把崩溃 / 错误 / 性能指标 / 用户反馈统一采集,按指纹聚类成 issue;上报功能默认关闭,接入方显式开启。

安装

复制 uni_modules/pk-feedback 到项目 uni_modules/ 下即可。

快速开始

import pkFb from '@/uni_modules/pk-feedback/js_sdk/index.js';

pkFb.init({ appKey: 'app_xxxxxxxx' });
pkFb.installGlobalHandler();          // App 端全局捕获(onError/ 由宿主转发)
pkFb.breadcrumb('进入订单页');         // 面包屑,崩溃时自动附带
pkFb.reportError('E-ORDER-01', '下单失败');
await pkFb.reportFeedback('希望支持导出 Excel', { contact: 'wx:abc' });

方法一览(全部暴露方法)

方法 签名 说明
init init(opts) 配置 appKey / 采样率 / 自动 flush 间隔
breadcrumb breadcrumb(text) 记录面包屑(环形缓冲 50 条,上报自动附带)
reportEvent async reportEvent(type, code, message, extra?) 通用事件上报(type 白名单:crash/error/feedback/perf/permission_denied)
reportError reportError(code, message, extra?) 错误上报快捷方式
reportCrash reportCrash(err, extra?) 崩溃上报:自动取首行 + 面包屑
reportMetric async reportMetric(name, valueMs, extra?) 性能指标(负数/NaN 直接拒绝)
reportFeedback reportFeedback(note, opts?) 用户反馈表单(contact 随报文提交,服务端脱敏入库)
installGlobalHandler installGlobalHandler() → {ok,already?} 注册全局捕获,幂等
startAutoFlush startAutoFlush(intervalMs?) 队列聚合定时上报(默认 30s,≥5s)
flush async flush() → {ok,sent} 立即清空队列上报;失败自动回灌
getNotice async getNotice(appKey?) → {items:[{level,title,body}]} 拉取服务端公告(维护/升级提示)
selfcheck async selfcheck() → {ok,appKey,endpoint,queue,...} 自检配置与端点连通性
EVENT_TYPES string[] 事件类型白名单
PLUGIN_VERSION string 插件版本号

采样与队列

  • init({ sampleRate: 0.1 }) — perf 类高频事件可采样,错误/崩溃类建议保持 1。
  • 队列容量 50(先进先出淘汰);网络失败自动回灌,下次 flush() 重试。

服务端

  • 端点:POST https://plugins.cnajiu.cn/v1/events(X-App: <app_key>)
  • 管理后台:https://plugins.cnajiu.cn/admin(登录后可改密码 / 重启服务)
  • 服务端自动按 (type, code, 栈顶3帧) 聚类,问题池按 P0–P2 分级。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT协议

暂无用户评论。