1

2026-09-24 16:25:22 +08:00
commit 7428184f01
1198 changed files with 314515 additions and 0 deletions
@@ -0,0 +1,146 @@
+# x-crypto-s
+### 开发文档
+[TMUI4.0文档](https://xui.tmui.design/)
+[TMUI4.0组件库](https://ext.dcloud.net.cn/plugin?id=16369)
+
+加密插件
+
+### 说明
+这是tmui4.0|XUI的原生插件附赠插件，提供了多种加密算法的实现，包括MD5、Base64、SHA系列、AES、DES、RSA和RC4等。所有加密算法均采用原生加密代码实现，与CryptoJS加密结果完全一致。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### API说明
+
+#### MD5加密
+```ts
+function md5(str: string): string
+```
+- 参数：
+  - str: 待加密的字符串
+- 返回值：MD5加密后的字符串
+
+#### Base64编解码
+```ts
+function base64Encode(str: string): string
+function base64Decode(str: string): string
+```
+- 参数：
+  - str: 待编码/解码的字符串
+- 返回值：Base64编码/解码后的字符串
+- 注意：在Web端加密中文字符时，需要先使用encodeURI处理
+
+#### SHA系列加密
+```ts
+function sha256(str: string): string
+function sha512(str: string): string
+function sha1(str: string): string
+function hmacSha256(key: string, data: string): string
+function hmacSha512(key: string, data: string): string
+```
+- 参数：
+  - str/data: 待加密的字符串
+  - key: HMAC加密的密钥
+- 返回值：对应算法加密后的字符串
+
+#### AES加密
+```ts
+function aesEncrypt(key: string, data: string, mode: string = "ECB", iv: string|null = null, keySize: number|null = null): string
+function aesDecrypt(key: string, data: string, mode: string = "ECB", iv: string|null = null, keySize: number|null = null): string
+```
+- 参数：
+  - key: 加密密钥（UTF-8字符串，根据keySize截取和补足）
+  - data: 待加密/解密的数据
+  - mode: 加密模式，支持ECB和CBC
+  - iv: 初始化向量
+  - keySize: 密钥长度（16=128位, 24=192位, 32=256位）
+- 返回值：加密/解密后的字符串
+
+#### DES加密
+```ts
+function desEncrypt(key: string, data: string, mode: string = "ECB", iv: string|null = null): string
+function desDecrypt(key: string, data: string, mode: string = "ECB", iv: string|null = null): string
+```
+- 参数：
+  - key: 加密密钥
+  - data: 待加密/解密的数据
+  - mode: 加密模式，支持ECB和CBC
+  - iv: 初始化向量
+- 返回值：加密/解密后的字符串
+
+#### RSA加密
+```ts
+function generateRSAKeyPair(keySize: number = 2048): RSARANDOMKEY
+function rsaEncrypt(publicKey: string, data: string): string
+function rsaDecrypt(privateKey: string, data: string): string
+```
+- 参数：
+  - keySize: RSA密钥长度
+  - publicKey: 公钥
+  - privateKey: 私钥
+  - data: 待加密/解密的数据
+- 返回值：
+  - generateRSAKeyPair: 返回包含publicKey和privateKey的对象
+  - rsaEncrypt/rsaDecrypt: 加密/解密后的字符串
+
+#### RC4加密
+```ts
+function rc4Encrypt(key: string, data: string): string
+function rc4Decrypt(key: string, data: string): string
+```
+- 参数：
+  - key: 加密密钥
+  - data: 待加密/解密的数据
+- 返回值：加密/解密后的字符串（hex格式）
+
+### 使用示例
+
+```ts
+import {
+  md5, sha256, sha512, sha1, hmacSha256, hmacSha512,
+  base64Encode, base64Decode,
+  aesEncrypt, aesDecrypt,
+  desEncrypt, desDecrypt,
+  rsaEncrypt, rsaDecrypt,
+  rc4Encrypt, rc4Decrypt,
+  generateRSAKeyPair
+} from '@/uni_modules/x-crypto-s'
+
+// MD5加密
+const md5Result = md5("TMUI4.0X")
+
+// Base64编解码
+const base64Result = base64Encode("TMUI4.0X")
+const decodedText = base64Decode(base64Result)
+
+// SHA系列加密
+const sha256Result = sha256("TMUI4.0X")
+const hmacResult = hmacSha256("密钥", "TMUI4.0X")
+
+// AES加密（CBC模式）
+const aesResult = aesEncrypt(
+  "1234567890abcdef",
+  "TMUI4.0X",
+  "CBC",
+  "1234567890abcdef"
+)
+const aesDecrypted = aesDecrypt(
+  "1234567890abcdef",
+  aesResult,
+  "CBC",
+  "1234567890abcdef"
+)
+
+// RSA加密
+const rsaKeys = generateRSAKeyPair()
+const encrypted = rsaEncrypt(rsaKeys.publicKey, "TMUI4.0X")
+const decrypted = rsaDecrypt(rsaKeys.privateKey, encrypted)
+```
+
+更多使用示例和在线加密对比工具：
+- MD5/SHA对比：https://www.mklab.cn/utils/md5
+- DES对比：https://www.mklab.cn/utils/des