GMKit 使用手册

本手册只描述已发布的 GMKit 0.10.1。先完成五分钟快速入门，再按业务任务选择语言章节；需要逐成员签名时进入 API 说明书。

阅读顺序

1. 安装验证锁定制品版本，运行 SM3 固定向量，确认包入口和运行环境。
2. 常用任务完成签名验签、认证加密、摘要与 HMAC，并验证篡改失败。
3. 协议接入固定编码、userId、mode、nonce、AAD、tag 和载荷版本。
4. 高级能力按需使用密钥交换、增量状态、Provider、SM9 和混合加密。
5. 旧系统迁移只在维护既有数据时查阅替代 API、行为差异和迁移验收。

按项目语言阅读

gmkitx · 0.10.1TypeScript 使用手册Node.js、浏览器、显式编码、SM2、SM3、SM4、ZUC、SHA 与高级运行环境。cn.gmkit · 0.10.1Java 使用手册Java 8、Provider、安全上下文、SM2、SM3、SM4、ZUC、SM9 和混合加密。Java ↔ TypeScript跨语言协议接入固定 UTF-8、Base64、DER、C1C3C2、GCM 字段和协议版本。仅维护旧系统旧系统迁移查询已发布兼容入口的替代 API、协议风险、双算步骤和下线条件。

查到哪一层就够了

文档	用于解决的问题	不承担的内容
快速入门	依赖是否安装正确	协议字段设计
使用手册	一个业务任务怎样接通	枚举全部重载
API 说明书	某个参数或成员怎样使用	替应用决定协议
算法与标准	标准字段和双语言差异	重复语言调用代码
迁移附录	旧入口怎样替换	新接入流程

手册中的随机密文和签名只检查能否解密、验签和拒绝篡改；只有公开固定向量才比较完整 Hex 结果。