From aadab922a908978eed7cecda37c221bfd95a2124 Mon Sep 17 00:00:00 2001 From: xsl Date: Sun, 6 Sep 2026 23:27:12 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E7=BD=91=E5=85=B3=E5=BE=85=E6=94=B9?= =?UTF-8?q?=E5=8A=A8=C2=A79):=20=E8=A1=A5=E6=97=A0GUI=E6=9C=8D=E5=8A=A1?= =?UTF-8?q?=E5=99=A8=E7=B3=BB=E7=BB=9F=E5=BA=93=E4=BE=9D=E8=B5=96=20+=20to?= =?UTF-8?q?rch=20CPU=E6=BA=90=E5=AE=89=E8=A3=85=E8=AF=B4=E6=98=8E=20+=20?= =?UTF-8?q?=E6=97=A0GPU=E5=AE=9E=E6=B5=8B=E7=BB=93=E8=AE=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/网关待改动.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/docs/网关待改动.md b/docs/网关待改动.md index 78f2b02..eee02c5 100644 --- a/docs/网关待改动.md +++ b/docs/网关待改动.md @@ -185,20 +185,28 @@ worker 侧已上线 4 条路由，**网关尚无对应转发路由**（当前仅 ### 网关机部署前检查 1. **Python 3.10~3.12**（mediapipe 0.10.14 无 3.13 wheel）。 -2. **安装依赖**（网关 venv，国内镜像）： +2. **系统库**（无 GUI 服务器跑 opencv/mediapipe 必需，已装可跳过）： + +```bash +sudo apt install -y libgl1 libglib2.0-0 libegl1 +``` + +3. **安装依赖**（网关 venv，国内镜像）： ```bash pip install -i https://pypi.tuna.tsinghua.edu.cn/simple \ mediapipe==0.10.14 opencv-python==4.10.0.84 numpy==1.26.4 # 可选：BiSeNet 头发分割（发际线 5 点需要）。CPU 版 torch 仅 ~200MB： -pip install -i https://pypi.tuna.tsinghua.edu.cn/simple \ - torch==2.2.2 torchvision==0.17.2 --index-url https://download.pytorch.org/whl/cpu +pip install torch==2.2.2 torchvision==0.17.2 --index-url https://download.pytorch.org/whl/cpu # 不装 torch 也能跑：60 个关键点正常返回，发际线 5 点为 null（hairline_source="unavailable"） +# ⚠️ 网关无 GPU——务必用上面的 CPU 专用源装 torch；装默认 PyPI 版会带 2.5G 的 CUDA 包，浪费但也能跑（自动回退 CPU） ``` -3. **权重已入 git**，`git clone/pull` 自动到位：`face_analysis/weights/79999_iter.pth`（51MB）。 +4. **权重已入 git**，`git clone/pull` 自动到位：`face_analysis/weights/79999_iter.pth`（51MB）。 无需手动下载任何模型文件。 +5. **无 GPU 已实测**：`CUDA_VISIBLE_DEVICES=""` 模拟验证通过（70/70 点，与 GPU 结果一致）； + CPU 推理 16 核 0.18s/次，网关机核少时约 0.5~2s/次，低频可接受。 ### 部署与冒烟