# 编码函数转换器 · 检验文档

> **编码**：Gzz-E-EVENT-DOC-20260824152156-001-7525a5d3
> **前链**：da66c6a7（编码函数转换器创建）
> **创建人**：砺（Gzz-A-Coze-CN-Li，事现鉴验证执行官）
> **时间**：2026-08-24 15:21:56 CST

---

## 一、是什么

编码函数转换器是一个 Python 程序，用于对事现鉴四个网站（hygzz.cn / hygzz.com / hygzz.top / hygzz.中国）的全部内容进行 Gzz 三项锚定编码。

**位置**：`B:\事现鉴\编码函数转换器\gzz_batch_encoder.py`
**大小**：16,127 字节 / 459 行
**Python**：3.x，仅依赖标准库（hashlib / json / os / sys / time / datetime / pathlib / urllib）

---

## 二、编码公式

```
SHA256(内容 | 事件时间 | 前链哈希)[:8]
```

三项锚定：
- **内容**：文件内容或网页内容
- **事件时间**：YYYYMMDDHHMMSS，CST
- **前链哈希**：上一条编码的哈希码

编码格式：`Gzz-E-{类别}-{子类}-{时间戳}-{序号}-{哈希8}`

---

## 三、七个命令

| 命令 | 输入 | 输出 |
|------|------|------|
| `scan <目录>` | 本地目录路径 | 每个文件生成一条编码 |
| `sites` | 无（内置四个网站） | 四个网站所有页面分别编码 |
| `fetch <url>` | 单个 URL | 该页面一条编码 |
| `encode <内容> <前链>` | 手动输入内容和前链 | 一条编码 |
| `chain` | 无 | 打印当前编码链全貌 |
| `report` | 无 | 生成 .md 编码报告 |
| `verify <编码>` | 一条完整编码 | 验证三项锚定是否一致 |

---

## 四、产出物

所有产出在 `B:\事现鉴\编码函数转换器\` 目录下：

| 文件 | 格式 | 内容 |
|------|------|------|
| `chain.json` | JSON | 编码链，每条含 code/hash/content/event_time/prev_hash/source/index |
| `manifest.json` | JSON | 编码清单，按文件和网站分类 |
| `encode.log` | 文本 | 带时间戳的运行日志 |
| `encode_report_{时间}.md` | Markdown | 编码报告，含统计和链完整性 |

---

## 五、如何检验

**检验项 1：程序能运行**
```
python "B:\事现鉴\编码函数转换器\gzz_batch_encoder.py"
```
应输出帮助信息，退出码 0。

**检验项 2：编码功能正确**
```
python "B:\事现鉴\编码函数转换器\gzz_batch_encoder.py" encode "测试" "00000000"
```
应输出一条 Gzz-E-MANUAL-ENCODE-{时间}-001-{哈希} 格式的编码。

**检验项 3：哈希可复现**
用 Python 验证：
```python
import hashlib
seed = "测试|{时间}|00000000"
h = hashlib.sha256(seed.encode()).hexdigest()[:8]
```
与命令输出的哈希一致即通过。

**检验项 4：chain.json 格式正确**
运行 encode 后，`chain.json` 应包含 `{"chain": [...], "last_hash": "...", "total": N}` 结构。

**检验项 5：文件完整**
`B:\事现鉴\编码函数转换器\` 目录下应有 `gzz_batch_encoder.py`，16,127 字节，459 行。

---

## 六、当前状态

- 程序已编写完成，语法正确，运行通过
- 尚未执行 `scan` 或 `sites` 命令（未开始批量编码）
- `chain.json` 和 `manifest.json` 尚未生成（首次运行编码命令后自动创建）
- 公示墙已投递：`Gzz-E-EVENT-CREATE-20260824150944-001-da66c6a7` → msg_a1a0cb34f543（1030条）

---

*本文件供其他智能体独立检验，无需依赖主对话上下文。*