附图报价系统设计分析8
面向互联网用户的完整使用教程，涵盖 PDF 版和 PDF+STEP 版两个版本。
📌 版本说明
| 版本 | 安装包大小 | 核心能力 | 下载地址 |
|---|---|---|---|
| PDF版 | 3.1 GB | OCR识别PDF图纸 → 特征提取 → 工艺规划 → 报价生成 | 点击下载 |
| PDF+STEP版 | 144 MB | 支持3D模型(STEP/STL)预览 + PDF图纸解析 + 特征识别报价 | 点击下载 |
打包后到别的电脑上测试失败，依赖安装存在故障。待近期完善。
腾讯元器在线体验：点击进入
💡如何选择？只需处理PDF图纸选PDF版；需要处理3D模型文件选PDF+STEP版。
📖 目录
- PDF版操作指南
- 启动方式
- 核心操作流程
- AI定价功能
- 界面布局
- 使用技巧
- PDF+STEP版操作指南
- 快速开始
- 加载3D模型
- 加载PDF图纸
- 特征识别与报价
- 导出结果
- 测试场景
- 高级功能
- 常见问题 FAQ
PDF版操作指南
启动方式
推荐：打包版（无需Python环境）
- 解压
QuoteAppPDF版.zip - 打开
QuoteApp/目录 - 双击运行
QuoteApp.exe
✅ 无需安装Python，直接可用。
核心操作流程
第一步：打开PDF图纸
- 点击工具栏“打开PDF”按钮
- 选择零件图纸的 PDF 文件
- 图纸会显示在左侧预览区域
第二步：OCR识别
- 确认 PDF 已加载
- 点击“OCR识别”按钮
- 等待识别完成（首次运行较慢，需加载模型）
- 识别结果显示在右侧
⚠️ 首次运行需要网络连接以下载 OCR 模型，请耐心等待。
第三步：特征提取
- OCR识别完成后
- 点击“特征提取”按钮
- 系统自动从识别结果中提取零件信息：
- 材料（如 45#、Q235）
- 尺寸（长、宽、高、直径）
- 形状（圆形、方形、异形）
第四步：规划工艺路线
- 特征提取完成后
- 点击“规划工艺”按钮
- 系统自动匹配工艺规则，生成加工路线
第五步：生成报价单
- 在表单中填写：
- 客户信息
- 零件数量
- 其他必要信息
- 点击“生成报价单”按钮
- 选择输出格式（Word / Excel / PDF）
- 保存报价单
AI定价功能
如何使用AI定价
- 勾选表单上方的“使用AI模型”复选框
- 点击“AI定价”按钮
- 系统弹出 AI 定价分析对话框，显示：
- 规则价（工艺路线计算）
- AI预测价（XGBoost 模型）
- 加工难度系数
- 对比分析差异
对话框操作说明
| 按钮 | 功能 |
|---|---|
| 开始AI定价 | 执行AI预测 |
| 采用AI定价 | 使用AI预测价作为最终报价 |
| 人工复核 | 当AI价与规则价差异过大时建议使用 |
| 关闭 | 取消AI定价 |
置信度说明
| 置信度 | 标识 | 建议 |
|---|---|---|
| ≥ 90% | 🟢 高 | 可直接参考 |
| 80%–90% | 🟡 中 | 建议与规则价对比 |
| < 80% | 🔴 低 | 建议以规则价为准 |
界面布局
┌─────────────────────────────────────────────────────────────┐ │ 文件(F) 工具(T) 定额管理(M) 数据管理(D) 帮助(H) │ ├─────────────────────────────────────────────────────────────┤ │ [打开PDF] [OCR识别] [特征提取] [规划工艺] [生成报价单] │ │ [使用AI模型] □ [AI定价] │ ├─────────────────────────────────────────────────────────────┤ │ ┌─────────────────────┐ ┌───────────────────────────────┐ │ │ │ │ │ 零件信息表单 │ │ │ │ PDF预览区域 │ │ - 材料、尺寸、形状 │ │ │ │ (支持缩放、翻页) │ │ - 客户信息 │ │ │ │ │ │ - 批量数量 │ │ │ └─────────────────────┘ └───────────────────────────────┘ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 工艺路线列表（自动匹配的加工工序） │ │ │ └─────────────────────────────────────────────────────────┘ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 费用明细（材料成本、加工成本、管理费用、最终报价） │ │ │ └─────────────────────────────────────────────────────────┘ │ │ 状态栏：显示当前状态、AI预测价、置信度 │ └─────────────────────────────────────────────────────────────┘使用技巧
- 批量处理：在表单中修改"批量数量"，报价单会自动计算总价
- 图纸缩放：使用工具栏的"放大"、“缩小”、"整页显示"按钮
- 工艺路线编辑：双击工艺路线列表中的工序可进行编辑
- 费用明细：查看各项成本构成，了解报价详情
- AI对比：同时使用规则价和AI价，对比分析后再确定最终报价
输出文件说明
| 文件类型 | 说明 |
|---|---|
| 报价单 | Word(.docx)、Excel(.xlsx)、PDF 格式 |
| 日志文件 | QuoteApp.log（程序运行日志） |
| 配置文件 | data/quote_config.json（报价配置） |
| 数据库 | data/quota.db（定额数据） |
PDF+STEP版操作指南
快速开始
启动程序
双击解压后的QuoteApp.exe即可启动，无需安装。
主界面说明
┌─────────────────────────────────────────────────┐ │ QuoteApp 附图报价助手 [菜单] [设置] │ ├─────────────────────────────────────────────────┤ │ [加载 STEP] [加载 PDF] [导出 Excel] [导出 Word] │ ├──────────────────┬──────────────────────────────┤ │ │ │ │ 3D 预览区 │ 报价信息区 │ │ (OpenGL 硬件 │ - 尺寸标注 │ │ 或软件渲染) │ - 特征识别 │ │ │ - 价格计算 │ │ │ │ ├──────────────────┴──────────────────────────────┤ │ 状态栏：显示加载进度、渲染模式、错误信息 │ └─────────────────────────────────────────────────┘加载3D模型
支持格式
.step/.stp（推荐）.stl.obj
操作步骤
- 点击[加载 STEP]按钮
- 选择对应文件
- 等待加载完成（有进度条显示）
- 3D 预览区会自动显示模型
鼠标操作技巧
| 操作 | 方法 |
|---|---|
| 旋转模型 | 鼠标左键拖拽 |
| 平移模型 | 鼠标右键拖拽 |
| 缩放模型 | 鼠标滚轮 |
| 重置视角 | 双击模型 |
显示模式切换
- 面渲染：显示实体模型（默认）
- 边线显示：显示模型线框（需 OpenGL 硬件渲染）
- 透明模式：半透明显示，可检查内部结构
加载PDF图纸
操作步骤
- 点击[加载 PDF]按钮
- 选择 PDF 文件
- 程序自动解析，解析层级如下：
| 解析层级 | 方法 | 适用场景 |
|---|---|---|
| Level 1 | PyMuPDF 矢量解析 | 矢量PDF，提取尺寸标注 |
| Level 2 | PaddleOCR 扫描识别 | 扫描版PDF（备选） |
| Level 3 | pdfplumber 文本提取 | 文本型PDF（兜底） |
⚠️ PDF 解析准确率约 70–85%，复杂图纸建议人工核对关键尺寸。
特征识别与报价
自动识别内容
加载 STEP 文件后，程序自动识别：
- 孔特征：直径、深度
- 槽特征：宽度、长度
- 平面区域：面积计算
查看与调整
在报价信息区查看：
- 尺寸列表→ 自动提取的几何尺寸
- 加工特征→ 识别的特征类型
- 预估价格→ 基于 XGBoost 模型计算
可手动调整：
- 修改材料类型
- 调整加工精度
- 添加备注
导出结果
导出 Excel
- 点击[导出 Excel]
- 选择保存位置
- 生成文件包含：
- 尺寸明细表
- 特征列表
- 价格明细
导出 Word
- 点击[导出 Word]
- 自动生成报价单文档
测试场景
基础功能测试
| 测试项 | 操作步骤 | 预期结果 |
|---|---|---|
| 启动程序 | 双击QuoteApp.exe | 主窗口正常显示，无报错 |
| 加载 STEP | 点击[加载 STEP] → 选择文件 | 3D 预览区显示模型 |
| 旋转模型 | 鼠标左键拖拽 | 模型平滑旋转 |
| 缩放模型 | 鼠标滚轮 | 模型放大/缩小 |
| 加载 PDF | 点击[加载 PDF] → 选择文件 | 解析结果显示在报价区 |
3D渲染测试
| 测试项 | 操作步骤 | 预期结果 |
|---|---|---|
| 面渲染 | 加载STEP文件，观察模型 | 模型表面平滑，无破碎面 |
| 边线显示 | 勾选"显示边线" | 模型边缘显示黑色线条 |
| 透明模式 | 选择"透明模式" | 模型半透明，可看到内部结构 |
| 渲染模式 | 查看控制台输出 | opengl33=硬件渲染；software=软件渲染 |
高级功能
批量处理
- 准备包含多个 STEP/PDF 文件的文件夹
- 点击[批量处理]
- 选择文件夹
- 程序自动处理并生成汇总报告
自定义加工单价
- 进入[设置]→[加工单价配置]
- 修改各类特征的单位价格
- 保存配置（自动加载到下次启动）
AI模型验证（可选）
前置条件：安装
llama-cpp-python并下载 GGUF 模型
- 点击[AI 验证]
- 程序调用本地 Gemma 模型验证报价合理性
- 查看验证报告
常见问题 FAQ
PDF版常见问题
Q：OCR识别失败？
- 确保 PDF 文件清晰可读
- 首次运行需等待模型下载（需要网络）
- 检查网络连接
Q：AI模型未加载？
- 系统会自动训练模型
- 确保
models/和models_by_material/目录存在 - 首次勾选"使用AI模型"会自动训练
Q：特征提取结果为空？
- 检查 OCR 识别结果是否包含有效信息
- 尝试手动输入特征参数
- 确保图纸包含零件信息
Q：生成报价单失败？
- 检查是否已完成工艺规划
- 确保客户信息填写完整
- 检查输出目录权限
PDF+STEP版常见问题
Q：3D模型显示为紫色/黑色？
原因：OpenGL 着色器编译失败
解决：
- 检查显卡驱动是否最新
- 查看控制台错误信息
- 程序会自动降级到软件渲染（功能正常，性能较低）
Q：边线显示功能不可用？
原因：OpenGL 硬件渲染未启用
解决：
- 确认显卡支持 OpenGL 3.3+
- 更新显卡驱动
- 如无法解决，使用面渲染模式（边线功能可选）
Q：STEP文件加载失败？
原因：
trimesh或cascadio库缺失- STEP 文件版本不支持
解决：
- 安装依赖：
pip install trimesh cascadio - 用 CAD 软件将 STEP 另存为 STL 格式
- 查看
preview_engine日志定位具体错误
Q：PDF解析结果不准确？
原因：OCR 识别准确率限制
解决：
- 确保 PDF 清晰度足够（建议 300 DPI+）
- 手动核对关键尺寸
- 使用 Level 2（PaddleOCR）重新解析
Q：程序启动报错VCRUNTIME140.dll 缺失？
原因：目标电脑缺少 VC++ 运行库
解决：
- 下载安装 Visual C++ Redistributable：https://learn.microsoft.com/zh-cn/cpp/windows/latest-supported-vc-redist
- 或确保打包时
MSVCP140.dll已包含在dist\QuoteApp\_internal\中
📞 需要帮助？
如遇到本文档未覆盖的问题，请提供以下信息联系支持：
- 软件版本（PDF版 / PDF+STEP版）
- 操作步骤
- 错误截图或日志（
QuoteApp.log）