diff --git a/.gitignore b/.gitignore index 9348a4e..5d05d6b 100644 --- a/.gitignore +++ b/.gitignore @@ -18,3 +18,6 @@ build/ # 打包产物的压缩包(体积可达数 GB),不要进仓库 *.zip + +# 环境备份(本地快照,可复现的内容已在 git 里) +backups/ diff --git a/README.md b/README.md index 1aea1d8..f1c2346 100644 --- a/README.md +++ b/README.md @@ -509,6 +509,26 @@ D:\code\work\ocr-server\.venv\Scripts\python.exe 在 Ubuntu 上,建议使用系统 Python 3.10–3.12 或 uv 创建项目虚拟环境,不会影响系统其他 Python 项目。 +### Windows 7 不支持 + +**本服务不能运行在 Windows 7 上**,也不建议为了 Win7 做降级。实测确认的阻断点: + +| 层面 | 情况 | +| --- | --- | +| Python | Win7 最高只支持 Python **3.8**(3.9 起官方不再支持 Win7),本项目要求 `>=3.10` | +| 打包产物 | exe 内嵌 CPython 3.12,在 Win7 上启动即失败(缺 `api-ms-win-core-path-l1-1-0.dll`) | +| `paddlepaddle` | 3.2.x **没有 cp38 轮子**,3.8 上最高只能用 3.0.0 | +| Web 栈 | `uvicorn>=0.34` 要求 Python >=3.9,整条栈都要降版本 | +| 本项目的代码 | 有 120+ 处 3.9/3.10+ 注解语法,其中 pydantic 模型必须真正改写(不能只加 `from __future__ import annotations`) | +| GPU | **不可行**:CUDA 11.8 需要 520+ 驱动,Win7 最后只支持到 472 | + +**推荐架构**:把服务跑在 Win10+ 或 Linux 机器上,Win7 只当客户端——用浏览器打开 +`scripts/GUI.html`,或调用 HTTP 接口。Win7 上需要 Chrome 109(最后一个支持 Win7 的 +版本)或 Firefox 115 ESR;**IE11 不行**(不支持 `fetch`、可选链、`async/await`)。 + +如果必须在 Win7 本机跑,那是一次完整移植(降 Python、降 Paddle、降 Web 栈、改注解), +且最终兼容性只能在 Win7 实机上验证。 + ## Windows 安装和启动 源码启动: