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>
This commit is contained in:
zimoyin
2026-10-14 11:59:39 +08:00
parent 5ab4bef80e
commit 0a299dec18
5 changed files with 278 additions and 13 deletions
+19
View File
@@ -9,6 +9,7 @@ PREPARE_CONFIG = PROJECT_ROOT / "scripts" / "prepare_release_config.py"
PADDLE_ENV = PROJECT_ROOT / "scripts" / "paddle_env.py"
INSTALL_PADDLE = PROJECT_ROOT / "scripts" / "install_paddle.py"
SWITCH_ENV = PROJECT_ROOT / "scripts" / "switch_env.py"
API_CLIENT = PROJECT_ROOT / "scripts" / "api_client.py"
SAMPLE = """\
# 中文注释必须原样保留
@@ -101,6 +102,24 @@ def test_install_paddle_rejects_unknown_cuda_channel() -> None:
assert result.returncode == 2
def test_api_client_help_and_missing_args() -> None:
assert run_script(API_CLIENT, "--help").returncode == 0
# 不给图片又不带 --health:argparse 应该报错退出(2)
assert run_script(API_CLIENT).returncode == 2
def test_api_client_fails_cleanly_when_server_unreachable() -> None:
"""服务不可达时要干净退出并给出可读提示,而不是抛未捕获的异常。
不断言具体是「连接被拒」还是「HTTP 错误」:CI/沙箱里可能有透明代理,
两者都会出现。真正要保证的是有明确报错、没有 traceback。
"""
result = run_script(API_CLIENT, "--health", "--host", "http://127.0.0.1:1")
assert result.returncode == 1
assert "http://127.0.0.1:1" in result.stderr
assert "Traceback" not in result.stderr
def test_switch_env_list_reports_both_variants() -> None:
"""--list 只读,不能改动任何环境。"""
result = run_script(SWITCH_ENV, "--list")