更新记录

1.0.0（2026-11-05） 下载此版本

1.0.0

• 首个版本：AES-CBC/ECB（口令自动 PBKDF2 派生 + 随机 IV）、SHA-256、HMAC-SHA256、PBKDF2、UTF-8 安全 Base64、随机串/UUID
• 内置 selfTest()：6 项标准向量自检（FIPS-197/RFC4231/RFC7914），可在 App 启动时诊断
• 纯 JS 零原生依赖；node:crypto 双向 oracle 验证（21 测全绿）

平台兼容性

pk-crypto 加解密套件

AES-128/192/256（CBC/ECB + PKCS7）、SHA-256、HMAC、PBKDF2、Base64、UUID。纯 JS 零原生依赖，S 盒数学推导生成，内置标准向量自检，可与 openssl/node 后端互通。

5 分钟接入

import pkc from '@/uni_modules/pk-crypto/js_sdk/index.js';

// 口令加密（推荐）：自动 PBKDF2 派生密钥 + 随机 IV，免管密钥长度规则
const e = pkc.aesEncrypt('机密数据', 'MyP@ssw0rd');   // { ok:true, data:'base64…' }
const d = pkc.aesDecrypt(e.data, 'MyP@ssw0rd');       // { ok:true, data:'机密数据' }

// 摘要与签名
pkc.sha256('hello');                       // '2cf24d…'
pkc.hmacSha256('secret-key', 'body');      // 接口签名

// 密钥派生（注册/登录场景）
pkc.deriveKey('password', 'site-salt', { iterations: 1500, len: 32 });

// 随机与 Base64
pkc.randomHex(16); pkc.randomString(12); pkc.uuid();
pkc.base64Encode('中文安全'); pkc.base64Decode('…');

// 启动自检（标准向量）
const st = pkc.selfTest();   // { ok:true, checks:[…] }

API 全表

aesEncrypt / aesDecrypt opts

与后端互通（node 示例）

// node 端解密 pk-crypto 的密文（演示工程内附 mock 脚本）
const crypto = require('crypto');
const key = crypto.pbkdf2Sync('MyP@ssw0rd', 'pk-crypto.v1', 1000, 32, 'sha256');
const buf = Buffer.from(base64, 'base64');
const d = crypto.createDecipheriv('aes-256-cbc', key, buf.subarray(0, 16));
const plain = Buffer.concat([d.update(buf.subarray(16)), d.final()]).toString('utf8');

错误码

FAQ

Q: 安全性如何保证？ 实现对照 FIPS-197 / SP800-38A / RFC4231 / RFC7914 标准向量，并用 node:crypto 双向互解验证（21 项单测）。ECB 模式仅供兼容，敏感数据请用默认 CBC。

Q: 前端加密有意义吗？ 本地敏感数据落盘加密（配合 pk-storage）、接口签名防篡改是真实场景；防中间人请上 HTTPS。

Q: 速度如何？ 100 万字符 SHA-256 约 200ms（中端机）；AES 适合 KB 级业务数据，勿加密整个文件。