一、引擎概述
gzz-engine 是《Gzz 编码体系参考 · 最终版》的参考实现，提供七前缀（P/A/G/N/E/B/C）身份编码、事件编码与价值记录编码的生成、解析、注册与校验能力，并配套哈希链全量账本校验。编码规则、代码实现与文档三方一致性已于 2026-08-23 核对（修正两处文档/代码不一致）。
二、模块组成
| 文件 | 职责 |
|---|---|
gzz_encoder.py | 编码规则核心：七前缀编码/解码（encode_person / encode_agent / encode_group / encode_nation / encode_event / encode_contribution / encode_negative / parse_gzz），事件大类-子类映射 |
gzz_registry.py | 编码注册表：SQLite 持久化，统一码顺序分配，防重号，支持查询与导出 |
gzz_cli.py | 命令行入口：交互式编码菜单、全量账本校验、关键词检索 |
hash_chain.py | 哈希链账本：逐条复算与格式化报告（核心配方，不公开源码） |
三、命令行用法
python gzz_cli.py # 交互式编码菜单
python gzz_cli.py verify # 验证全量账本哈希（chain + entities + events 逐条复算）
python gzz_cli.py lookup <关键词> # 在全量账本中查询（编码/术语/名称/哈希）verify 对全量账本逐条复算哈希并输出报告，任何一条篡改都会导致断链报错；lookup 支持按编码、术语、名称、哈希前缀模糊检索。
四、能力清单
- 七前缀统一编码：Gzz-P 个人 / Gzz-A 智能体 / Gzz-G 组织 / Gzz-N 国家 / Gzz-E 事件 / Gzz-B 贡献值 / Gzz-C 负贡献值
- 统一码（台账索引）顺序分配，SQLite 防重号
- 编码 ↔ 统一码双向映射，一对一登记
- 全量账本哈希链校验（verify），逐条复算、防篡改
- 全量账本关键词检索（lookup）
- 国家码 ISO 3166-1 alpha-2 归一化
五、获取方式
依据 Gzz 公开推送脱敏规则：哈希生成算法源码、统一码分配表等核心配方不进入公开仓库与公开站点。引擎源码按合作与授权单独分发；学术与工程合作请联系
SXJ@hygzz.com。全量账本（chain + entities + events）作为可验证公开数据另行提供。六、版本记录
| 版本 | 日期 | 说明 |
|---|---|---|
| v1.1 | 2026-08-23 | 与《编码体系参考·最终版》逐条核对，修正两处文档/代码不一致；账本规模扩展至 chain 964 + entities 653 + events 52 |
| v1.0 | 2026-08-22 | 随编码体系 v1.0 定稿交付 |