From 09ac9944c678b9b2e401febacdd2d7487ae917a6 Mon Sep 17 00:00:00 2001 From: zimoyin <2556608754@qq.com> Date: Mon, 19 Oct 2026 00:28:05 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=B0=E5=BD=95=20Win7=20=E4=B8=8D?= =?UTF-8?q?=E6=94=AF=E6=8C=81=E5=8F=8A=E6=8E=A8=E8=8D=90=E6=9E=B6=E6=9E=84?= =?UTF-8?q?=EF=BC=8C=E5=A4=87=E4=BB=BD=E7=9B=AE=E5=BD=95=E4=B8=8D=E8=BF=9B?= =?UTF-8?q?=20git?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 实测确认 Win7 跑不了本服务,且不建议降级: · Win7 最高只支持 Python 3.8,项目要求 >=3.10 · paddlepaddle 3.2.x 没有 cp38 轮子,3.8 上最高 3.0.0 · uvicorn>=0.34 要求 3.9+,整条 Web 栈都要降 · 源码有 120+ 处 3.9/3.10+ 注解,pydantic 模型需真正改写 · GPU 不可行:CUDA 11.8 需 520+ 驱动,Win7 最高 472 推荐把服务放在 Win10+/Linux,Win7 只当浏览器客户端 (Chrome 109 / Firefox 115 ESR;IE11 不支持 fetch 与可选链)。 另:环境备份放在 backups/(本地快照),加进 .gitignore—— 可复现的部分(pyproject / uv.lock / 源码)本来就在 git 里。 Co-Authored-By: Claude Code --- .gitignore | 3 +++ README.md | 20 ++++++++++++++++++++ 2 files changed, 23 insertions(+) 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 安装和启动 源码启动: