Little Bee Ballooning Tool
工程图纸 AI 尺寸识别与气泡标注工具 · 上传 PDF，自动识别尺寸与公差，一键生成带编号的气泡图、质检尺寸表与加工报价单。
📌系统概述
本系统面向机加工、模具、外协质检场景：把工程师手里的工程图纸 PDF 变成「可核对、可编辑、可交付」的气泡标注图与检验文档，替代人工逐项标注与抄表的重复劳动。
🚀五步快速开始
从一张图纸 PDF 到可交付的报告，通常 1 分钟内完成。
⭕画布与气泡
画布区顶部是气泡样式与视图工具，右上角是竖排功能工具条，底部是翻页按钮。
显示与缩放
- 缩放：－ / ＋ 按比例缩放，⟲ 恢复 100%，适配 让整页刚好铺满视口（换页后仍生效）。
- 滚轮缩放：鼠标滚轮在画布区直接缩放 —— 以画布区中心为锚点，放大时向四周扩散、缩小时向四周收拢；同时把光标所指的内容尽量向画布中心拉近，便于聚焦查看。向上滚放大、向下滚缩小，滚一格约 13%。
- 平移图纸：鼠标进入画布区时光标变为手掌，按住左键拖动即可自由移动图纸（拖动中光标收拢为拳头）。框选模式下光标变十字，此时拖动用于框选而非平移。
- 翻页：底部「第 N 页」按钮切换多页图纸，切换时会自动退出原图状态并重绘捕获框。
- 左栏宽度可拖拽调整（鼠标移到左右栏之间的竖条上拖动），双击竖条恢复默认宽度。
气泡样式
- 大小：下拉可选 18 / 24 / 32 / 42 或自定义数值，对应气泡半径。
- 颜色：内置红、蓝、绿、橙、紫、黑六色，也可用取色器指定任意 RGB。
- 改完点「🎨 应用新样式」，系统会对当前报告重算气泡布局并重新生成 PNG / HTML / XLSX；旧报告缺少原始 PDF 时需重新分析。
气泡与表格联动
- 点击尺寸表任意一行，图纸会自动定位到对应气泡并持续闪烁，方便逐项核对。
- 表格行首勾选可多选，用于批量隐藏、批量删除或批量设置公差。
📋尺寸表与视图管理
右栏尺寸表是数据的唯一来源 —— 表里改什么，导出的 HTML / XLSX / 报价单就跟着变。
表格列说明
| 列 | 说明 |
|---|---|
| # | 气泡编号，与图纸上的气泡一一对应。 |
| 尺寸 / 要求 | 名义尺寸文本，含 ⌀ / R / ° / M 等符号，也可写文字要求。 |
| 上偏差 / 下偏差 | 分开两列。图纸上写 ±0.2 会自动拆成 +0.2 与 -0.2；已分列的非对称公差保持原样。 |
| 类别 | 线性 / 孔径·直径 / 半径 / 角度 / 螺纹 / 倒角·退刀槽 / 粗糙度 / 形位公差 等，可下拉或手输。 |
| 视图 | 主视图 / 俯视图 / 左视图 / 剖视 / 局部。系统按位置粗推初值，可自行修正。 |
| 数量 | 按标注前缀自动累计，如 6-⌀13 记为 6。 |
| 备注 | 螺纹深、通孔、材料要求等补充文字。 |
| OK / NG | 开启「检验」模式后出现，录入实测值即自动判定是否在公差带内。 |
表格工具
- 💾 保存：把当前表格写回报告，并同步重绘气泡图与重生成 HTML / XLSX。改完务必点它。
- ＋ 加行 / ✕ 删行：手动补一条尺寸或删掉误识别的条目，删除后气泡图立即同步。
- 🔲 框选：进入框选模式，在图纸上拖框补标（见下一节）。
- 🔢 视图编号：按 主 → 俯 → 仰 → 左 → 右 → 剖 → 局部 的顺序重新编号，让报告顺序符合读图习惯。
- 工具条按钮：检验（切换 OK/NG 列）、隐藏 / 显示（把不需要检验的行收起或放出）、排序（按类别或视图重排）、公差、删除（批量删选中行）、导出。
🔲框选补标（AI 漏检时）
AI 识别不是 100% —— 尺寸符号是矢量图形、标注被遮挡、字特别小都可能漏掉。框选补标就是为此准备的高速通道。
- 点击「🔲 框选识别」，按钮进入激活态。
- 在图纸上按住左键拖出一个矩形，框住漏掉的尺寸标注（词中心落在框内即被收录，不受噪声过滤影响）。
- 松开鼠标 —— 系统立即识别框内尺寸、去重后追加进尺寸表、重新编号、重出气泡图，并在新气泡位置闪烁提示。
- 再点一次按钮退出框选模式；需要连续补标时可连续拖框。
📐默认公差设置
图纸上没标公差的尺寸（未注公差），可以按标准或企业习惯批量套用。
- 点击尺寸表工具条的「📐 公差」打开设置窗口。
- 单位可切换公制 mm / 英制 in。
- 按标注类型（线性 / 直径 / 角度等）分别启用，填写各自的上下偏差或按精度等级取标准表数值。修改后系统会记忆为你的自定义标准。
- 点「✔ 应用默认公差到未注公差标注」，仅对「上下偏差都为空」的条目生效，已有公差的一律不动。
🧰画布右侧竖排工具条
画布右上角四个按钮，全部是「点了就有结果」的实际功能；没有打开报告时整体置灰。
🔍捕获框核对
把 AI 抓取到的每一个尺寸范围，用半透明色块直接叠在图纸上 —— 判断「抓得准不准」最快的方式。
- 勾选画布顶栏的「捕获框」，当前页所有已识别尺寸的范围色块立即叠加显示，并带编号角标。
- 「透明」滑杆调节填充不透明度 0% ~ 60%。0% = 完全透明，只保留彩色边框，最适合看细节密集的图纸。
- 右侧取色器可换框线颜色（默认橙色），改完即时生效。
- 翻页、缩放、切换原图时捕获框都会自动跟随，位置基于百分比，不会错位。
- 右侧会显示本页捕获框数量；若显示「本页无捕获框」，说明该页没有识别到尺寸或该报告为旧版本未存坐标。
💰加工报价
基于图纸 AI 分析结果自动估算零件加工报价，不依赖人工填写零件清单。
数据从哪来
- 重 量：读图纸标题栏（如
1.47Kg），不猜密度。 - 孔 数：按标注前缀倍率累计，
6-⌀13计 6 个、9-⌀13计 9 个。 - 螺纹数：同规则，
2-M8计 2 处。 - 材料与图号：取自图纸识别结果。
计价过程
材料费（重量 × 单价）→ 孔加工费 → 螺纹加工费 → 基准加工费 → 装夹费 → 表面处理费 → 管理费 → 利润 → 税金 → 合计 → 单件报价。每一项的默认值都可在窗口里改成你厂的实数。
- 调整完参数点「📊 导出报价单 XLSX」下载报价单（含标题、图号 / 材料 / 重量信息区、明细、合计、备注与免责声明）。
- 参数会自动保存在本机浏览器，下次打开同一台电脑仍是你的单价。
📁报告管理中心
顶栏「📁 报告管理中心」列出全部历史报告，可检索、查看编辑、重导出与删除。
- 列表显示图号、名称、页数、标注数、创建时间等，默认按创建时间倒序。
- 顶部搜索框按图号 / 名称过滤。⚠️ 筛选只影响显示 —— 改动筛选会自动清掉不在当前结果里的勾选，避免误删看不见的报告。
- 「查看/编辑」回到该报告的画布；「删除」删单份（会二次确认）。
- 批量删除：勾选行首复选框（表头复选框 = 全选当前列表）→ 点「批量删除选中」→ 确认窗口会列出将被删除的图号（超过 15 份折叠显示数量）→ 确认后一次性删除。
- 批量删除会连同该报告的 PNG、HTML、XLSX、原图缓存与原始 PDF 一起删除，且不可恢复，请确认后再操作。
📤导出与文件说明
每个报告都会自动生成一套标准产物，命名规则统一、便于归档。
| 产物 | 命名规则 | 用途 |
|---|---|---|
| 气泡标注图 | <图号>_第N页_气泡图.png | 随图纸交付 / 打印随件，供车间与检验对照编号。 |
| HTML 分析报告 | <图号>_尺寸分析报告.html | 单文件自包含（图片内嵌 base64），可直接微信 / 邮件发送，不需要联网。 |
| XLSX 尺寸表 | <图号>_尺寸表.xlsx | Excel 进一步加工、统计、归档。 |
| 加工报价单 | <图号>_加工报价单.xlsx | 对外报价（见「加工报价」章节）。 |
| 原始图纸 | 上传时的文件名 | 随时下载回原始 PDF，也可用于重新分析。 |
检验模板导出
尺寸表工具条的「导出」可按内置检验模板输出质检表，支持选择模板、同时导出 PDF、把气泡图嵌入表格等选项。模板文件便于归档与外发。
❓常见问题
为什么识别出来的尺寸比图纸上少？
常见三个原因：① 图纸是扫描件或尺寸文字已转曲成矢量图形，文本层不存在，任何识别都无法恢复；② 尺寸被图框网格或右下标题栏覆盖，被当成噪声过滤掉了；③ 标注字太小或有遮挡。前两种属于图纸本身限制，请用「框选补标」手动补录 —— 这也是系统保留在线编辑的原因。
为什么公差数字被单独识别成了一条尺寸？
图纸上公差与尺寸距离较远、或被其他元素隔开时，行组聚合可能把它们分成两条。处理办法：在尺寸表里把多出来的那条删掉，再把公差值填回主尺寸的上/下偏差列，然后保存。
改成 ±0.2 后为什么变成两个 +0.2 / -0.2 列？
这是本系统的固定规则：对称公差 ±X 一律拆成上偏差 +X、下偏差 -X，因为下游检验表需要分列填写。已在图纸上分列写好的非对称公差（如 +0.1/-0.05）会保持原样不动。
改了尺寸表，图纸上的气泡没变？
点一下「💾 保存」。保存时系统会写回数据、重算气泡布局并重新生成 PNG / HTML / XLSX。如果保存后仍未变化，请强制刷新页面（Ctrl/Cmd + Shift + R）绕过浏览器缓存。
框选补标之后，新气泡为什么不显示？
系统会自动跳回你框选的那一页并把新气泡闪烁标出。若新气泡不在当前页，请确认画布页码是否被手动切走 —— 点击尺寸表对应的行即可自动定位到它所在的页。
捕获框是空的 / 显示「本页无捕获框」？
三种可能：① 该页确实没有识别到尺寸（换页看看其他页）；② 该报告是早期版本生成的，没有保存抓取坐标，重新分析一次即可；③ 不透明度调到 0% 且颜色与图纸底色接近，看起来「没有」—— 调高不透明度或换个框色。
报价里的重量不对怎么办？
重量取自图纸右下标题栏。若标题栏没写重量或字迹无法识别，报价窗口里的重量会取不到值，请手动填入实际重量后再计算。孔 / 螺纹数按标注前缀倍率累计，若图纸写法特殊（如写成 6×⌀13）同样能识别。
批量删除误删了怎么办？
批量删除不可撤销，报告连图片、表格与原始 PDF 一并删除。系统为此做了两道保护：删除前列出将被删除的图号供确认、切换筛选时自动清掉不在当前结果里的勾选。如误删，只能重新上传原图纸分析 —— 建议重要报告先下载 XLSX 与 HTML 备份。
能同时处理几张图纸？
一次上传一份 PDF，但一份 PDF 可以包含多页。多页图纸会按页分别渲染、编号并导出，单份报告的页码按钮用于切换。若需要多份独立报告，请分别上传。
为什么气泡位置和上次不一样？
每次保存或重新出图都会重算布局（按 8 方向 × 5 档距离做碰撞计分），当尺寸数量或气泡大小变化时，最优位置自然会变。编号与尺寸的一一对应关系不会改变，历史编号也不会乱序。
图纸上的符号显示成方框 / 问号？
这是字体缺字问题（多见于 ⌀、±、R 等符号）。系统在服务器上使用 Noto CJK 字体渲染，一般不会出现；若出现请在尺寸表里用文字代替（如把 ⌀ 写成「直径」），或联系管理员检查服务器字体。
帮助中心可以切换语言和主题吗？
可以。右上角「中文 / EN」切换语言，「🌙 / ☀️」切换深色 / 浅色主题，两个选择都会记在这台设备的浏览器里，下次打开保持不变。默认跟随系统偏好。
🔒数据与隐私
- 图纸与识别结果存放在部署本系统的服务器上（企业内网部署时不出内网），不上传任何第三方服务。
- 浏览器端只保存两项本地配置：报价单价参数与帮助中心的语言 / 主题偏好。图纸内容不会写入浏览器缓存。
- 报告以「图号 + 随机 ID」组织，删除报告会同步删除其全部产物文件。
- 如需清理历史报告释放磁盘，请在报告管理中心删除；批量删除前建议先下载需要留档的 XLSX 与 HTML。
💬还有疑问？联系我们
使用中遇到问题，或希望增加新功能，欢迎反馈给技术团队。为便于快速定位，请尽量附上：图号、出问题的页码、问题截图，以及「图纸信息」面板里的识别参数。