更新记录
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 分级。

收藏人数:
下载插件并导入HBuilderX
下载插件ZIP
赞赏(0)
下载 3
赞赏 0
下载 12746309
赞赏 1959
赞赏
京公网安备:11010802035340号