From 772a98fc9991078c32d9d67813b5b6cf808c0008 Mon Sep 17 00:00:00 2001 From: dqb-dev Date: Fri, 2 Oct 2026 09:25:54 +0800 Subject: [PATCH] =?UTF-8?q?=E9=83=A8=E7=BD=B2=E6=8C=87=E5=8D=97=E6=96=B0?= =?UTF-8?q?=E5=A2=9E=E6=89=92=E5=9B=BE=E8=BF=90=E8=A1=8C=E7=8E=AF=E5=A2=83?= =?UTF-8?q?=E4=B8=93=E7=AB=A0:CAD=20=E4=BE=9D=E8=B5=96=E9=93=BE(node/dist/?= =?UTF-8?q?WebView2)=E4=B8=8E=20PDF=20=E4=BE=9D=E8=B5=96=E9=93=BE(pdfium/?= =?UTF-8?q?=E4=BA=94=20OCR=20=E5=BC=95=E6=93=8E)=E7=9A=84=E7=BC=BA?= =?UTF-8?q?=E5=A4=B1=E8=A1=A8=E7=8E=B0=E4=B8=8E=E7=A6=BB=E7=BA=BF=E8=A1=A5?= =?UTF-8?q?=E9=BD=90=E6=96=B9=E6=B3=95;OCR=20=E7=BD=91=E7=BB=9C=E9=9C=80?= =?UTF-8?q?=E6=B1=82=E9=80=89=E5=9E=8B=E8=A1=A8(=E7=A6=BB=E7=BA=BF?= =?UTF-8?q?=E7=8E=AF=E5=A2=83=E5=94=AF=E4=B8=80=E5=8F=AF=E7=94=A8=3DUmi-OC?= =?UTF-8?q?R=20=E6=9C=AC=E5=9C=B0);Umi-OCR=20=E4=B8=A4=E6=9D=A1=E8=8E=B7?= =?UTF-8?q?=E5=8F=96=E8=B7=AF;WebView2=20=E7=A6=BB=E7=BA=BF=E5=AE=89?= =?UTF-8?q?=E8=A3=85=E8=A6=81=E7=82=B9;=E5=BC=80=E5=8F=91=E6=9C=BA?= =?UTF-8?q?=E8=B0=83=E8=AF=95=E8=B7=AF=E5=BE=84=E5=AF=B9=E7=85=A7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 部署打包指南.md | 53 ++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 52 insertions(+), 1 deletion(-) diff --git a/部署打包指南.md b/部署打包指南.md index eaac3f9..7a07c8e 100644 --- a/部署打包指南.md +++ b/部署打包指南.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