# jsonW 1.4.0:静态加密、文档掩码与代理协议配置文件 .jsw 文件可以在磁盘上保持加密,密钥存放在文件之外。CPF 与 CNPJ 使用掩码,遇到无效值时会拒绝写入。49 个代理协议对象各自有一份经往返验证的配置文件。 2026年11月15日 · jsonW 1.4.0 · https://jsonw.org/zh/newsroom/version-1-4-0-jiami-yanma-peizhi ## 1.4.0 带来什么 三项内容。静态加密,适用于保存在磁盘上的文件。多个国家的文档掩码,写入时拒绝无效值。以及代理协议的 jsonW 配置文件,每个对象都有已保存并经核对的样本。不使用这些功能的人不会察觉差异:未加密且不含新类型的文件,与 1.3.14 写出的文件逐字节相同。 ## 静态加密 .jsw 文件可以在磁盘上保持加密(XChaCha20-Poly1305)。租户密钥存放在文件之外:一个由 64 个十六进制字符组成的文件,通过 WJSW_CHAVE_ARQ 或 --chave 选项指定。没有密钥,加密文件无法打开。 ``` $ wjsw cifrar cifrado.jsw --chave chave.hex $ wjsw conferir cifrado.jsw FALHOU: arquivo cifrado: falta a chave do tenant (WJSW_CHAVE_ARQ ou credencial wjsw-chave) $ wjsw para-texto cifrado.jsw --chave chave.hex {id:1,cpf:"12345678909",cnpj:"11222333000181"} {id:2,cpf:"12345678909",cnpj:"11222333000181"}``` wjsw 1.4.1 的真实输出。工具的提示信息为葡萄牙语。cifrar 不输出任何内容。没有密钥时,conferir 以退出码 1 结束。 ## 文档掩码 在 mascara(类型) 列中,jsonW 接受带标点或不带标点的文档号,保存规范形式,并拒绝无效值。下例读取带标点的 CPF 和 CNPJ,只保存数字。 ``` $ wjsw de-texto "id:i64,cpf:mascara(cpf),cnpj:mascara(cnpj)" clientes.jsw.txt docs.jsw 2 linhas -> docs.jsw $ wjsw para-texto docs.jsw {id:1,cpf:"12345678909",cnpj:"11222333000181"} {id:2,cpf:"12345678909",cnpj:"11222333000181"} $ wjsw de-texto "id:i64,cpf:mascara(cpf),cnpj:mascara(cnpj)" invalido.jsw.txt inv.jsw valor 1 nao coube no esquema``` 最后一条命令以退出码 1 结束:CPF 111.111.111-11 无效。 类型包括 CPF、CNPJ、CEP、电话、PIS、RENAVAM、IBAN、葡萄牙 NIF、法国 SIREN 与 SIRET、美国 EIN 与 SSN、墨西哥 CURP 与 RFC、智利 RUT 以及意大利 partita IVA。完整列表见 mascara/wmascara.h。 ## 代理协议的配置文件 perfis/ 目录为每个协议提供一个文件,包含每个对象的 jsonW 模式:A2A、UCP、ACP、AP2、Verifiable Intent、x402、MPP、AG-UI 与 OpenTelemetry,另有 L402 与 PIX。每个对象都有已保存的样本和经核对的完整性记录,往返之后与输入一致。 ``` $ bash perfis/provar-perfis.sh bin/macos-arm64/wjsw | tail -1 perfis: 49 ok, 0 falhas``` ## 兼容性 在两个版本上用同一模式测量。1.4.1 写出的未加密文件,与 1.3.14 写出的文件逐字节相同。1.3.14 无法打开加密文件:它会拒绝并显示 versao do jsonW desconhecida,而不是把密文当作数据读取。 ``` $ wjsw para-texto cifrado.jsw # 使用 1.3.14 的二进制文件 versao do jsonW desconhecida``` ## 在哪里获取 在 wjsw 工具、库和各 SDK 中。npm 安装命令为 npm install @wortictecnologia/jsonw@1.4.0。修复权限视图的 1.4.1 紧随其后,见 1.4.1 的文章。 Fonte: https://github.com/developer-wortic/jsonw/releases/tag/v1.4.0