更新记录

1.0.0（2026-11-15）

• 新增双宿主四 tabs 示例，覆盖评分核验、能力检测、诊断日志和报告复制四类测试入口。
• 新增 uni-app、uni-app x、Android、iOS、Harmony、Web 和微信小程序的平台兼容性说明。
• 新增服务端驱动的芝麻信用评分阈值查询合同。
• 新增响应状态校验、超时处理、脱敏诊断和完整报告示例。
• 新增完整报告固定快照、分段复制和复制失败手动回退入口。
• 优化运行时输入校验、网络同步异常和失败诊断，超时后主动中断请求并限制响应正文大小。
• 优化 iOS 诊断和报告时间戳兼容性，补充业务会话、请求编号和服务端请求编号的脱敏。
• 优化并行查询的活动请求诊断，避免先结束的请求清空仍在执行的请求状态，并补充脱敏网络失败摘要。

平台兼容性

uni-app(5.34)

uni-app x(5.34)

其他

芝麻信用评分服务端核验 UTS 插件

介绍

lizhao-zhima-score 为 uni-app 与 uni-app x 提供按目标分值查询芝麻信用评分的客户端合同。芝麻接口签名、用户授权和最终结果核验由接入方服务端完成。

功能特色

适合哪些场景

下载与导入

从基础到进阶：按业务模块使用

基础功能配置示例

先在业务服务端完成芝麻信用产品签约、RSA 密钥配置、用户授权和业务会话绑定，再向客户端提供 HTTPS 接口。示例页默认打开“评分核验” tab，支持填写服务端地址、业务会话标识、目标分值、可选 sessionToken 和 timeoutMs，点击“查询芝麻信用评分”即可触发真实 queryZhimaCreditScore。

uni-app 页面路径为 uni_modules/lizhao-zhima-score/example/uniapp/index.vue，uni-app x 页面路径为 uni_modules/lizhao-zhima-score/example/uniappx/index.uvue。两端示例都按以下四个 tabs 分类：

最小调用仍可直接从根入口导入：

import { queryZhimaCreditScore } from '@/uni_modules/lizhao-zhima-score'

queryZhimaCreditScore({
  endpoint: 'https://api.example.com/zhima/score',
  businessSessionId: '由业务服务端创建的会话标识',
  targetScore: 650,
  timeoutMs: 15000,
  success(result) {
    console.log(result.status, result.passed, result.requestId)
  },
  fail(error) {
    console.error(error.errSubject, error.errCode, error.errMsg, error.outcomeUnknown)
  },
  complete(outcome) {
    console.log(outcome.requestId, outcome.succeeded, outcome.outcomeUnknown)
  }
})

高级示例

如服务端要求会话令牌，在“评分核验” tab 填写 sessionToken；插件只把它作为 Bearer 头发送到客户服务端，不在诊断日志中保留令牌。可用的服务端响应必须包含 status 和 passed，两者语义必须一致：

{
  "status": "verified",
  "passed": true,
  "score": 720,
  "targetScore": 650,
  "serverRequestId": "srv-20261114-001",
  "message": "已完成服务端核验"
}

切换到“能力检测” tab 可单独确认宿主网络入口；切换到“诊断日志” tab 可查看快照并清理插件诊断缓存。页面状态区会显示请求编号、回调阶段、status、passed 和 outcomeUnknown，不会把客户端展示结果当作服务端身份认证。

完整示例

“报告复制” tab 和页面底部的“日志快捷操作”都会生成固定报告快照。报告内容包括环境信息、插件诊断快照和本次会话操作日志；只有剪贴板 success 回调触发后才推进分段序号，复制失败会保留相同快照供长按手动复制。

import {
  getZhimaCreditScoreDiagnosticsSync,
  clearZhimaCreditScoreDiagnostics
} from '@/uni_modules/lizhao-zhima-score'
import {
  createZhimaScoreReport,
  splitZhimaScoreReport
} from '@/uni_modules/lizhao-zhima-score/example/report.uts'

const snapshot = JSON.stringify(getZhimaCreditScoreDiagnosticsSync()) || '{}'
const report = createZhimaScoreReport('宿主=uni-app 或 uni-app x', snapshot, ['页面操作日志'])
const parts = splitZhimaScoreReport(report)
// 将 parts[index] 写入剪贴板；仅复制 success 后再把 index 加一。
clearZhimaCreditScoreDiagnostics()

API 用途速查

参数、默认值、返回值与回调

服务端响应必须包含 status、passed，可选 score、targetScore、serverRequestId 和 message。客户端只接受状态与 passed 一致的响应，评分值不会由客户端计算。score 是否返回由客户隐私政策和服务端合同决定。响应正文超过64KiB或服务端请求编号超过256字符时按格式错误处理，避免异常响应占用无界内存。

queryZhimaCreditScore 立即返回请求编号，允许多个查询并行执行。成功时只触发一次 success，结果包含 status、passed、可空 score、目标分值和脱敏可用的服务端请求编号。失败时只触发一次 fail，错误包含 errSubject、错误码、请求编号、状态和 outcomeUnknown。complete 始终最多触发一次，包含 succeeded、终态状态和错误码。unknown 表示客户端无法确认服务端最终结果，重试前应先按 serverRequestId 向服务端核对。诊断快照的 waiting 只要仍有任一请求活动就为 true，activeRequestId 表示最近登记且尚未结束的请求。

错误码说明

统一 errSubject 为 lizhao-zhima-score。插件不提供人脸核身、芝麻认证或支付宝授权登录。

注意事项

• AppSecret、RSA 私钥、芝麻原始响应和身份证信息只允许保存在客户服务端，不能放入插件参数、页面或日志。
• 客户服务端必须验证业务会话和用户授权，不能相信客户端传来的用户身份或 passed 字段。
• uni-app：支持 Vue2/Vue3；App 侧声明 Android、iOS、Harmony，Web 侧声明 Chrome/Safari，小程序侧只声明微信。
• uni-app x：App 侧声明 Android、iOS、Harmony，Web 侧声明 Chrome/Safari，小程序侧只声明微信；示例使用 .uvue 和 <script setup lang="uts">。
• Android、iOS、Harmony 均通过宿主 uni.request 访问客户 HTTPS 服务端，没有新增原生 SDK、系统权限或平台专属密钥存储。
• Web 必须满足 HTTPS、CORS 和客户服务端域名配置；微信小程序必须把地址加入合法 request 域名。支付宝、抖音、百度、快手等小程序本版本不在 platforms 中声明支持。
• 插件只使用宿主网络请求，不申请相册、定位、电话或设备标识权限。达到 timeoutMs 后会尝试调用宿主请求任务的 abort()，仍以 9395002 表示客户端未取得最终结果。
• 当前平台声明代表入口和静态兼容性范围，不替代真实芝麻服务端回执、设备网络、剪贴板或发布环境验收。
• 插件没有新增原生 SDK 或系统权限，通常无需重打自定义基座；宿主安全域名、代理或证书配置变化时按宿主发布流程重新构建并验证。
• 示例报告提供一键复制、分段复制和复制失败手动回退，复制内容会脱敏。

作者系列 UTS 插件

以下系列清单由项目统一发布清单生成。具体能力和适用范围请查各插件详情页。