部署指南新增扒图运行环境专章:CAD 依赖链(node/dist/WebView2)与 PDF 依赖链(pdfium/五 OCR 引擎)的缺失表现与离线补齐方法;OCR 网络需求选型表(离线环境唯一可用=Umi-OCR 本地);Umi-OCR 两条获取路;WebView2 离线安装要点;开发机调试路径对照

部署打包指南.md

@@ -61,9 +61,60 @@ Copy-Item "$src\cadbt\CAD-Viewer\dist" cadbt\cadbt\CAD-Viewer\packages\cad-viewe
 Copy-Item "$src\ai助手\zcode"      ai助手\zcode -Recurse
 ```
 
-> 老开发机仍在用时，也可以直接从老机器整目录拷贝上述内容（等价）。
+> 老开发机仍在用时，也可以直接老机器整目录拷贝上述内容（等价）。
 > `tools\MicrosoftEdgeWebview2Setup.exe` 在 git 里，无需另备。
 
+## 三·五、CAD 扒图 / PDF 扒图 运行环境与缺失文件补齐
+
+### CAD 扒图依赖链（缺一样就打不开图纸/服务起不来）
+
+| 依赖 | 位置（安装机） | 缺失表现 | 无互联网时怎么补 |
+|---|---|---|---|
+| **node.exe** | `{app}\cadbt\node\node.exe` | CAD 网页服务（端口 5173）起不来，提示"无法连接网页 CAD 服务" | 从任一装好软件的机器拷 `cadbt\node\` 整目录（node 是绿色单文件，拷贝即用） |
+| **CAD-Viewer 网页引擎 dist** | `{app}\cadbt\CAD-Viewer\dist\`（index.html/assets/server.cjs/**fonts 中文字体库**/templates） | 图纸打开文字乱码/缺字（fonts 缺）、服务 404 | 从装好的机器拷 `cadbt\CAD-Viewer\dist\` 整目录 |
+| **WebView2 运行时** | 系统级（随 Edge 分发） | 所有内嵌网页窗口全黑/空白 | 见下方"WebView2 离线安装" |
+| 蒙版数据 | `{app}\cadbt\扒图蒙版\` | 无（运行时自建） | 不需要 |
+
+### PDF 扒图依赖链
+
+| 依赖 | 位置 | 缺失表现 | 无互联网时怎么补 |
+|---|---|---|---|
+| **pdfium.dll**（x86 渲染引擎） | `{app}\pdfium.dll`（安装包必带，lib\ 也有副本） | PDF 打不开 | 安装包自带；开发机从 `lib\pdfium.dll` 复制到 bin\Debug |
+| **OCR 引擎（五选一）** | 见下表 | 扒不出文字 | 见下表 |
+
+### OCR 引擎的网络需求（离线环境选型）
+
+| 引擎 | 需要互联网 | 离线环境可用 | 离线补齐方式 |
+|---|---|---|---|
+| 百度 OCR（默认） | ✅ 需联网调 API | ❌ | — |
+| 智谱 GLM-OCR | ✅ | ❌ | — |
+| 百度千帆 PaddleOCR-VL | ✅ | ❌ | — |
+| UApiPro | ✅ | ❌ | — |
+| **Umi-OCR 本地** | ❌ **完全离线免费** | ✅ **离线环境唯一选择** | 见下 |
+
+### Umi-OCR 本体获取（两条路）
+
+1. **软件内下载（有网）**：PDF 扒图 → OCR 设置 → 选 Umi-OCR 引擎 → "下载 OCR 本体"（从用户网盘直链下载 ~179MB zip，自动解压安装到 exe 旁 `Umi-OCR\`）。
+2. **离线拷贝（无网）**：从任一已装 Umi-OCR 本体的机器，把 `Umi-OCR\` 整目录拷到软件根目录（与 exe 同级）。它是绿色软件，拷完即用，无需安装。
+
+### WebView2 离线安装（内网装机重点）
+
+安装包对缺 WebView2 的机器会自动跑 `MicrosoftEdgeWebview2Setup.exe` 静默补装——**但该引导程序需联网从微软 CDN 下载**。完全离线的内网装机：
+
+1. 提前在有网的机器下载 WebView2 **离线完整安装包**（微软官网 Standalone Installer，x86 版，与软件 32 位一致）；
+2. 装软件前先手动装它（或放进装机 U 盘/共享目录）；
+3. 判断机器是否已有：控制面板→程序里找"Microsoft Edge WebView2 运行时"，或看注册表 `HKLM\SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}`。Win10/11 装过 Edge 浏览器的一般已自带。
+
+### 开发机调试的对应路径（clone 后调试扒图功能）
+
+| 资源 | 开发机应放位置 | 来源 |
+|---|---|---|
+| node.exe | `cadbt\cadbt\bin\Debug\node\node.exe` | 安装目录 `cadbt\node\`（即第三节 3b） |
+| dist 网页引擎 | `cadbt\cadbt\CAD-Viewer\packages\cad-viewer-example\dist\` | 安装目录 `cadbt\CAD-Viewer\dist\`（即第三节 3b） |
+| pdfium.dll | `成套报价软件\bin\Debug\pdfium.dll` | `成套报价软件\lib\pdfium.dll` 复制 |
+| Umi-OCR 本体 | `成套报价软件\bin\Debug\Umi-OCR\` | 按上表离线拷贝方式 |
+
+
 ## 四、验证环境就绪（编译+组装各跑一遍）
 
 ```powershell