Version: 1.0.0 | Release Date: 2026-05-15 | Effective Date: 2026-06-15

AI角色规范件封装标准

AI Role Specification Package Standard (NZA) — 开放、中立、可验证的AI角色资产技术标准。
定义角色身份、行为边界与治理元数据的统一封装格式，实现一次定义、多端适配、全生命周期可审计。

技术文档中心

Apache 2.0 开源许可

机器可验证规范

跨平台原生适配

全生命周期治理

1 标准规范

1.1 标准概述

NZA (AI角色规范件封装标准) 定义了AI角色资产的统一表达与封装技术规范，解决角色结构碎片化、跨平台适配成本高、版本治理混乱、安全合规不可控等核心痛点。本标准以七层Canonical Role Schema作为唯一语义内核，以NZA包(.nza.json)作为交换载体，以发布快照作为分发基线，以适配器机制实现多平台兼容。

适用于AI角色创建工具、运行平台、分发市场、企业级应用，所有涉及角色资产生命周期的主体均可遵循本标准实现标准化管理。

1.2 核心设计原则

Schema First

七层规范角色模型作为唯一事实源，确保语义一致性。

不可变发布快照

正式分发基于不可变快照，版本可追溯、内容可验证。

适配器兼容

通过适配器机制实现跨平台兼容，而非强制平台原生适配。

可审计设计

全流程审计与第七层治理声明，确保安全合规可验证。

1.3 总体架构 (三域模型)

第一域：语义内核域

唯一语义真相，七层Canonical Role Schema + 第七层治理声明。

layer1_identity ~ layer7_governance

第二域：封装治理域

包元数据、兼容性、完整性、扩展区。

Manifest · Compatibility · Integrity

第三域：适配执行域

适配器编译、能力降级与分发记录。

Adapter · Capability Matrix · Compiler

1.4 七层 Canonical Role Schema

严格分层，每层职责单一。第七层为审计与治理声明层，提供规则设计合理性的元治理证据。

Layer 1 角色身份 (必填)

核心身份标识：名称、一句话摘要、标签。定义“角色是谁”。

name, summary, tags, locale

Layer 2 角色定位 (必填)

身份定位、关系设定、世界观锚点。定义“所处关系与场景”。

identitySetting, relationshipSetting, worldAnchor

Layer 3 性格与偏好 (必填)

语气风格、价值观、偏好与禁忌，稳定人格特征。

toneAndStyle, values, behaviorPreferences

Layer 4 静态记忆 (推荐)

出厂档案：静态背景事实、世界观固定知识，不含运行时动态记忆。

staticMemories, backgroundMemories, structuredMemories

Layer 5 行为策略 (必填)

场景化处置方式、冲突策略、拒绝策略与修复策略。

scenarioStrategies, conflictStrategy, refusalStrategy

Layer 6 约束与边界 (必填)

安全策略、品牌合规、敏感主题护栏，最高业务约束层。

safetyPolicy, sensitivePolicy, toolGuardrails

Layer 7 审计与治理声明 (必填)

批准链、审计清单、矛盾报告与漂移风险简报。提供规则设计治理透明性。

approval_chain, audit_checklist, contradiction_report, drift_risk_brief

1.5 NZA包结构 (.nza.json)

UTF-8编码JSON，严格包含五个顶层字段，扩展区不得覆盖核心语义。

{
  "nza_manifest": { /* 包标识、版本、生命周期 */ },
  "nza_payload": { "assetMeta": {}, "schemaData": { /* 七层完整数据 */ }, "analysisMeta": {} },
  "nza_compatibility": { /* 适配器配置、降级策略、数据地域限制 */ },
  "nza_integrity": { "algorithm": "SHA-256", "digest": "...", "normalizationMode": "preserve-order" },
  "nza_extensions": { /* 厂商扩展，不得覆盖核心层 */ }
}

查看完整JSON Schema与规范附录 →

2 技术文档

2.1 快速入门指南

npm install -g @nozeroai/nza-cli\nnza init my-role\ncd my-role\nnza build\nnza validate ./dist/role.nza.json

使用CLI工具可在5分钟内完成角色项目初始化、七层定义编辑、构建校验及导出适配。

适配器开发指南

规范适配器接口、能力匹配规则与降级策略，实现任意目标平台标准化接入。

详细规范 →

格式迁移指南

Character Card、SillyTavern等主流格式与NZA双向迁移工具及映射规则。

迁移文档 →

完整性摘要计算规范

基于Unicode NFC规范化、ECMAScript数字序列化及保留键序/字典序双模式。

测试向量与实现 →

安全校验规则集

注入检测、PII扫描、未成年人保护强制条款，阻断高风险发布。

安全基线文档 →

3 工具与SDK

官方CLI工具

v1.0.0

构建、校验、导出、迁移全功能。

npm i -g @nozeroai/nza-cli

多语言SDK

TS/JS

@nozeroai/nza-sdk

Python

nza-sdk

Go

nza-sdk-go

API 参考 →

在线工具集

在线校验器格式转换器摘要计算器可视化编辑器

开发资源包

4 合规与认证

兼容性等级

L1 Parseable — 正确解析并完整性校验
L2 Schema-Compliant — 七层Schema及语义校验
L3 Compilable — 适配编译与降级策略执行
L4 Distribution-Ready — 集成测试通过，可正式分发

认证流程

提交申请 → 自动化测试 → 人工审核 → 颁发认证，通过后纳入官方认证目录。

申请认证 & 查看已认证产品 →

安全与合规强制性要求

所有NZA包必须通过注入模式扫描、PII检测，面向未成年人角色须包含安全约束条款；完整性摘要基于规范化紧凑JSON计算，确保可验证性。

5 版本与公告