docs: 记录 Win7 不支持及推荐架构,备份目录不进 git

实测确认 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 <noreply@anthropic.com>
This commit is contained in:
zimoyin
2026-10-19 00:28:05 +08:00
parent 3772998137
commit 09ac9944c6
2 changed files with 23 additions and 0 deletions
+3
View File
@@ -18,3 +18,6 @@ build/
# 打包产物的压缩包(体积可达数 GB),不要进仓库 # 打包产物的压缩包(体积可达数 GB),不要进仓库
*.zip *.zip
# 环境备份(本地快照,可复现的内容已在 git 里)
backups/
+20
View File
@@ -509,6 +509,26 @@ D:\code\work\ocr-server\.venv\Scripts\python.exe
在 Ubuntu 上,建议使用系统 Python 3.10–3.12 或 uv 创建项目虚拟环境,不会影响系统其他 Python 项目。 在 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 安装和启动 ## Windows 安装和启动
源码启动: 源码启动: