diff --git a/docs/DEPLOY_FLOW.md b/docs/DEPLOY_FLOW.md index 8b33336..26d7701 100644 --- a/docs/DEPLOY_FLOW.md +++ b/docs/DEPLOY_FLOW.md @@ -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 实测通过)**: