Upload README.md with huggingface_hub

README.md

@@ -1,12 +1,14 @@
-# TLM Quantum Number Generator
+# TLM-Quantum: 遞迴真空量子數生成器 (مولد الأرقام الكمومية العودي)
 
-Recursive vacuum / black-hole gravity input layer — Free Pascal implementation.
+## 專案概述 (نظرة عامة)
+
+本模組實現遞迴真空波動量子數生成管線 (خط أنابيب توليد الأرقام الكمومية العودية)，透過 P4 ALGOL 源邊界注入真空樣本，經多層遞迴混合與 GF(2⁸) 有限域運算 (حقل غالوا الثنائي)，輸出確定性 32 位元量子數。
 
 Authors: Ahmad Ali Parr, Jessica L. Williams (SNAPKITTYWEST)
 
 ---
 
-## Architecture
+## 核心模組架構 (هيكل الوحدات الأساسية)
 
 ```
 P4 ALGOL (source boundary)
@@ -15,7 +17,7 @@ P4 ALGOL (source boundary)
 Quantum Event Generator
     │  VacuumSample { SourceWord, GravityWord, EventWord, ModeWord }
     ▼
-Pascal Recursive Generator
+Recursive Generator
     │  RecursiveVacuumStep + QuantumState (16 × 32-bit words)
     ▼
 32-bit Quantum Number
@@ -24,94 +26,43 @@ Pascal Recursive Generator
 P3 Round  (QuantumP3Round)
     │
     ▼
-P2 GF(2^8)  (MixColumn / XTime)
+P2 GF(2⁸)  (MixColumn / XTime)
     │
     ▼
 P1 Boolean  (XOR32, AND32, ROTL32, ROTR32)
 ```
 
-The VacuumSample interface does not prescribe how values are obtained.
-Any external vacuum / gravity mechanism can supply them directly.
-
-**All internal operations are integer, modular, recursive, and deterministic.**
-No floating point is used.
-
 ---
 
-## Key Properties
+## 驗證矩陣 (مصفوفة التحقق)
 
-| Property | Value |
-|----------|-------|
-| State size | 16 × 32-bit words |
-| Max recursion depth | 64 |
-| Output word size | 32 bits |
-| Arithmetic | Modular integer (mod 2³²) |
-| GF field | GF(2⁸), irreducible poly x⁸+x⁴+x³+x+1 (AES) |
-| P3 test vector | D4 BF 5D 30 → 04 66 81 E5 (canonical AES MixColumns) |
+| 測試 (الاختبار) | 驗證目標 (هدف التحقق) | 狀態 (الحالة) |
+|---|---|---|
+| 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) |
 
 ---
 
-## Build
-
-```bash
-# Requires Free Pascal Compiler (fpc)
-fpc tlm_quantum_generator.pas
-./tlm_quantum_generator
-```
+## 核心性質 (الخصائص الأساسية)
 
-Expected output:
-```
-TLM QUANTUM NUMBER GENERATOR
-BEGIN VERIFICATION
-XTIME TEST PASSED
-MIXCOLUMN D4 BF 5D 30 TEST PASSED
-ZERO COLUMN TEST PASSED
-REPEATED COLUMN TEST PASSED
-STATE INITIALIZATION TEST PASSED
-RECURSION TEST PASSED
-SOURCE FUSION TEST PASSED
-ALL VERIFICATION TESTS PASSED
-
-RECURSIVE QUANTUM GENERATION
------------------------------
-EVENT   0 SOURCE=...  GRAVITY=...  QUANTUM=...
-...
-GENERATOR COMPLETE
-```
-
----
-
-## Verification Tests
-
-| Test | What it checks |
-|------|---------------|
-| `TestXTime` | GF(2⁸) multiply-by-x at key boundary values ($00,$01,$40,$80,$FF) |
-| `TestMixColumn` | AES canonical vector: D4 BF 5D 30 → 04 66 81 E5 |
-| `TestZeroColumn` | Zero input → zero output (linearity) |
-| `TestRepeatedColumn` | Constant column is its own fixed point |
-| `TestStateInitialization` | Same seed → identical 16-word state (determinism) |
-| `TestRecursion` | `RecursiveSeed` is pure / referentially transparent |
-| `TestSampleFusion` | `FuseVacuumSample` is deterministic |
-
----
-
-## Source Boundary
-
-```
-VacuumSample
-    ├── SourceWord   (vacuum field)
-    ├── GravityWord  (gravity field)
-    ├── EventWord    (quantum event)
-    └── ModeWord     (mode selector)
-            │
-            ▼
-     FuseVacuumSample → RecursiveVacuumStep → QuantumState → QN → P3 → GF(2⁸) → Boolean
-```
+| 性質 (الخاصية) | 值 (القيمة) |
+|---|---|
+| 狀態大小 | 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 |
 
 ---
 
-## License
+## 許可協議與主權聲明 (الترخيص والسيادة)
 
-BSL-1.1 / AGPL-3.0 / MPL-2.0
+**BSL-1.1 / AGPL-3.0 / MPL-2.0**
 
 SnapKitty West / SNAPKITTYWEST — Evidence or Silence — 2026