TuMo Vision AI 帮助教程

这份帮助适合谁看

本帮助面向第一次使用 TuMo Vision AI 的检验员、工艺人员、质量工程师、模型维护人员和管理员。

你可以把软件理解成一条完整流程：导入图纸，检测尺寸框，AI 识别尺寸文本，人工复核，生成气泡标注，再导出 Excel、PDF、图片或品检报告。

如果你只想快速完成一次图纸识别，请先看“标准工作流程”。如果你要配置报告模板，请直接看“检验报告模板配置”和“AI 帮我配置模板”。如果你要调整模型、OCR、GPU 或导出路径，请看“设置页面”。

界面速览

下图是打开示例图纸、完成检测和 AI 识别后的主界面。后续章节会分别放大说明每个区域。

日常操作顺序通常是：在顶部功能区导入图纸并执行检测 → 在左侧选择页面 → 在中间画布检查检测框和气泡 → 在右侧结果表核对识别值 → 最后从顶部导出。

提示： 本帮助中的截图基于 v3.2.0。不同版本的按钮位置或名称可能略有差异，以实际界面为准。

标准工作流程

1. 打开软件后，进入左侧导航栏的“主页”。
2. 点击顶部功能区“导入”，选择 PDF、图片或包含图纸的文件夹。
3. 在左侧“图纸列表”中选择要处理的页面。
4. 在顶部“检测识别”区域选择检测模型和置信度阈值。
5. 点击“检测当前页”识别尺寸框，或点击“检测全部”处理所有页面。
6. 检查画布上的检测框、右侧结果表格和气泡编号。
7. 点击“AI识别”识别检测框中的尺寸文字、公差、符号。
8. 对无法识别或识别错误的项目进行人工修正。
9. 需要时点击“疑似漏检”查找可能遗漏的尺寸标注。
10. 确认结果后，使用“导出 Excel”“导出 PDF”“导出图片”“导出品检报告”等按钮输出文件。

建议先处理一页并确认识别效果，再批量处理整份图纸。这样可以提前发现模型、OCR 模型、置信度和模板配置是否合适。

主窗口标题栏

• 左上角显示软件名称和当前工作台信息。
• “账号”头像按钮用于打开账号面板。未登录时可以登录或注册；已登录时可以查看账号、订阅、额度和退出登录。
• “订阅”按钮用于打开会员订阅窗口。AI 识别、云端模型、部分额度统计会依赖账号状态。
• “设置”齿轮按钮用于进入设置页面。
• “帮助教程”按钮用于打开当前帮助窗口。
• “最小化”按钮会把窗口收起到任务栏，不会关闭项目。
• “最大化/还原”按钮用于切换窗口大小。
• “关闭”按钮会退出程序。若当前项目有未保存修改，软件会提示是否保存。
• 顶部公告条出现时表示后端、订阅、版本或系统状态有重要提示，点击可查看详情。

账号换电脑登录限制（4 小时冷却）

同一个账号在不同电脑之间切换登录，需要距离上一台电脑最后一次实际使用满 4 小时，否则登录会被拒绝。

• 登录时如果还在冷却期内，软件会弹窗告诉您：账号当前绑定在哪一台电脑、那台电脑的最后使用时间、还需要等待多久（以及可登录的具体时间）。
• 限制原因：本软件按云端 OCR 用量计费，同一个账号被多人、多台电脑轮流登录使用会让 OCR 成本成倍上升，所以做了换机间隔限制。
• 如果确实需要多台电脑、多人同时使用，建议再购买一个账号。
• 同一台电脑重新登录、以及从未在该账号上使用过的新账号，都不受限制。
• 在另一台电脑上"退出登录"也不会立刻解锁：冷却时间从那台电脑最后一次使用（或退出）开始计算。
• 确实有特殊情况需要立刻换机时，可以联系管理员在后台"解除换机锁定"。

左侧导航栏

• “主页”是图纸检测、OCR 识别、标注编辑和导出的主要工作区。
• “模型训练”用于管理训练数据集、生成训练脚本、导入自定义检测模型，也可以打开批量处理工具和 PaddleOCR 训练工具。
• “模型市场”用于刷新、搜索、查看、下载、启用、上传、编辑和删除共享模型。
• “历史记录”用于打开最近处理过的项目、置顶常用项目、删除历史记录。
• “设置”用于调整语言、外观、检测、框样式、气泡样式、OCR、Token 统计和导出配置。
• “关于”用于查看软件版本、版权、运行环境等信息。
• 左侧导航栏顶部的折叠按钮可以收起或展开导航栏。收起后只显示图标，适合小屏幕操作。

主页功能区总览

主页顶部是一条常用工具栏，按钮按工作阶段分成若干组；窗口较窄时，部分按钮会收进组右侧的下拉菜单。

• “文件”组放置新建、导入、导入文件夹、保存、另存为等高频按钮。
• “检测”组用于执行检测、切片实验、手动标注和清空检测框。
• “导出”组用于导出气泡图、Excel、PDF、图片等结果。
• “报告交付”组用于品检报告、批量打印和打包导出。
• “样本”组用于把当前检测结果保存为训练样本。
• 右侧“模型 / 公差标准”用于切换检测模型、设置公差标准和对比模型。
• “版本对比”用于管理图纸版本。

如果找不到某个按钮，先确认当前是否在“主页”，以及是否已经导入图纸、是否正在处理任务。部分按钮会在没有导入文件、正在处理、未登录或没有检测结果时自动禁用。

文件和项目按钮

• “导入”用于导入 PDF、PNG、JPG、JPEG、BMP 等图纸文件。导入 PDF 时会按页生成图纸页面。
• “导入文件夹”用于批量导入一个文件夹中的 PDF 或图片。软件会扫描可支持的文件格式。
• “保存项目”用于保存当前图纸、检测框、OCR 结果、气泡编号和人工修改。建议完成一个阶段后及时保存。
• “另存项目”用于把当前项目保存为新的项目文件，适合保留不同版本。
• “打开项目”用于重新打开之前保存的项目。
• “撤销”用于撤回上一步编辑操作，例如移动检测框、删除检测框、修改结果等。
• “重做”用于恢复刚撤销的操作。
• “清空列表”用于删除当前导入的全部图纸页面。此操作会清空当前工作区，执行前请确认是否已经保存项目。

快捷键：Ctrl+O 导入，Ctrl+S 保存，Ctrl+Z 撤销，Ctrl+Y 重做。

图纸列表和页面操作

左侧“图纸列表”显示已导入的所有页面。

• 每一项会显示文件名、页码和检测结果数量。
• 点击某一页会在中间画布显示该页图纸。
• 页面右侧的删除按钮用于删除单页。
• 右键页面可使用“检测此页”“导出此页”“删除页面”等操作。
• PDF 多页导入后，每一页都会作为独立页面处理。
• 如果页面很多，建议先处理少量典型页面，再使用“检测全部”。

删除页面不会删除原始 PDF 或图片文件，只会从当前项目中移除该页面。

图纸画布操作

中间区域是图纸画布，用于查看原图、检测框、气泡、编号和连线。

• 鼠标滚轮通常用于缩放图纸。
• 按住鼠标拖动可以平移视图。
• 点击检测框可以选中对应结果。
• 选中检测框后，右侧结果表格会同步选中该项。
• 右键空白区域可以打开画布菜单。
• 右键检测框可以编辑、删除、复制识别值。
• 拖拽框线或控制点可以调整检测框位置和大小。
• 框选多个检测框后，可以进行批量删除或取消选择。

底部坐标显示当前鼠标在图纸中的位置，便于定位异常区域。

画布右键菜单

• “放大”用于放大当前视图。
• “缩小”用于缩小当前视图。
• “适应窗口”会把图纸缩放到完整可见。
• “实际大小”会恢复到 100% 缩放。
• “手动添加标注”用于在没有自动检测到的位置手动创建检测框。

当自动检测漏掉尺寸时，可以使用“手动添加标注”，再对该标注运行 OCR 或手工填写识别值。

检测模型和置信度

• “模型”下拉框用于选择当前检测模型。内置模型适合通用工程图，自定义模型适合特定行业或特定图纸风格。
• “置信度”表示检测框的最低可信程度。数值越高，误检越少，但漏检可能变多；数值越低，检出更多，但误检可能增加。
• “-”按钮每次降低 0.05 置信度。
• “+”按钮每次提高 0.05 置信度。
• 当前置信度数值会显示在按钮旁边。

建议：如果漏检多，适当降低置信度；如果误检多，适当提高置信度。常用范围是 0.20 到 0.50，具体取决于图纸清晰度和模型质量。

检测按钮

• “检测当前页”只处理当前选中的图纸页面。适合调试参数和复核单页。
• “检测全部”会处理所有已导入页面。适合参数确认后的批量处理。
• “疑似漏检”会基于当前图纸继续扫描可能遗漏的尺寸区域，适合自动检测结果明显少于预期时使用。
• 检测过程中按钮会变成不可用，避免重复启动任务。
• 如果检测模型未初始化，检查模型文件是否存在，或到“模型训练”“设置-检测”中重新选择模型和推理设备。

检测只负责找出图纸上的尺寸文本区域，不等于已经识别出尺寸文字。文字内容需要再执行 AI 识别或手动编辑。

OCR 和 AI 识别按钮

• “AI识别”会把当前页检测框裁剪后发送给 OCR/AI 服务，返回尺寸文字、公差和符号结果。
• “OCR复核”会重新处理上一轮无法识别或疑似错误的项目，通常会尝试其他方向或更严格的识别流程。
• “自动OCR识别”开关打开后，点击“检测当前页”并完成检测后，会自动运行一次 AI 识别。
• “OCR模型”下拉框用于选择当前使用的 OCR 模型。不同模型在尺寸、符号、公差、粗糙度等场景上效果可能不同。
• OCR 识别需要登录账号。未登录时点击会提示先登录。
• OCR 识别可能消耗 Token 或额度，批量识别前请确认账号状态和剩余额度。

如果识别失败，先检查是否已经登录、网络是否正常、后端服务是否启动、OCR 模型是否配置正确。

结果表格

右侧“检测结果”表格显示当前页所有检测项。

• “编号”列显示气泡编号。
• “图片”列显示检测框裁剪图。点击图片可以旋转 90 度并重新识别，适合竖排文字或方向错误的项目。
• “检测项目”列显示尺寸文字或原始 OCR 文本。
• “主尺寸”列显示 AI 返回的主尺寸数值，用于套用未注公差标准。
• “上公差”列显示上偏差、上公差或正公差。
• “下公差”列显示下偏差、下公差或负公差。
• 双击单元格可以编辑内容。
• 选中行会同步高亮画布中的检测框。
• 有 OCR 错误或警告的行会以不同底色提示。
• 被忽略的检测项会降低透明度，导出时通常不会作为有效结果处理。

建议导出前逐行检查异常底色、空识别值、明显错误符号和上下公差是否对应正确。

选中项区域

“选中项”区域显示当前选中检测结果的关键信息。

• 左侧显示当前识别值。
• 中间显示置信度。
• 右侧显示复核状态，例如未选择、正常、无法识别、已复核等。

如果用户不确定当前编辑的是哪一项，可以先点击画布检测框或结果表格行，再查看“选中项”区域确认。

符号按钮

右侧“符号”区域用于快速插入工程图常用符号。

• “Φ”“Ø”“⌀”表示直径符号。
• “R”表示半径。
• “SR”表示球半径。
• “C”表示倒角。
• “M”表示最大实体条件或相关标记。
• “×”表示乘号。
• “±”表示正负公差。
• “°”“′”“″”分别表示角度、分、秒。
• “Ra”“Rz”表示粗糙度。
• “⌴”“⌵”“↧”表示沉孔、锥孔、深度等特殊符号。
• “□”“○”“▱”“⌭”“⌒”“⌓”“∠”“⊥”“∥”“⌖”“◎”“⌯”“↗”“⌰”用于形位公差和几何特征。
• “A”“B”“C”可用于基准代号。

使用方法：先点击结果表格中要编辑的文本框或单元格，再点击符号按钮。符号会插入到当前光标位置。

检测结果右键菜单

• “定位”会把画布滚动或缩放到该检测项所在位置。
• “编辑”用于打开或进入编辑状态。
• “删除”用于删除该检测项。
• “复制识别值”只复制当前 OCR 或尺寸值。
• “复制全部信息”会复制编号、尺寸、公差、类别等完整信息。

删除检测项会影响导出结果。如果只是暂时不想导出，优先使用忽略状态或人工修正，而不是直接删除。

显示和视图开关

• “显示/隐藏检测框”控制画布上的矩形检测框是否显示。
• “显示/隐藏气泡”控制气泡圆圈是否显示。
• “显示/隐藏数字编号”控制气泡编号是否显示。
• “显示/隐藏序号路径连线”控制编号到检测框之间的连线是否显示。
• “显示/隐藏网格”会在画布上显示辅助网格，适合对齐和检查位置。
• “放大”“缩小”“适应窗口”“实际大小”用于调整图纸显示比例。

这些开关只影响屏幕显示，不会删除检测结果。导出时是否带气泡和标注取决于导出类型和相关导出设置。

公差标准

“公差标准”下拉框用于选择 AI 识别后自动填充或解释公差时参考的标准。

• 选择标准后，新识别或重新处理的数据会优先按该标准理解公差。
• “设置”按钮用于打开公差标准设置窗口。
• 如果图纸已经明确写出上下偏差，软件通常以图纸文本为准。
• 如果图纸只写尺寸、公差带或等级，公差标准可以帮助补齐或解释范围。

不同客户、行业和产品的公差规则可能不同。正式导出前请人工确认关键尺寸。

手动添加和编辑检测框

当自动检测漏掉尺寸或框选不准确时，可以手动添加或调整。

1. 在画布空白区域右键，选择“手动添加标注”。
2. 在图纸上框选需要识别的尺寸文字。
3. 选中新建检测项，在右侧表格中填写或运行 OCR。
4. 调整气泡编号和内容。
5. 保存项目，避免手动编辑丢失。

手动框越贴近文字，OCR 越容易识别；框内包含过多线条、箭头或其他文字时，识别准确率会下降。

疑似漏检处理

“疑似漏检”用于发现自动检测可能没有识别到的尺寸区域。

• 当前页没有导入图纸时无法使用。
• 检测模型未初始化时无法使用。
• 扫描结果会基于图纸图像和已有检测框判断可疑区域。
• 扫描失败时会显示错误信息，不会改变已有结果。

建议在自动检测后使用此功能，并重点复核图纸边缘、密集标注区、竖排文字、粗糙度、形位公差框等位置。

导出功能总览

导出前请确认：检测框数量合理，OCR 文本正确，气泡编号连续，公差上下限没有反，忽略项已经处理。

• “导出 Excel”输出结构化检测结果，适合后续统计、检验记录或人工整理。
• “导出 PDF”输出带气泡标注的 PDF，适合归档和给客户确认。
• “导出图片”输出当前页或全部页面的标注图片。
• “导出品检报告”会根据检验报告模板配置，把检测结果写入客户 Excel 模板。
• “导出数据集”用于模型训练，不是正式报告输出。

如果导出提示没有数据，通常表示还没有检测结果，或当前页结果为空，或所有项目都被忽略。

检验报告模板配置入口

在“设置-导出”页面可以看到“检验报告模板”卡片。

• “配置模板”按钮会打开“检验模板配置”窗口。
• 配置完成并保存后，导出品检报告会优先使用此模板配置。
• 如果没有配置模板，导出可能使用默认模板或普通表格格式。

检验模板配置只保存字段映射和写入规则，不会修改原始客户模板文件内容。真正写入数据发生在导出品检报告时。

检验模板配置窗口

“检验模板配置”窗口用于告诉软件：检测结果应该写到 Excel 模板的哪一张工作表、哪几行、哪几列。

最省事的用法（推荐给不熟悉 Excel 列号的用户）：

1. 点右上角“使用内置模板”，直接用软件自带的品检报告模板；或者点“选择 Excel 模板”选择客户模板。
2. 选好文件后软件会立刻自动识别：工作表、表头行、明细区行号、每个字段对应的列都会自动填好，绿色提示条会写清楚识别结果，例如“工作表「01」；表头第 5 行；明细区第 6-32 行；自动匹配 7 个字段列”。
3. 在右侧“模板网格预览”里核对一下，确认无误后点“保存模板配置”。

自动识别不需要登录、也不消耗额度。如果识别结果不合适，可以点“重新自动识别”，或直接在“字段列映射”的下拉框里改。这种情况下不需要理解列字母 A/B/C，也不需要自己数 Excel 行号。

窗口中的其它设置：

• “模板名称”用于给当前配置起一个易识别的名称，例如“J-01-车床检测模板”。
• “模板文件”显示当前选择的 Excel 模板路径。这里是只读的，不能直接手输。
• “工作表”用于选择要写入数据的 sheet。切换工作表后，右侧预览会刷新。
• “导出时附加气泡图工作表”打开后，导出的 Excel 中会额外包含气泡标注图或相关工作表。
• “高级设置”里是“写入方式”“明细开始行”“明细结束行”“每页最大明细数”。这些都已由自动识别填好，通常不需要修改。

行号按 Excel 的真实行号，从 1 开始。列号使用 Excel 列名，例如 A、B、C、AA。

检验模板字段列映射

字段列映射决定每个检测结果字段写入 Excel 的哪一列。每一项都是一个下拉框，选项写成“列字母 · 该列表头文字”（例如“B · 检验项目”），选“（不写入）”表示报告里不输出这一项。

• “序号”用于写入 1、2、3 等明细序号。
• “检验项目”用于写入尺寸或检验项目名称。
• “特征描述”用于写入通孔、沉头、螺纹等描述。
• “主尺寸”用于写入 AI 识别的主尺寸数值；未配置该列时不会写入。
• “上公差”“下公差”用于写入上偏差、下偏差。
• “上限值”“下限值”用于写入计算后的上下限。
• “实测值”用于写入实际检测值。若当前软件没有实测值数据，可以留空。
• “合格”“不合格”用于写入合格/不合格状态或标记。

保存前软件会弹出一份“字段 → 列”的核对清单，确认后再保存，避免列填错却没有任何提示。

如果某个字段在客户模板里不存在，选“（不写入）”即可。不要为了填满字段而把数据写入不相关列。

检验模板写入方式

“否：追加识别结果到空白行（推荐）”：适合模板明细区为空的情况。导出时软件会从明细开始行往下逐条写入检测结果。

“是：匹配模板里已有的检验项目行”：适合模板中已经列出检验项目名称的情况。导出时软件会尝试按检验项目匹配已有行，再把结果写到对应列。

选择建议：

1. 客户模板只有表头和空白行，选择“追加识别结果到空白行”。
2. 客户模板已经固定列出项目，例如“外径、内径、孔距”，选择“匹配模板已有检验项目”。
3. 如果不确定，先用复制模板做一次测试导出，确认写入位置正确后再用于正式报告。

AI 帮我配置模板

提示：打开模板后软件已经会自动识别工作表、明细区和字段列，绝大多数模板不需要再用 AI。只有自动识别结果不理想、或模板结构特别复杂时，才需要“AI帮我配置”。

“AI帮我配置”用于让 AI 根据 Excel 模板前 45 行和前 14 列的文本、合并单元格、当前字段列表，自动建议字段列映射和明细行范围。使用前需要先登录。

按钮启用条件：

1. 已经选择有效的 Excel 模板文件。
2. 模板文件存在且扩展名是 .xls 或 .xlsx。
3. 工作表已经成功读取。
4. 右侧模板网格预览已经加载出内容。
5. 当前没有正在运行的 AI 配置任务。

如果没有选择模板，按钮会禁用，不能点击。这样可以避免空模板请求导致 AI 配置失败。

点击后的流程：

1. 软件准备模板摘要。
2. 打开“AI正在配置模板”窗口。
3. 后端调用 AI 分析模板结构。
4. “思考过程”区域显示 AI 当前推理和判断过程。
5. “配置结果流”区域显示 AI 返回的结构化配置内容。
6. AI 完成后弹出“AI配置建议”窗口。
7. 用户检查建议后，点击“应用AI建议”才会写入当前配置界面。
8. 最后仍需点击“保存模板配置”，配置才会保存并用于导出。

AI 建议不会自动保存，也不会直接改原始 Excel 模板。

AI 配置进度窗口

“AI正在配置模板”窗口用于显示 AI 工作状态。

• 顶部状态文字显示当前阶段，例如准备模板摘要、发送请求、分析模板结构、生成 JSON。
• 进度条表示任务仍在运行。由于 AI 流式返回不是固定百分比，所以进度条可能是持续滚动样式。
• “思考过程”显示 AI 对工作表、表头、明细区、字段关系的分析文字。
• “配置结果流”显示 AI 输出的配置 JSON 或结果片段。
• “暂停”按钮只暂停界面滚动和显示追加，不会停止后端 AI。适合用户想停下来阅读当前内容。
• “继续”按钮会恢复显示，并把暂停期间收到的内容补上。
• “取消”按钮会取消本次 AI 配置请求。取消后不会改动当前模板配置。
• 关闭窗口时，如果任务还在运行，软件会按取消处理。
• 文本框会自动滚动到底部，方便用户看到最新输出。

如果 AI 长时间没有输出，可以点击取消后重试；也可以检查网络、登录状态、后端服务和模型配置。

AI 配置建议窗口

“AI配置建议”窗口用于让用户在应用前检查 AI 结果。

• “工作表”显示 AI 分析的 sheet 名称。
• “明细行范围”显示建议的开始行和结束行。
• “写入方式”显示建议使用追加写入还是匹配已有行。
• “每页明细数”显示建议每页最多写入多少条明细。
• “字段列映射”列出序号、检验项目、公差、结果、合格、不合格等字段对应的 Excel 列。
• “置信度”显示 AI 对本次建议的可信程度。
• “说明”会解释 AI 为什么这样判断，以及哪些字段可能缺失。
• “应用AI建议”会把合法字段写入当前配置界面。
• “取消”会关闭建议窗口，不改变当前配置。

如果置信度低于 0.65，界面会提示建议人工检查。低置信度仍允许应用，但必须仔细核对字段列和明细行。

AI 只会应用合法列名和有效行号。无法识别、越界或不存在的字段会被忽略，并在说明中提示。

检验模板保存和取消

• “保存模板配置”会保存当前模板路径、工作表、写入方式、明细行、字段列映射和附加气泡图设置。
• “取消”会关闭窗口，不保存本次修改。
• 保存后，导出品检报告会优先使用当前模板配置。
• 保存配置不等于立即导出报告，也不会修改原模板。

建议保存后立刻用少量测试数据导出一次，检查 Excel 中字段是否写到正确位置。

账号面板

点击标题栏账号区域会打开账号面板。

• 未登录时显示“登录”和“注册”按钮。
• “登录”用于输入账号密码并获取登录状态。
• “注册”用于创建新账号。
• 已登录时显示用户名、账号状态、订阅状态和剩余额度。
• “退出登录”会清除当前登录状态。退出后 AI 识别和云端功能可能无法使用。
• “个人资料”用于查看账号信息。
• “账号设置”用于进入账号相关设置。
• “会员订阅”用于打开订阅窗口。

AI 识别、模型市场上传下载、云端额度统计通常需要登录。遇到接口提示未授权时，先检查是否登录过期。

订阅窗口

订阅窗口用于选择会员方案和购买数量。

• “月度会员”适合短期项目或临时使用。
• “年度会员”适合长期高频使用，通常更划算。
• 点击月度或年度卡片可以切换选中的方案。
• “-”按钮减少购买数量。
• “+”按钮增加购买数量。
• “购买数量”显示当前购买份数。
• “合计金额”会根据方案和数量自动计算。
• “立即订阅”会提交订阅订单。
• 右上角关闭按钮会关闭窗口，不提交订单。

购买前请确认账号已经登录，并确认选择的是正确方案和数量。

设置页面总览

设置页面左侧包含多个分类，右侧显示对应设置项。

• “通用”包含语言、启动行为、自动检查更新。
• “外观”包含主题、强调色、高对比度。
• “检测”包含推理设备、GPU 状态、置信度等检测参数。
• “框样式”包含检测框颜色、线宽、透明度等显示样式。
• “气泡样式”包含气泡颜色、大小、字体、编号样式等。
• “OCR”包含本地 OCR 模型、AI OCR 模型、超时时间、预览窗口、自动复核、原始识别等。
• “Token统计”展示 OCR 请求次数、输入 Token、输出 Token、总 Token 和最近请求趋势。
• “导出”包含默认导出路径、图片质量、检验报告模板配置。

多数设置会即时保存或在失焦后保存。部分设置需要重新执行检测或重新启动软件才能完全生效。

设置-通用

• “语言”用于选择简体中文或 English。切换后界面文案会更新，部分窗口可能需要重新打开。
• “打开上次项目”开关打开后，软件启动时会尝试恢复上次使用的项目。
• “自动检查更新”开关打开后，软件启动或合适时机会检查新版本。
• “重置”按钮会恢复通用设置为默认值。

如果多人共用电脑，建议关闭“打开上次项目”，避免自动打开他人的项目文件。

设置-外观

• “主题”可选择浅色、深色或跟随系统。
• “强调色”用于设置按钮、高亮、选中状态等主色。
• “高对比度”开关适合投屏、弱视、强光环境或需要更明显边界的场景。
• “重置”按钮会恢复外观设置默认值。

外观设置只影响显示，不影响检测、OCR 和导出数据。

设置-检测

• “推理设备”可选择 CPU、GPU CUDA 或 DirectML。
• CPU 兼容性最好，但速度可能较慢。
• GPU CUDA 适合 NVIDIA 显卡，速度更快，但需要正确安装 CUDA 相关环境。
• DirectML 适合部分 Windows GPU 场景，兼容性取决于驱动和硬件。
• “刷新检测”会重新检测 GPU 可用状态。
• “置信度阈值”设置默认检测阈值。
• “重置”按钮会恢复检测设置默认值。

如果 GPU 初始化失败，先切换到 CPU 保证可以工作，再检查驱动、CUDA、ONNX Runtime 和显卡环境。

设置-框样式

框样式控制检测框在画布上的显示方式。

• 检测框颜色用于区分自动检测区域。
• 线宽控制框线粗细。
• 透明度控制检测框填充或边框的可见程度。
• 选中样式用于突出当前选中的检测项。
• 低置信度或异常项样式用于提醒用户复核。

这些设置主要影响查看和标注体验，不会改变检测结果本身。

设置-气泡样式

气泡样式控制导出和画布上的编号标注。

• 气泡大小控制圆圈直径。
• 气泡颜色控制编号圆圈颜色。
• 字体大小控制编号文字大小。
• 连线样式控制气泡到检测框之间的连接线。
• 编号显示开关决定是否显示数字编号。

正式导出前建议打开一页预览，确认气泡没有遮挡关键图纸内容。

设置-OCR

• “打开指南”按钮会打开 OCR 使用建议窗口。
• “本地OCR模型”用于选择客户端本地 ONNX 识别模型。
• “OCR模型”用于选择后端 AI OCR 模型。
• “超时时间”控制单次 OCR 请求最长等待时间。图纸复杂、批量多或网络慢时可以适当增大。
• “显示OCR预览窗口”打开后，发送识别请求前会显示合并图片预览，用户可以确认或取消。
• “识别错误自动复核”打开后，无法识别项目会自动尝试旋转或其他方式再次识别。它会提高成功率，但会增加耗时和 Token 消耗。
• “OCR识别次数”控制常规识别重试次数。次数越多越稳，但越慢。
• “原始识别（不拆分公差）”打开后，AI 返回的整段文字保留在一个字段中；关闭后，软件会尝试拆分成尺寸值、上公差、下公差。
• “人工纠错样本库”显示人工修正记录，用于改进后续识别或训练。
• “打开样本库”按钮用于查看人工纠错样本库。
• “后端 OCR 提示词”显示当前后端用于 OCR 的提示词，通常只读，用于排查识别策略。
• “重置”按钮会恢复 OCR 设置默认值。

建议：普通尺寸检测关闭“原始识别”，方便导出公差列；复杂符号、组合标注较多时可以打开“原始识别”，先保留完整文本再人工处理。

设置-Token统计

Token 统计用于查看 OCR 和 AI 请求消耗。

• “时间段”下拉框可选择今日、最近 7 天、最近 30 天或全部。
• “请求次数”显示统计范围内的 OCR 请求数量。
• “输入 Token”显示发送给 AI 的内容消耗。
• “输出 Token”显示 AI 返回内容消耗。
• “总 Token”显示输入和输出合计。
• 下方图表显示最近请求的输入、输出 Token 趋势。

如果发现 Token 消耗异常高，检查是否打开了自动 OCR、自动复核、批量识别或过高的重试次数。

设置-导出

• “默认导出路径”显示导出文件默认保存目录。
• “浏览”按钮用于选择新的默认导出目录。
• “图片质量”控制导出图片质量，数值越高文件越大，图像越清晰。
• “检验报告模板”显示当前模板配置摘要。
• “配置模板”按钮打开检验模板配置窗口。
• “重置”按钮恢复导出设置默认值。
• 页面底部“导入配置”用于从配置文件恢复设置。
• “导出配置”用于把当前设置保存成配置文件，方便备份或迁移到其他电脑。
• “重置全部”会恢复所有设置为默认值，执行前请谨慎确认。

导出正式报告前，建议确认默认导出路径存在且有写入权限。

模型训练页面

模型训练页面用于创建训练数据集、保存检测结果、生成训练脚本和管理检测模型。

• “批量处理工具”打开批量数据处理窗口，适合批量检测和整理 OCR 结果。
• “PaddleOCR训练工具”打开 OCR 识别模型训练窗口。
• “训练指南”打开模型训练说明。
• “创建数据集”用于新建训练数据集，需要填写名称、行业、描述等信息。
• 数据集卡片中的“保存当前页”会把当前页检测结果保存到该数据集。
• “保存全部”会把所有页面的检测结果保存到该数据集。
• “训练”会生成 Python 训练脚本或启动相关训练准备。
• “打开目录”会打开数据集所在文件夹。
• 删除按钮会删除对应数据集，请确认已经备份。
• “导入模型”用于导入训练好的 ONNX 检测模型。
• 内置模型的“切换使用”会把当前检测模型切换到该内置模型。
• 自定义模型的“切换使用”会启用导入的自定义模型。
• 自定义模型删除按钮会移除该模型文件或模型记录。

训练数据质量比数量更重要。保存到数据集前，请先把检测框位置和类别修正准确。

批量处理工具

批量处理工具适合一次处理多个页面和多个检测项。

• “导入”用于导入需要批量处理的文件。
• “检测全部”对所有导入页面执行检测。
• “AI识别”对全部检测结果执行 OCR/AI 识别。
• “OCR复核”对无法识别或异常结果执行复核。
• “导出数据集”把处理结果导出为训练数据集格式。
• 右上角状态文字显示当前任务状态。
• 进度条显示批量处理进度。
• 上方表格显示所有检测项的截图、页码、气泡号、OCR 值、置信度、状态。
• OCR 值可以直接在表格中编辑。
• 下方“待校正项目”只显示无法识别或需要人工处理的项目。
• 下方符号按钮可把常用工程符号插入到当前编辑框。

批量任务运行时，主要按钮会禁用，避免重复处理。处理大量页面前请先确认登录状态和 OCR 额度。

PaddleOCR 训练工具

PaddleOCR 训练工具用于训练文字识别模型。

• “选择 label.txt”用于选择训练数据集标注文件。
• “选择 train.py”用于定位 PaddleOCR 的训练脚本。
• “输出目录”显示训练输出位置。
• “打开”按钮用于打开输出目录。
• “Epochs”设置训练轮数。轮数越多训练越久。
• “Batch”设置批大小。显存不足时减小该值。
• “学习率”控制模型更新速度，过高可能不稳定，过低训练慢。
• “验证比例”设置从数据集中划分多少比例作为验证集。
• “CPU训练”打开后强制使用 CPU，速度慢但兼容性好。
• “跳过依赖安装”打开后不重复安装 Python 依赖。
• “跳过Paddle安装”打开后不重复安装 Paddle。
• “跳过预训练下载”打开后不下载预训练模型，适合已经准备好模型文件的情况。
• “实时指标”显示 Epoch、Step、Loss、准确率、编辑距离、预计剩余时间。
• “训练日志”显示命令行输出。
• “清空”按钮清空日志显示，不删除训练文件。
• “仅准备数据”只生成训练所需数据和配置，不启动训练。
• “开始训练”启动训练流程。
• “停止”终止正在运行的训练任务。
• “导出模型”导出训练完成的模型文件。

训练前请确认 Python、PaddleOCR、显卡驱动和数据集路径正确。训练中途停止可能得到不可用或未完成的模型。

模型市场

模型市场用于共享和使用检测模型。

• “刷新”重新加载模型列表。
• “上传模型”上传自己的 ONNX 模型到模型市场。
• 搜索框可以按模型名称、作者或类别搜索。
• “搜索”按钮执行搜索。
• “详情”查看模型说明、版本、类别、输入尺寸、作者、下载次数等信息。
• “编辑”只对自己上传的模型显示，用于修改模型信息。
• “删除”只对自己上传的模型显示，用于删除市场中的模型记录。
• “下载并启用”会下载该模型并设置为当前可用检测模型。
• “已下载”标签表示本地已有该模型。
• “当前使用”标签表示该模型正在被检测功能使用。
• “我的上传”标签表示模型由当前账号上传。

下载和上传通常需要登录。启用新模型后，建议回到主页使用典型图纸测试检测效果。

历史记录

历史记录页面用于管理最近打开或处理的项目。

• 搜索框可按文件名、路径或日期过滤记录。
• “清空全部”会删除全部历史记录。
• “清除未置顶”会保留置顶项目，清除普通历史。
• 每条记录显示缩略图、文件名、路径、上次打开时间和检测数量。
• 图钉按钮用于置顶或取消置顶。
• 打开按钮用于重新打开该历史项目。
• 删除按钮只删除历史记录，不删除原始文件。

如果历史记录打不开，通常是原文件已移动、重命名或删除。

OCR 使用建议

• 竖排尺寸文字建议先旋转裁剪图，或使用点击截图旋转功能后重新识别。
• 上下公差属于二维排版，识别难度高，建议配合人工复核。
• 粗糙度、形位公差、沉孔、深度等符号不是普通文字，必要时使用符号按钮修正。
• 如果尺寸线、箭头、中心线压住文字，OCR 可能把线条当成字符，需要人工检查。
• 批量 OCR 前先抽查几页，确认模型和设置适合当前图纸。
• 对同类客户图纸，建议保存稳定的 OCR 设置和检验模板配置。

常见问题

• AI 识别按钮点不了：通常是未登录、没有检测结果、正在处理任务或服务未初始化。
• AI 帮我配置点不了：需要先选择有效 Excel 模板，并成功加载工作表和预览网格。
• 检测结果太少：降低置信度，换模型，或使用“疑似漏检”。
• 检测结果太多：提高置信度，删除误检项，或换更适合的模型。
• OCR 经常无法识别：检查裁剪框是否包含完整文字，尝试旋转截图，换 OCR 模型，打开自动复核。
• 导出报告为空：确认已经检测并识别，结果没有全部被删除或忽略，模板明细行范围有效。
• 品检报告写错列：重新打开“检验模板配置”，检查字段列映射和工作表是否正确。
• GPU 无法使用：切换 CPU 先完成工作，再检查显卡驱动、CUDA、DirectML 和 ONNX Runtime。
• 帮助文件乱码：请确认帮助 Markdown 文件以 UTF-8 保存。

快捷键

• Ctrl+O：导入文件。
• Ctrl+S：保存项目。
• F5：检测当前页。
• Ctrl+F5：检测全部页面。
• Ctrl++：放大。
• Ctrl+-：缩小。
• Ctrl+0：适应窗口。
• Ctrl+1：实际大小。
• Ctrl+/：显示快捷键说明。
• Delete：删除当前选中的检测项。
• Ctrl+E：导出 Excel。
• Ctrl+Z：撤销。
• Ctrl+Y：重做。

快捷键是否生效取决于当前焦点。如果光标正在文本框中编辑文字，部分快捷键可能优先作用于文本框。

数据安全和保存建议

• 正式项目前先保存项目文件，再执行批量识别和导出。
• 客户原始模板建议保留一份未修改备份。
• AI 配置模板只应用到当前配置界面，必须点击“保存模板配置”才会生效。
• 手动修改检测结果后，建议立即保存项目。
• 导出正式报告前，先用少量数据测试模板写入位置。
• 涉密图纸不要开启训练数据上传，除非已经得到授权。

帮助窗口使用方法

• 左侧“目录”显示所有一级和二级标题，点击可跳转到对应章节。
• “预览”页用于查看排版后的帮助内容。
• “搜索框”用于搜索帮助教程正文。输入关键词后，所有匹配内容会高亮显示。
• “上一条”用于跳转到上一个搜索结果。
• “下一条”用于跳转到下一个搜索结果。
• “清空”用于清除搜索关键词和高亮结果。
• 在搜索框中按 Enter 可以跳到下一条结果。
• 在搜索框中按 Esc 可以清空搜索。
• 搜索结果计数会显示当前是第几条，以及总共找到多少条。
• “编辑 Markdown”页用于直接编辑帮助文本。
• “刷新预览”会把当前编辑框内容重新渲染到预览页，但不会保存文件。
• “保存”会把当前 Markdown 写回帮助文件，并刷新预览。
• “重新读取”会从磁盘重新读取帮助文件，会丢弃未保存的编辑内容。
• “关闭”会关闭帮助窗口。

如果你正在修改帮助文件，建议先点击“保存”，再关闭窗口。

逐按钮说明-标题栏和账号区域

• “账号头像”按钮：打开账号弹出面板。未登录时用于进入登录、注册；已登录时用于查看用户名、额度、订阅状态、个人资料和退出登录。若点击后没有反应，通常是窗口正在处理任务或弹出面板已经打开。
• “未登录/用户名”按钮：与账号头像作用相同，用于展开账号面板。显示“未登录”表示当前 AI 服务请求不会带登录凭证。
• “登录”按钮：打开登录窗口。登录成功后，AI识别、模型市场、订阅、Token统计等功能会使用当前账号。
• “注册”按钮：打开注册窗口。用于创建新账号，注册后再登录才能使用账号相关功能。
• “退出登录”按钮：清除当前账号登录状态。退出后不会删除本地项目，但需要账号的 AI 功能会不可用。
• “会员订阅”按钮：打开订阅窗口。用于购买月度或年度会员。
• “个人资料”按钮：打开账号资料窗口，查看账号基础信息、会员状态或相关信息。
• “账号设置”按钮：进入账号设置入口。用于后续账号安全、资料维护等。
• “订阅”按钮：直接打开订阅窗口。适合用户想查看会员方案或续费。
• “设置齿轮”按钮：跳转到设置页面。用于调整通用、外观、检测、OCR、导出等配置。
• “帮助教程”按钮：打开当前帮助窗口。此按钮不影响项目数据，可以随时打开。
• “最小化”按钮：将程序缩到任务栏。正在运行的检测或 AI 任务不会因为最小化而自动停止。
• “最大化/还原”按钮：最大化窗口或恢复原大小。适合在查看大图纸、长表格时扩大工作区。
• “关闭”按钮：关闭程序。若项目有未保存数据，软件会提示保存。
• “公告条”区域：当系统有通知时显示。点击后通常会打开公告详情、版本提示或服务状态说明。

逐按钮说明-主页功能区

• “文件”组：新建、导入、导入文件夹、保存、另存为。首次使用先从这里导入图纸。
• “检测”组：检测当前页、切片实验、手动标注、清空检测框。
• “导出”组：导出气泡图、Excel、PDF、图片等结果。
• “报告交付”组：品检报告、批量打印、打包导出。
• “样本”组：保存全部样本，用于后续训练。
• 右侧“模型 / 公差标准”：切换检测模型、打开公差标准设置、对比模型。
• “版本对比”：图纸版本管理。

窗口较窄时，组内放不下的按钮会收进该组右侧的下拉菜单。切换分组不会修改图纸数据。

逐按钮说明-开始区域

• “导入”：选择单个或多个 PDF、图片文件导入项目。点击后会打开文件选择框；导入成功后左侧图纸列表会出现页面。
• “导入文件夹”：选择一个文件夹，软件自动扫描其中支持的 PDF 和图片。适合一次处理同一订单的多张图。
• “打开项目”：打开之前保存的项目文件。打开前如果当前项目有未保存数据，软件会提示保存。
• “保存项目”：保存当前项目状态，包括页面、检测框、OCR结果、人工修改、气泡编号等。
• “另存为”：把当前项目保存为新的文件。适合做备份或保留不同处理版本。
• “撤销”：撤回上一次可撤销操作，例如删除检测项、移动框、修改文字。
• “重做”：恢复刚刚撤销的操作。
• “导出 Excel”：把检测结果导出为普通 Excel 数据表。适合统计、交接、二次处理。
• “导出图片”：把当前页或图纸标注结果导出为图片。适合截图式交付。
• “导出 PDF”：把标注后的图纸导出为 PDF。适合归档或客户确认。

这些按钮若处于灰色，通常表示当前没有导入文件、当前没有检测结果、正在处理任务，或该功能需要先完成前置步骤。

逐按钮说明-检测识别区域

• “检测当前页”：只对当前选中的页面运行尺寸区域检测。适合调试模型、确认置信度、处理单页。
• “检测全部”：对左侧图纸列表中的所有页面运行检测。适合参数确认后的批量处理。
• “疑似漏检”：在已有检测结果基础上查找可能遗漏的尺寸文字区域。适合检测结果明显偏少时使用。
• “AI识别”：对检测框截图运行 OCR/AI 识别，填充检测项目、上下公差等字段。需要登录和可用 AI 服务。
• “OCR复核”：对上一轮无法识别或异常项目再次识别。会增加耗时和 Token 消耗，但可提高疑难项成功率。
• “自动OCR识别”开关：打开后，检测当前页完成后自动触发 AI识别；关闭后，需要用户手动点击 AI识别。
• “OCR模型”下拉框：选择用于识别尺寸文字的模型。模型不同，符号、公差、复杂排版识别效果会不同。
• “置信度 -”按钮：降低检测阈值，通常会检出更多框，但误检也可能增加。
• “置信度 +”按钮：提高检测阈值，通常会减少误检，但漏检可能增加。
• “模型”下拉框：选择检测尺寸区域的 ONNX 模型。更换模型后，需要重新检测才能看到新模型效果。

建议顺序：先选择模型和置信度，点击检测当前页，确认框选效果，再运行 AI识别。

逐按钮说明-标注和视图区域

• “显示检测框”开关：控制画布上矩形检测框是否显示。关闭后结果仍存在，只是不显示框。
• “显示气泡”开关：控制气泡圆圈是否显示。用于检查图纸原貌或减少遮挡。
• “显示数字编号”开关：控制气泡内编号是否显示。关闭后气泡可能仍显示，但没有数字。
• “显示序号路径连线”开关：控制气泡到检测框之间的连接线是否显示。
• “显示网格”开关：显示或隐藏辅助网格。适合对齐检测框或查看位置。
• “放大”：放大图纸显示比例。
• “缩小”：缩小图纸显示比例。
• “适应窗口”：把整页图纸缩放到当前画布可见范围。
• “实际大小”：恢复到 100% 或软件定义的默认比例。
• “手动添加标注”：允许用户在图纸上手动框选一个检测区域。用于补充漏检项。
• “删除选中”：删除当前选中的检测项。删除后导出不再包含该项。
• “清空当前页结果”：删除当前页所有检测项。适合重新检测前清理旧结果。
• “重新编号”：按当前规则重新整理气泡编号。适合删除或新增项目后保持编号连续。

视图开关只影响显示，删除和清空类按钮会改变项目数据，操作前请确认是否需要保存。

逐按钮说明-右侧结果区

• “复核窗口”：打开集中复核界面，用于查看、编辑或处理识别结果。
• “公差标准”下拉框：选择 AI 识别后用于解释和自动填充公差的标准。
• “公差标准设置”：打开公差标准配置入口。用于维护标准规则。
• “图片列按钮”：点击某一行的裁剪图，会旋转 90 度并重新识别该项，适合竖排文字和方向识别错误。
• “符号按钮”：把工程符号插入当前编辑位置。插入前请先把光标放到要编辑的文本框。
• “结果表格单元格”：双击可编辑 OCR 值、上公差、下公差等内容。
• “结果行右键-定位”：在画布中定位该检测项。
• “结果行右键-编辑”：进入编辑状态。
• “结果行右键-删除”：删除该检测项。
• “结果行右键-复制识别值”：复制当前 OCR 文本。
• “结果行右键-复制全部信息”：复制编号、尺寸、公差等完整信息。

如果用户修改了表格内容，保存项目后才会长期保留。

逐按钮说明-画布右键菜单

• “放大”：以当前画布为中心放大视图。
• “缩小”：以当前画布为中心缩小视图。
• “适应窗口”：让整张图纸完整显示。
• “实际大小”：恢复默认比例。
• “手动添加标注”：进入手动框选模式。框选完成后会在结果表格生成新行。
• “编辑检测框”：编辑当前右键命中的检测项。
• “删除检测框”：删除当前右键命中的检测项。
• “复制识别值”：复制当前检测项的识别文字。
• “批量删除选中”：删除当前框选或多选的检测项。
• “取消选择”：取消当前多选状态。

右键菜单会根据点击位置不同显示不同选项。右键空白区域和右键检测框看到的菜单不同。

逐按钮说明-导出区域

• “导出 Excel”：导出结构化检测结果表。通常包含编号、检测项目、上公差、下公差等字段。
• “导出 PDF”：导出带气泡标注的 PDF。
• “导出图片”：导出带标注图片。
• “导出当前页”：只导出当前选中的页面。
• “导出全部页”：导出所有页面。
• “导出品检报告”：按检验报告模板把识别结果写入客户 Excel 报告。
• “配置模板”：打开检验模板配置窗口。
• “批量打印”：打开批量打印或打印预览相关窗口。
• “导出数据集”：导出训练数据，不是正式检验报告。

如果导出文件无法写入，请检查导出目录是否存在、文件是否被 Excel 或 PDF 阅读器占用。

逐字段说明-检验模板基础信息

• “模板名称”：当前配置的显示名称。建议包含客户、产品或工序，例如“J-01 车床检测模板”。
• “模板文件”：当前选中的 Excel 模板路径。只读显示，通过“选择 Excel 模板”更换。
• “工作表”：导出时写入哪一个 sheet。多工作表模板必须选择正确工作表。
• “写入方式”：决定软件是往空白行追加，还是匹配模板已有检验项目。
• “明细开始行”：第一条检测明细写入的 Excel 行号。
• “明细结束行”：明细区域最后一行。超过该行后不再继续写入当前区域。
• “每页最大明细数”：每一页最多写入多少条检测结果。
• “导出时附加气泡图工作表”：打开后，导出报告中增加气泡图相关工作表。

行号必须是大于 0 的整数。列号必须是 Excel 列名，例如 A、B、C、AA。

逐按钮说明-检验模板配置窗口

• “AI帮我配置”：让 AI 分析当前 Excel 模板并给出字段映射建议。没有选择有效模板、没有预览网格或正在分析时不可点击。
• “选择 Excel 模板”：打开文件选择框，选择 .xls 或 .xlsx 模板。选择后软件读取工作表并生成右侧预览。
• “序号列”：把当前选中的预览单元格所在列设置为序号列。
• “检验项目列”：把当前选中的预览单元格所在列设置为检验项目列。
• “上公差列”：把当前选中的预览单元格所在列设置为上公差列。
• “下公差列”：把当前选中的预览单元格所在列设置为下公差列。
• “上限列”：把当前选中的预览单元格所在列设置为上限列。
• “下限列”：把当前选中的预览单元格所在列设置为下限列。
• “实测值列”：把当前选中的预览单元格所在列设置为实测值列。
• “合格列”：把当前选中的预览单元格所在列设置为合格列。
• “不合格列”：把当前选中的预览单元格所在列设置为不合格列。
• “取消”：关闭窗口，不保存本次修改。
• “保存模板配置”：保存当前配置。保存后导出品检报告会使用该配置。

字段按钮的正确用法是先点右侧 Excel 预览单元格，再点左侧字段按钮。直接在文本框中输入列号也可以，但更容易输错。

逐按钮说明-AI正在配置模板窗口

• “暂停”：暂停界面显示追加。AI 后端仍继续工作，适合用户想阅读当前思考内容。
• “继续”：恢复显示，并把暂停期间收到的思考过程和结果补充显示出来。
• “取消”：取消当前 AI 请求。取消后不会应用建议，不会修改已有配置。
• “关闭窗口”：如果 AI 任务还在运行，等同于取消；如果任务完成，则关闭窗口。
• “思考过程文本框”：显示 AI 对表头、合并单元格、明细区域和字段映射的分析。
• “配置结果流文本框”：显示 AI 逐步返回的 JSON 或结果片段。

该窗口的两个文本框会自动滚动到底部。若用户手动拖动滚动条阅读旧内容，可以点击暂停避免新内容不断滚动。

逐按钮说明-AI配置建议窗口

• “应用AI建议”：把 AI 建议写入当前检验模板配置窗口。只写入合法行号和合法列名。
• “取消”：关闭建议窗口，不应用任何建议。
• “字段映射列表”：展示每个字段建议写到哪一列。
• “置信度”：显示 AI 对建议的把握程度。低于 0.65 时必须人工复查。
• “说明”：显示 AI 对模板结构、缺失字段、风险点的解释。

应用建议后仍需要点击“保存模板配置”。如果只应用不保存，关闭模板配置窗口后修改会丢失。

逐按钮说明-设置页面通用

• “语言”下拉框：切换界面语言。部分已打开窗口可能需要关闭后重新打开才完全刷新。
• “打开上次项目”开关：打开后，启动软件时自动尝试恢复上次项目。
• “自动检查更新”开关：打开后，软件会自动检查版本更新。
• “重置”：恢复通用设置默认值。

通用设置主要影响软件启动和基础体验，不会影响当前检测结果。

逐按钮说明-设置页面外观

• “主题”下拉框：选择浅色、深色或跟随系统。
• “强调色”颜色块：显示当前强调色。
• “确认/选择颜色”按钮：打开颜色选择并应用新的强调色。
• “高对比度”开关：增强文字和边框对比度。
• “重置”：恢复外观默认设置。

外观设置不改变导出的检测数据，但可能影响截图和操作舒适度。

逐按钮说明-设置页面检测

• “推理设备”下拉框：选择 CPU、GPU CUDA 或 DirectML。
• “刷新检测”：重新检测 GPU 和推理环境状态。
• “置信度阈值”输入框：设置默认检测阈值。
• “检测框最大数量”输入框：限制单页最多检测数量，防止误检过多。
• “重叠过滤阈值”输入框：控制重叠检测框合并或过滤程度。
• “重置”：恢复检测设置默认值。

如果修改检测参数，通常需要重新执行检测才能看到效果。

逐按钮说明-设置页面框样式

• “检测框颜色”：设置普通检测框颜色。
• “选中框颜色”：设置当前选中检测框颜色。
• “低置信度颜色”：设置低置信度提示颜色。
• “线宽”：设置检测框边线粗细。
• “透明度”：设置检测框显示透明程度。
• “显示填充”开关：控制检测框内部是否有半透明填充。
• “重置”：恢复框样式默认值。

框样式只影响显示和导出视觉，不改变 OCR 识别文字。

逐按钮说明-设置页面气泡样式

• “气泡颜色”：设置气泡圆圈颜色。
• “文字颜色”：设置气泡编号文字颜色。
• “气泡大小”：设置圆圈大小。
• “字体大小”：设置编号字体大小。
• “线条宽度”：设置气泡连线粗细。
• “编号起始值”：设置气泡编号从几开始。
• “自动避让”开关：打开后，软件尽量减少气泡遮挡图纸内容。
• “重置”：恢复气泡样式默认值。

如果导出的气泡挡住尺寸文字，可以减小气泡大小、调整连线或手动移动气泡。

逐按钮说明-设置页面OCR

• “打开指南”：打开 OCR 识别建议窗口。
• “本地OCR模型”下拉框：选择本地 ONNX OCR 模型。
• “OCR模型”下拉框：选择后端 AI OCR 模型。
• “超时时间”输入框：设置单次 OCR 请求最多等待多少秒。
• “显示OCR预览窗口”开关：打开后，发送 AI 前先显示裁剪合图预览。
• “识别错误自动复核”开关：打开后，无法识别项目会自动尝试复核。
• “OCR识别次数”输入框：设置常规 OCR 重试次数。
• “原始识别（不拆分公差）”开关：打开后保留完整识别文本；关闭后尝试拆成尺寸、上公差、下公差。
• “打开样本库”：打开人工纠错样本库窗口。
• “后端 OCR 提示词”文本框：只读显示后端提示词，方便排查识别策略。
• “重置”：恢复 OCR 设置默认值。

如果用户只是做普通尺寸报表，建议关闭“原始识别”；如果图纸符号复杂，建议打开并人工复核。

逐按钮说明-设置页面Token统计

• “时间段”下拉框：选择统计今日、最近 7 天、最近 30 天或全部。
• “请求次数”：显示 AI/OCR 请求数量。
• “输入 Token”：显示发送给 AI 的文本、图片描述或上下文消耗。
• “输出 Token”：显示 AI 返回结果消耗。
• “总 Token”：显示输入和输出合计。
• “图表区域”：显示最近请求的 Token 趋势。

Token 统计主要用于排查消耗，不会影响当前项目数据。

逐按钮说明-设置页面导出

• “默认导出路径”文本框：显示默认保存目录。
• “浏览”：选择新的默认导出目录。
• “图片质量”输入框：设置导出图片质量。数值越高越清晰，文件越大。
• “配置模板”：打开检验模板配置窗口。
• “重置”：恢复导出设置默认值。
• “导入配置”：从配置文件导入软件设置。
• “导出配置”：把当前软件设置导出为文件。
• “重置全部”：恢复所有设置为默认值。此操作影响范围大，执行前应确认。

如果导出失败，优先检查默认导出路径是否存在、是否有权限、目标文件是否被占用。

逐按钮说明-历史记录页面

• “搜索框”：按文件名、路径或日期筛选历史项目。
• “清空全部”：删除全部历史记录，不删除原始文件。
• “清除未置顶”：删除未置顶记录，保留置顶记录。
• “置顶/取消置顶”图钉按钮：把常用项目固定在历史列表中。
• “打开”按钮：打开对应历史项目。
• “删除”按钮：从历史列表移除该记录。

历史记录只是入口清单，删除历史记录不会删除磁盘上的项目文件。

逐按钮说明-模型市场页面

• “刷新”：重新从服务端加载模型列表。
• “上传模型”：上传当前用户自己的模型。需要登录。
• “搜索框”：输入模型名称、作者、类别关键字。
• “搜索”：按搜索框内容筛选模型。
• “详情”：查看模型版本、说明、作者、类别、输入尺寸、下载量等。
• “编辑”：修改自己上传的模型信息。不是自己上传的模型不会显示。
• “删除”：删除自己上传的模型记录。不是自己上传的模型不会显示。
• “下载并启用”：下载模型到本地，并设置为当前检测模型。

下载新模型后，回到主页重新检测当前页，才能看到新模型效果。

逐按钮说明-模型训练页面数据集管理

• “批量处理工具”：打开批量数据处理窗口。
• “PaddleOCR训练工具”：打开 OCR 训练窗口。
• “训练指南”：打开训练说明。
• “创建数据集”：新建训练数据集。
• “保存当前页”：把当前页检测框和标注保存到该数据集。
• “保存全部”：把所有页面检测框和标注保存到该数据集。
• “训练”：生成训练脚本或进入训练流程。
• “打开目录”：打开数据集文件夹。
• “删除数据集”：删除对应数据集。删除前建议备份。

保存到数据集前，请确保检测框位置、类别和文字已经人工确认。

逐按钮说明-模型训练页面模型管理

• “导入模型”：导入训练好的 ONNX 检测模型。
• “内置模型-切换使用”：把当前检测模型切换到该内置模型。
• “自定义模型-切换使用”：启用对应自定义模型。
• “删除自定义模型”：删除本地自定义模型记录或文件。

切换模型不会自动重新检测已存在结果。需要重新执行检测才能使用新模型生成结果。

逐按钮说明-批量处理工具

• “导入”：导入要批量处理的 PDF 或图片。
• “检测全部”：对全部导入页面执行检测。
• “AI识别”：对所有检测项执行 AI/OCR 识别。
• “OCR复核”：对无法识别或异常项目重新识别。
• “导出数据集”：把当前批量处理结果导出为训练数据。
• “进度条”：显示当前批量任务进度。
• “OCR值文本框”：可直接修改每个检测项的识别结果。
• “下方符号按钮”：向当前编辑的 OCR 值插入常用符号。
• “待校正项目表格”：集中显示无法识别项目，便于逐个修正。

批量处理消耗较大。建议先用少量页面测试，再导入全部文件。

逐按钮说明-PaddleOCR训练工具

• “选择 label.txt”：选择 OCR 训练数据的标注文件。
• “选择 train.py”：选择 PaddleOCR 的训练脚本。
• “输出目录-打开”：打开训练输出文件夹。
• “Epochs”：训练轮数输入框。
• “Batch”：批大小输入框。
• “学习率”：学习率输入框。
• “验证比例”：验证集占比输入框。
• “CPU训练”开关：强制使用 CPU 训练。
• “跳过依赖安装”开关：不重复安装 Python 依赖。
• “跳过Paddle安装”开关：不重复安装 Paddle。
• “跳过预训练下载”开关：不下载预训练模型。
• “清空”：清空训练日志显示。
• “仅准备数据”：只准备数据和配置，不启动训练。
• “开始训练”：启动训练流程。
• “停止”：中止正在运行的训练。
• “导出模型”：导出训练完成后的模型。

训练参数填写错误可能导致训练失败。显存不足时优先降低 Batch。

逐按钮说明-订阅窗口

• “月度会员卡片”：选择月度会员方案。
• “年度会员卡片”：选择年度会员方案。
• “-”按钮：减少购买数量。
• “+”按钮：增加购买数量。
• “立即订阅”：提交当前方案和数量。
• “关闭”按钮：关闭订阅窗口，不提交订单。

订阅前确认当前登录账号正确，因为会员权益会绑定到账号。

逐按钮说明-帮助窗口

• “目录列表”：点击章节标题后，预览区会跳转到对应位置。
• “预览”页签：查看渲染后的帮助内容。
• “搜索框”：输入关键词搜索帮助内容。搜索不区分大小写，会在预览正文中高亮所有命中。
• “上一条”：跳转到上一处搜索命中。到第一条后继续点击会循环到最后一条。
• “下一条”：跳转到下一处搜索命中。到最后一条后继续点击会循环到第一条。
• “清空”：清除关键词、高亮和搜索状态。
• “编辑 Markdown”页签：直接编辑帮助源文件内容。
• “刷新预览”：只刷新当前窗口预览，不保存磁盘文件。
• “保存”：把编辑框内容写入帮助 Markdown 文件。
• “重新读取”：放弃当前未保存编辑，重新从磁盘读取帮助文件。
• “关闭”：关闭帮助窗口。

如果编辑后发现格式不对，可以先不保存，点击“重新读取”恢复磁盘上的版本。

逐开关说明-哪些开关只影响显示

• “显示检测框”：只影响画布是否显示框。
• “显示气泡”：只影响画布是否显示气泡。
• “显示数字编号”：只影响编号是否显示。
• “显示序号路径连线”：只影响连线是否显示。
• “显示网格”：只影响辅助网格是否显示。
• “高对比度”：只影响界面对比度。
• “主题”：只影响界面明暗风格。

这些开关不会删除检测项，也不会改变 OCR 文本。

逐开关说明-哪些开关会影响处理结果

• “自动OCR识别”：会影响检测完成后是否自动发起 AI 识别。
• “识别错误自动复核”：会影响无法识别项目是否自动再次请求 AI。
• “原始识别（不拆分公差）”：会影响 OCR 结果写入字段的方式。
• “导出时附加气泡图工作表”：会影响品检报告导出的工作表内容。
• “CPU训练”：会影响 PaddleOCR 训练使用 CPU 还是 GPU。
• “跳过依赖安装”“跳过Paddle安装”“跳过预训练下载”：会影响训练准备流程。

这些开关建议在批量处理前确认，避免处理到一半才发现结果格式不符合预期。

禁用状态说明

• 按钮灰色通常表示当前条件不足，而不是程序坏了。
• 没有导入图纸时，检测、OCR、导出类按钮可能禁用。
• 没有检测结果时，AI识别、导出结果、复核类按钮可能禁用。
• 未登录时，AI识别、模型市场上传、订阅相关功能可能提示登录。
• 正在检测或正在 AI 识别时，相关按钮会临时禁用，防止重复请求。
• 没有选择 Excel 模板时，“AI帮我配置”禁用。
• Excel 模板未成功预览时，“AI帮我配置”禁用。
• 训练任务运行中，开始、准备、导入类按钮可能禁用，停止按钮启用。

遇到按钮不能点时，先看按钮提示、状态栏文字和当前是否满足前置条件。

错误提示处理

• “请先导入文件”：说明当前项目没有图纸页面。
• “检测模型未初始化”：说明模型文件缺失、模型加载失败或推理设备不可用。
• “请先登录账号”：说明该功能需要登录。
• “当前无法初始化平台 OCR 服务”：说明后端服务、网络或模型配置有问题。
• “AI 未返回有效 JSON”：说明 AI 返回内容格式不符合配置要求，可以重试或检查提示词和模型。
• “请求参数错误”：说明前端发送给后端的数据不符合接口要求，通常需要开发人员检查字段。
• “导出失败”：检查导出目录、文件占用、模板路径、字段映射和权限。
• “程序异常”：查看弹窗中的日志路径，把日志发给开发人员定位。

用户遇到异常时，最有用的信息是：正在点哪个按钮、导入的文件类型、当前页面、弹窗完整文字、日志文件路径。

推荐操作习惯

1. 导入图纸后先保存项目。
2. 先检测当前页，不要一开始就检测全部。
3. 调好置信度后再批量检测。
4. AI识别前确认已经登录。
5. 批量 OCR 前先看 Token 和额度。
6. 导出品检报告前先测试模板。
7. AI 模板配置结果必须人工看一遍再应用。
8. 正式导出前保存项目。
9. 客户模板保留原始备份。
10. 复杂图纸保留人工复核记录。