docs(deploy): §5c 补 r3 实测关键 env(设备模式开关/LLM 阶段四键/8093 主上游提醒)

This commit is contained in:
2026-09-10 20:10:22 +08:00
parent f7188bed05
commit 39120b985f
+15 -3
View File
@@ -262,16 +262,28 @@ cp -a MinerU2___5-Pro-2604-1___2B MinerU2.5-Pro-2604-1.2B
```bash
MINERU_CMD=/srv/plantai/mineru-cpu/bin/mineru
MINERU_DEVICE_MODE=cpu
METHODOLOGY_MINERU_DEVICE_MODE=cpu # r3:显式设备开关(关键,见生效时序)
MINERU_MODEL_SOURCE=local
MINERU_TOOLS_CONFIG_JSON=/home/xzq/mineru.json
METHODOLOGY_MINERU_GPU_PREFLIGHT=0
METHODOLOGY_MINERU_RUNTIME_MODE=single
V15_MINERU_BACKEND=pipeline
# LLM 方法学提取阶段(r3,2026-09-10;两个 env 都加):
PLANTAI_GF_PYTHON_ENV=/srv/plantai/install/venv
DEEPSEEK_API_KEY=<与 sdk/.env DOCGEN_LLM_API_KEY 同款>
DEEPSEEK_BASE_URL=https://api.deepseek.com
DEEPSEEK_MODEL=deepseek-v4-flash
BBAV5_CAPABILITY_CATALOG=<部署根>/data/bbav5_capability_catalog.json
```
> **生效时序**:当前 methodology 代码已支持 `MINERU_CMD`/`METHODOLOGY_MINERU_GPU_PREFLIGHT`/`METHODOLOGY_MINERU_RUNTIME_MODE`/`V15_MINERU_BACKEND`,
> 但还不显式传 `MINERU_DEVICE_MODE` 与 `MINERU_MODEL_SOURCE`/`MINERU_TOOLS_CONFIG_JSON`(修复中会加)。因此今天先以冒烟脚本 env 方式验证;
> prod.env 的键先加上,待代码修复后随 install 包重发布时生效。175 GPU 机不设这些 env,行为不变(get_device() 自动探测 cuda)。
> **生效时序**:r3 修复(2026-09-10)后代码已显式注入设备模式——控制键是 `METHODOLOGY_MINERU_DEVICE_MODE`
> (设 `cpu` 时注入 `MINERU_DEVICE_MODE=cpu` 并清空 CUDA_VISIBLE_DEVICES;不设则自动探测,175 GPU 机行为不变)。
> 176 实测三个必须:①`MINERU_DEVICE_MODE` 直读键**不够**(被 build_mineru_runtime 忽略),必须加 `METHODOLOGY_MINERU_DEVICE_MODE=cpu`;
> ②extraction 主上游是 **legacy-rag 8093**(BFF 8000 不存在时回落 8093),methodology 与 legacy-rag 两个 prod.env 都要加;
> ③LLM 阶段另需(batch 脚本 2026-09-10 已随包补入 install/*/scripts/run_methodology_batch.py):
> `PLANTAI_GF_PYTHON_ENV=<目标机 venv>`(GF python 路径,默认是 175 路径必炸)、`DEEPSEEK_API_KEY`/`DEEPSEEK_BASE_URL`/`DEEPSEEK_MODEL`、
> `BBAV5_CAPABILITY_CATALOG=<目标机 catalog 路径>`(catalog 36K 数据文件随部署 rsync 到部署根 data/)。
> 176 全链实测:MinerU CPU 解析 22 页 ~67s → LLM 方法学提取 → completed 100%。
**CPU 冒烟(关键验收,176 实测通过)**: