一、下载与激活
1.1 下载软件
LabelCV 为 Windows 桌面软件，无需安装复杂的运行环境。您可以通过官网首页的「免费下载」按钮获取最新版本。
下载后得到 LabelCV_V2.x.x.exe 可执行文件，直接双击即可运行，无需安装。首次启动可能需要几秒钟加载组件，请耐心等待。
1.2 试用机制
LabelCV 提供 7 次免费试用，每次启动软件即消耗一次试用次数。试用期间您可以使用软件的全部功能，包括 AI 识别、手工框选、自动排版和 PDF 导出。
首次运行会弹出「软件授权」窗口，显示剩余试用次数。点击「继续试用」即可进入软件主界面。试用次数耗尽后，需要通过导入授权文件激活软件。
1.3 如何获取机器码
在授权窗口中，您可以看到一串 16 位大写字母与数字组成的机器码（HWID）。点击右侧的「复制」按钮即可将机器码复制到剪贴板。
机器码根据您的主板序列号、CPU ID 和 BIOS 信息生成，每一台电脑对应唯一的机器码。请将机器码发送给客服获取专属授权文件。
1.4 导入 License 激活文件
收到客服发送的 license.lic 文件后，按以下步骤激活：
- 打开 LabelCV 软件，在授权窗口中点击「导入授权文件 (.lic)」按钮。
- 在弹出的文件选择对话框中，找到并选中
license.lic文件。 - 系统会自动验证授权文件的签名、机器码匹配和有效期。验证通过后提示「激活成功」。
- 激活成功后，软件会自动将授权文件保存到系统隐藏目录，后续启动无需重复导入。
⚠️ 注意事项
- 授权文件绑定机器码，不可在多台电脑间共用。
- 请勿手动修改
license.lic文件内容，否则签名校验失败。 - 如更换硬件（主板/CPU），需重新申请授权文件。
1.5 联网验证
LabelCV 支持联网验证机制。启动软件时，系统会自动向授权服务器验证当前设备状态。如果网络不可达，软件会回退到本地授权文件离线验证，不影响正常使用。
二、核心操作流程（五步完成排版）
LabelCV 将标签排版任务拆解为五个清晰的步骤，从左下角的操作控制面板依次执行即可。以下为每一步的详细说明。
1 Step 1：导入图纸 / 源文件
点击左下角操作区的「1️⃣ 导入原稿 (PDF)」按钮，选择您的图纸文件。
支持的文件格式
- PDF：推荐格式，支持多页，单页/多页均可。LabelCV 支持高保真 PDF 渲染，保证标签清晰度不损失。
- 其他格式（如 AI / CDR / DWG）请先导出为 PDF 后再导入。
导入成功后，PDF 的每一页会被渲染为高清图片（600 DPI），显示在右侧实时预览区。下方的页面导航按钮可切换查看不同页。
2 Step 2：设置排版参数
在左下角「排版设置」区域，根据您的实际需求调整以下参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
| 最大画幅 | 原材料纸张的最大宽度/高度（正方形），单位 mm | 300 mm |
| 页面边距 | 标签距离纸张边缘的最小距离 | 5 mm |
| 标签间距 | 同一组内相邻标签之间的间隔 | 6 mm |
| 组间距 | 不同版面/组之间的间隔距离 | 5 mm |
| 多页水平/竖直尺寸 | 多页排版时，各页尺寸要求是否相同 | 水平相同 / 竖直无要求 |
| 绘制组别序号 | 在排版预览中是否显示组别编号 | 开启 |
参数修改后即时生效，无需手动保存。软件会自动将设置持久化到 config.json 文件中。
3 Step 3：框选识别与提取
这是 LabelCV 的核心步骤。点击「2️⃣ AI 分析定位」启动智能识别，或选择「2️⃣.5 手工分析定位」进入纯手工模式。
模式 A：AI 智能分析（推荐）
点击「AI 分析定位」后，软件会将渲染的页面图片发送给配置的视觉大模型，由 AI 自动分析页面中的标签区域、尺寸和数量。每页分析完成后，结果会在右侧预览区以红色矩形框标出。
使用此模式前，请先在菜单栏「设置 → AI 模型配置」中填写 API Key、Base URL 和模型名称。支持 OpenAI 兼容接口。
模式 B：纯手工框选
无需配置 AI，直接进入手工模式。在右侧预览区：
- 按住 Ctrl 键 + 鼠标拖拽：在画面上绘制矩形框，框出每个标签区域。
- 按住 Ctrl 键 + 拖拽矩形边缘/角落：调整已绘制框的大小和位置。
- 右键点击矩形框：弹出菜单，可编辑属性（标签编号、宽度 mm、高度 mm、数量、所属版面）、拆分组，或删除区域。
- 双击矩形框：快速编辑该标签的属性。
辅助功能
- 排除模式：点击「🛑 排除模式」按钮，在页面上拖拽出红色虚线框，标记干扰区域（如标题栏、备注文字），这些区域将在提取时被自动排除。
- 从模板导入：如果常用标签尺寸固定，可从内置模板库快速导入标签定义。
- 暂存当前调整：点击「💾 暂存当前调整」保存当前工作进度，避免意外丢失。
💡 提示：框选完成后，系统会使用智能图像识别技术，在每个 ROI 区域内自动识别独立标签的精确边界并完成裁切提取。提取结果以绿色半透明矩形预览。
4 Step 4：一键自动排版生成
确认所有标签已正确提取后，点击「3️⃣ 刷新排版预览」按钮，系统将自动执行排版算法。
排版算法原理
LabelCV 使用智能排版算法，将标签按所属版面分组，在设定的原材料纸张尺寸内进行最优排列。算法会考虑以下约束：
- 标签实际物理尺寸（宽 mm × 高 mm）
- 纸张边距、标签间距、组间距
- 同版面内标签的排列顺序（按原稿空间位置行优先）
- 各版面的排列优先级（可在「管理版面」中调整顺序）
排版预览会在右侧实时视图区展示每一页的标签布局，同时在左上角表格中显示所有提取到的标签及其详细信息（页码、ID、尺寸、数量、所属版面）。悬浮在缩略图上可查看大图。
5 Step 5：导出 PDF
预览满意后，点击「4️⃣ 导出为 PDF」按钮，选择输出路径，软件将生成最终排版结果文件。
输出内容
- 排版 PDF：所有标签按最优布局排列，每页对应一张原材料纸张，可直接交付印刷或生产。
- 排版报告 JSON / PDF：自动生成的详细报告，包含源文件信息、标签总类型数、总页数、面积利用率、每种标签的尺寸与数量等统计数据。
输出引擎支持矢量级精确截取与重新拼版，保持标签图形的矢量质量不损失，可直接交付印刷生产。
三、常见问题与排错 (FAQ)
Q1：AI 识别没有结果，或者识别出的标签位置不准确？
可能原因：
- 未配置 AI 模型，或 API Key 无效。请检查「设置 → AI 模型配置」中的 API Key、Base URL 和模型名称是否正确。
- 网络连接问题导致 API 调用超时。请确认网络通畅，可尝试 ping 一下 API 服务器地址。
- 图纸内容过于复杂，AI 未能正确理解。建议切换到「手工分析定位」模式，手动框选标签区域。
解决方案：可以在 AI 识别结果的基础上手工修正 —— 在预览区用 Ctrl+拖拽调整红色框，或直接使用「2️⃣.5 手工分析定位」进入纯手工模式。
Q2：提示「许可已过期」或「试用次数已耗尽」？
可能原因：
- 7 次免费试用已用完。每次启动软件消耗一次，关闭后再打开算一次。
- 年度授权已到达截止日期。License 文件中的 expiry 日期已过。
解决方案：联系微信客服购买或续期授权。续期后会收到新的 license.lic 文件，重新导入即可。
Q3：提示「系统时间异常或被篡改」？
原因：LabelCV 内置了时间防篡改机制。如果检测到系统时间被人为回退（例如试图绕过授权到期日），会拒绝运行。
解决方案：将 Windows 系统时间恢复为正确的当前日期和时间，重启软件即可。
Q4：导入文件后无法正常显示或报错？
可能原因：
- 文件不是有效的 PDF 格式。LabelCV 目前仅支持 PDF 作为源文件。
- PDF 文件损坏、加密或有密码保护。
- PDF 中包含的图像分辨率过低，导致标签提取效果不佳。
解决方案：请使用 Adobe Illustrator / CorelDRAW 等工具将源文件导出为高质量的 PDF（建议 ≥300 DPI），再导入 LabelCV。
Q5：导出 PDF 失败，或导出的排版结果为空白？
可能原因：
- 框选区域中的标签未被正确提取。检查左上角表格中是否有提取到的标签数据。
- 排版参数设置不合理：纸张太小不足以容纳标签、间距设置过大导致溢出等。
- 系统缺少必要的运行库组件（极少见，安装最新 VC++ 运行库即可解决）。
解决方案：先点击「刷新排版预览」确认排版结果正确，再导出。如预览正常但导出异常，请检查输出路径是否有写入权限。
四、技术支持
扫码添加微信客服
咨询购买 ｜ 技术支持 ｜ 开具发票
邮箱：shawn.cute@qq.com
工作日 9:00-18:00 在线响应