# TLM-Quantum: 遞迴真空量子數生成器 (مولد الأرقام الكمومية العودي)

## 專案概述 (نظرة عامة)

本模組實現遞迴真空波動量子數生成管線 (خط أنابيب توليد الأرقام الكمومية العودية)，透過 P4 ALGOL 源邊界注入真空樣本，經多層遞迴混合與 GF(2⁸) 有限域運算 (حقل غالوا الثنائي)，輸出確定性 32 位元量子數。

Authors: Ahmad Ali Parr, Jessica L. Williams (SNAPKITTYWEST)

---

## 核心模組架構 (هيكل الوحدات الأساسية)

```
P4 ALGOL (source boundary)
    │
    ▼
Quantum Event Generator
    │  VacuumSample { SourceWord, GravityWord, EventWord, ModeWord }
    ▼
Recursive Generator
    │  RecursiveVacuumStep + QuantumState (16 × 32-bit words)
    ▼
32-bit Quantum Number
    │  RecursiveP3 feedback (depth 4)
    ▼
P3 Round  (QuantumP3Round)
    │
    ▼
P2 GF(2⁸)  (MixColumn / XTime)
    │
    ▼
P1 Boolean  (XOR32, AND32, ROTL32, ROTR32)
```

---

## 驗證矩陣 (مصفوفة التحقق)

| 測試 (الاختبار) | 驗證目標 (هدف التحقق) | 狀態 (الحالة) |
|---|---|---|
| XTime | GF(2⁸) 乘以 x 在邊界值 ($00,$01,$40,$80,$FF) | 通過 (Pass) |
| MixColumn | AES 規範向量: D4 BF 5D 30 → 04 66 81 E5 | 通過 (Pass) |
| ZeroColumn | 零輸入 → 零輸出 (線性性) | 通過 (Pass) |
| RepeatedColumn | 常數列不動點 | 通過 (Pass) |
| StateInit | 相同種子 → 相同 16 字狀態 (確定性) | 通過 (Pass) |
| Recursion | RecursiveSeed 純函數 / 引用透明 | 通過 (Pass) |
| SampleFusion | FuseVacuumSample 確定性 | 通過 (Pass) |

---

## 核心性質 (الخصائص الأساسية)

| 性質 (الخاصية) | 值 (القيمة) |
|---|---|
| 狀態大小 | 16 × 32-bit words |
| 最大遞迴深度 | 64 |
| 輸出字寬 | 32 bits |
| 算術 | 模整數 (mod 2³²) |
| GF 域 | GF(2⁸), 不可約多項式 x⁸+x⁴+x³+x+1 (AES) |
| P3 測試向量 | D4 BF 5D 30 → 04 66 81 E5 |

---

## 許可協議與主權聲明 (الترخيص والسيادة)

**BSL-1.1 / AGPL-3.0 / MPL-2.0**

SnapKitty West / SNAPKITTYWEST — Evidence or Silence — 2026