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