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:
@@ -18,3 +18,6 @@ build/
|
|||||||
|
|
||||||
# 打包产物的压缩包(体积可达数 GB),不要进仓库
|
# 打包产物的压缩包(体积可达数 GB),不要进仓库
|
||||||
*.zip
|
*.zip
|
||||||
|
|
||||||
|
# 环境备份(本地快照,可复现的内容已在 git 里)
|
||||||
|
backups/
|
||||||
|
|||||||
@@ -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 安装和启动
|
||||||
|
|
||||||
源码启动:
|
源码启动:
|
||||||
|
|||||||
Reference in New Issue
Block a user