6 Commits

Author SHA1 Message Date
zimoyin 09ac9944c6 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>
2026-10-19 00:28:05 +08:00
zimoyin 0a299dec18 feat: 新增命令行 API 客户端,修复发布配置改写的反斜杠 bug
scripts/api_client.py:完整走一遍 upload -> 轮询 i2t -> 打印识别文本与抽取字段。
只用标准库(不依赖 requests),可直接拷到别的机器上跑;支持多图、
--min-confidence(服务端过滤)、--json、--health。参数校验放在探活之前,
参数写错时不会因为连不上服务而报出误导性错误。

scripts/prepare_release_config.py:re.sub 的**替换串**里反斜杠是转义序列,
写 Windows 路径(model_dir=D:\...)必然抛 "bad escape \c"。改用函数式替换。

.gitignore 补 *.zip:打包产物压出来有数 GB,别误提交。

README:补命令行客户端用法、发布包共用项目 models 目录的做法。

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-14 11:59:39 +08:00
zimoyin 5ab4bef80e build: CPU/GPU 双环境、产物命名与打包修复
交付:
  · 产物按变体命名:CPU -> dist/ocr-server/,GPU -> dist/ocr-server-gpu/。
    变体由构建环境实际装的 paddle 自动判断,不需要人工声明
  · GPU 包额外加 --collect-binaries nvidia。漏收的后果实测是最难查的那种:
    引擎能正常加载、设备也识别成 GPU,但第一次推理才报
    cudnn64_9.dll error 126
  · --copy-metadata 的发行包名随变体变化(paddlepaddle / paddlepaddle-gpu),
    改由 scripts/paddle_env.py 动态取;写死任何一个在另一种环境下都打不出包
  · 新增 scripts/prepare_release_config.py 按变体覆盖发布配置(用 Python 改写
    以保持 UTF-8,PowerShell 的 Set-Content 会把中文注释写坏)

环境:
  · paddle 从 pyproject 依赖里移除,改用 scripts/install_paddle.py 安装。
    它没法写死:CPU/GPU 互斥,GPU 还得按显卡选 CUDA 通道(RTX 50 系必须 cu129)。
    钉死 CPU 版时,uv sync / uv run / PyCharm 自动同步都会把装好的
    paddlepaddle-gpu 静默挤掉、服务悄悄退回 CPU(实测踩过三次)
  · 新增 scripts/switch_env.py:.venv(CPU)与 .venv-gpu(GPU)两套环境共存,
    切换零成本;所有 uv run 补 --no-sync,打包改用 uv sync --inexact
  · 预置模型扩到 8 套(v4/v5 × 服务端/移动端 × 检测/识别,约 398MB)

其它:
  · scripts/start.* 先找发布包再退回源码环境;入口脚本名固定是 ocr-server
  · benchmark_ocr.py 输出 segments 与 chars,换设备/模型时可直接比对召回
  · .gitignore 覆盖 .venv-gpu/ 与 dist*/

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-14 03:53:48 +08:00
zimoyin 84600f60a8 chore: keep model files out of git
Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-13 13:16:57 +08:00
zimoyin 5ddda545f5 init2 2026-10-12 11:00:09 +08:00
zimoyin 11883e260f init 2026-10-11 02:26:26 +08:00