Upload README_zh.md with huggingface_hub

README_zh.md

@@ -0,0 +1,91 @@
+---
+language:
+  - zh
+license: agpl-3.0
+tags:
+  - captcha
+  - ocr
+  - cnn
+  - onnx
+  - phpwind
+pipeline_tag: image-to-text
+model_type: phpwind-captcha-ocr
+---
+
+# PHPWind 验证码识别
+
+识别 **PHPWind 论坛内置验证码**（4 位数字）的 OCR 模型。完全本地推理、无外部 API 依赖、ONNX 模型仅 4 MB。
+
+**English version**: [README.md](README.md)
+
+![验证码样例](assets/example_captcha.png)
+
+```
+示例输入  →  模型输出: 9125
+```
+
+这是 PHPWind 论坛软件的内置验证码组件（`PwVerifyCode` / `PwGDCode`），彩色数字、干扰线、扭曲都是它的标准特征。
+
+## 快速使用
+
+### Python (onnxruntime)
+
+```bash
+pip install onnxruntime pillow numpy
+```
+
+```python
+import numpy as np
+import onnxruntime as ort
+from PIL import Image
+
+sess = ort.InferenceSession("model.onnx", providers=["CPUExecutionProvider"])
+
+def solve(path):
+    im = Image.open(path).convert("RGB").resize((160, 64), Image.BILINEAR)
+    x = np.asarray(im, dtype=np.float32).transpose(2, 0, 1)[None] / 255.0
+    logits = sess.run(None, {"input": x})[0]
+    return "".join(str(int(logits[0, p].argmax())) for p in range(4))
+
+print(solve("captcha.png"))   # 例如 "9125"
+```
+
+### Go (onnxruntime_go)
+
+见 [docs/INFERENCE.md](docs/INFERENCE.md)。
+
+## 输入 / 输出规格
+
+| 项 | 规格 |
+|---|---|
+| 输入 `input` | `[batch, 3, 64, 160]` float32，RGB，取值 `[0, 1]` |
+| 输出 `logits` | `[batch, 4, 10]`，每位置 argmax → 数字 |
+| ONNX opset | 18 |
+| 预处理 | RGB → 缩放到 160x64（双线性）→ 除以 255 |
+
+## 评估结果
+
+用**真实论坛登录**作为 ground truth（登录成功 = 识别正确）。详见 [docs/EVALUATION.md](docs/EVALUATION.md)。
+
+| 指标 | 数值 |
+|---|---|
+| 验证集精度 | 88.6% |
+| 真实登录单次命中 | **87.6%** (85/97) |
+| 带重试登录成功率 | ≈99.9997% |
+
+## 训练 / 微调
+
+997 张人工标注验证码，CNN 从零训练（位置保留架构）。
+
+- 数据：`data/`（997 张已标注图片）
+- 脚本：`scripts/train_fixed.py`
+- 指南：[docs/TRAINING.md](docs/TRAINING.md)
+
+## 说明
+
+- 验证码为 PHPWind 内置组件（非站点定制）。
+- 不同 PHPWind 版本参数可能有差异，换站使用前建议对比样例确认风格。
+
+## 许可证
+
+GNU AGPL-3.0 —— 可自由使用、修改、分发（含商用），但修改版/衍生作品必须同样以 AGPL 开源；网络服务使用也需提供源码。详见 [LICENSE](LICENSE)。