超声波离线分析系统是一款面向工业无损检测领域的专业软件，用于对超声波探伤仪导出的 CSV 数据文件进行批量解析、信号分析、合格性判定和报告生成。软件支持四通道同时处理，内置闸门判定引擎和可视化波形浏览功能。
CH1-CH4 四通道同时解析，独立闸门判定，结果一目了然
矩阵式热力图，红/绿/灰三色直观展示所有工件的检测结果
HTML 模板 + 占位符变量，适配不同客户的报告格式需求
从创建到完成全程追踪，自动检测缺失件号，支持历史对比
数据闸门 / 方案闸门一键切换，满足不同判定标准需求
四通道波形同步显示，支持键盘翻页、缩放和缺陷标记
硬件绑定许可证，支持永久授权和限时授权，安全可靠
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 / 11（64 位） |
| 运行时 | .NET 8.0 运行时（随安装包提供） |
| 内存 | 4 GB 及以上 |
| 磁盘空间 | 200 MB（不含数据文件） |
| 屏幕分辨率 | 1920 × 1080 及以上 |
首次启动软件时，系统会显示软件激活对话框。软件采用 RSA 加密授权机制，需完成激活后方可正常使用。
.lic 格式）。
.lic 文件后，点击对话框中的"选择许可证文件"按钮，浏览并选择收到的许可证文件。
| 项目 | 说明 |
|---|---|
| 许可证文件格式 | .lic（RSA 签名的加密文件，不可手动编辑） |
| 绑定方式 | 硬件绑定（CPU + 硬盘序列号），许可证仅限本机使用 |
| 有效期 | 由供应商设定，支持永久授权或限时授权 |
| 存储位置 | %AppData%\UltrasonicAnalyzer\license.lic |
| 版本类型 | 标准版 / 专业版（由许可证决定） |
| 状态 | 提示颜色 | 说明 |
|---|---|---|
| 未激活 | 橙色 | 显示"尚未激活 — 请导入许可证文件"，可点击"退出"关闭软件 |
| 已激活 | 绿色 | 显示客户名称和到期日期，"继续使用"按钮可用 |
| 即将过期 | 黄色 | 到期前 30 天开始显示过期提醒，建议及时联系供应商续期 |
| 已过期 | 红色 | 许可证已失效，需重新获取许可证文件 |
%AppData%\UltrasonicAnalyzer\license.lic 文件，否则需重新导入.lic 文件以下步骤将引导您完成从安装到生成第一份报告的完整流程。
欢迎页是软件的主界面，提供全局概览和快捷操作入口。
点击"+ 新建批次"后弹出创建对话框，包含以下信息分组：
| 分组 | 字段 | 说明 |
|---|---|---|
| 产品信息 | 产品名 必填 | 产品或工件名称 |
| 批号 | 批次编号，可留空自动生成 | |
| 标准 | 检测标准编号（如 GB/T 4162） | |
| 牌号 | 材料牌号 | |
| 规格 | 工件尺寸（mm） | |
| 数量 | 预期检测总件数 | |
| 冶炼信息 | 炉号 | 熔炼炉号 |
| 锭号 | 钢锭编号 | |
| 节号 | 锭节编号 | |
| 重量/卷号 | 重量或卷号 | |
| 检测设置 | 数据目录 必填 | 点击"浏览"选择存放 CSV 文件的文件夹，目录自动绑定到此批次 |
| 定尺 | 勾选后输入目标长度，系统自动判定工件长度是否达标 | |
| 状态 | R态 / M态 / 黑皮 / 光亮 / 其他 | |
| 检测方案 | 从预设方案中选择（含闸门高度和探头参数） | |
| 检测人员 / 日期 | 记录操作员和检测日期 |
已创建的批次信息可随时修改。在欢迎页批次列表中，点击批次卡片右下角的"✏ 编辑"按钮，打开编辑对话框。编辑模式下：
创建批次时必须选择数据目录，目录创建后自动绑定到该批次。系统确保同一时间只有一个活跃批次绑定到同一个目录，防止数据混淆。目录绑定后：
底部批次列表展示所有历史批次，支持以下操作：
| 功能 | 操作 | 说明 |
|---|---|---|
| 字段搜索 | 左侧下拉选择搜索字段 | 支持按 全部、批次号、产品名称、批号、规格、炉号、锭号、检测人员 字段搜索 |
| 关键词搜索 | 输入框输入关键词 | 实时过滤，模糊匹配 |
| 状态筛选 | 右侧下拉选择 | 全部 / 进行中 / 已完成 |
| 统计 | 点击"统计"按钮 | 查看全局检测统计信息 |
| 对比 | 勾选多个批次后点击"对比" | 展示不同批次的合格率、工件数量等差异 |
每个批次卡片右下角提供快捷操作按钮：
| 按钮 | 功能 | 说明 |
|---|---|---|
| ✏ 编辑 | 修改批次信息 | 修改产品信息、冶炼信息、检测设置等 |
| ✕ 删除 | 删除批次 | 删除批次及其分析结果（需确认） |
| 完成 | 标记完成 | 将进行中的批次标记为已完成状态 |
| 卡片点击 | 查看批次详情 | 点击卡片主体进入批次详情页，含 QR 码 |
数据加载与分析在批次创建过程中自动完成：
.csv 文件并开始分析在分析结果页面，底部右侧提供"刷新"按钮。当绑定目录中有新 CSV 文件添加时，按钮会自动高亮并显示新文件数量（如"刷新 (5 新文件)"）。点击即可增量分析，不会重建已有结果。
分析完成后进入结果页面，顶部显示四个统计卡片，下方为筛选栏和数据表格。
| 筛选类型 | 操作 | 说明 |
|---|---|---|
| 时间筛选 | 选择起止日期和时间 | 精确到小时和分钟，筛选特定时间段的检测数据 |
| 异常筛选 | 点击"仅异常"按钮 | 快速过滤出所有不合格的记录，切换为"显示全部"可恢复 |
| 闸门切换 | 点击"数据闸门/方案闸门"按钮 | 切换合格性判定的闸门来源（详见第 5 章） |
表格列包含：文件名、测长(m)、检测时间、通道数、CH1-CH4 最大值、合格状态。
分析结果页面底部提供以下快捷操作：
| 按钮 | 功能 | 说明 |
|---|---|---|
| 查看详情 | 生成详情报告 | 打开选中文件的详情报告，含 SVG 波形、通道数据、批次信息 |
| 波形显示 | 波形浏览 | 打开选中文件的四通道波形页面 |
| 缺陷分布图 | 矩阵总览 | 打开整个批次的缺陷分布矩阵图 |
| 刷新 | 增量分析 | 目录有新文件时显示"刷新 (N 新文件)"，点击增量分析 |
| 生成统计报告 | PDF 报告 | 使用当前模板生成批次统计 PDF 报告 |
波形页面以四通道上下堆叠的方式展示每个工件的完整 A 扫描波形。
缺陷分布图以矩阵形式展示整个批次所有工件在各通道的检测结果，是快速发现批量缺陷的关键工具。
| 工件 | CH1 | CH2 | CH3 | CH4 |
|---|---|---|---|---|
| #001 | ✓ | ✓ | ✓ | ✓ |
| #002 | ✓ | ✗ | ✓ | ✓ |
| #003 | ✓ | ✓ | ✓ | ✓ |
| #004 | — | — | — | — |
预设方案存储了检测所需的闸门高度和探头参数，用于统一控制合格性判定标准。
菜单 工具 → 预设方案管理，或创建批次时选择检测方案。
| 配置项 | 说明 |
|---|---|
| 方案名称 | 唯一标识，如"标准方案-A"、"特殊方案-B" |
| 产品信息 | 关联的产品名称和规格 |
| 闸门高度 | CH1-CH4 四通道各自的闸门高度值 |
| 探头信息 | 品牌、序列号、频率、镜片、焦距 |
菜单 报告模板 → 模板配置 打开模板管理界面。
{{变量名}} 作为占位符，系统自动替换为实际数据。| 类型 | 说明 | 模板目录 |
|---|---|---|
| 统计报告模板 | 批次级别的汇总统计报告 | Templates/ |
| 详情报告模板 | 单文件详情，含 SVG 波形和通道数据 | Templates/ |
| 报告类型 | 内容 | 入口 |
|---|---|---|
| 统计报告 | 批次总体统计、合格率分析、时间分布 | 分析结果页 → "生成统计报告" |
| 详情报告 | 单文件分析详情、内嵌 SVG 波形图、四通道数据、闸门标记、探头参数、QR 码 | 分析结果页 → "查看详情" |
通用变量（统计报告 & 详情报告均可使用）：
| 变量名 | 含义 |
|---|---|
{{BatchPO}} / {{batch_po}} | 批次号 |
{{Product}} | 产品名 |
{{LotNo}} | 批号 |
{{Spec}} | 标准 |
{{Grade}} | 牌号 |
{{Size}} | 规格 |
{{TotalCount}} | 总件数 |
{{PassRate}} | 合格率 |
{{Inspector}} | 检测人员 |
{{TestDate}} / {{test_date}} | 检测日期 |
{{FurnaceNo}} / {{furnace_no}} | 炉号 |
{{HeatNo}} / {{heat_no}} | 锭号 |
{{SectionNo}} / {{section_no}} | 节号 |
{{WeightCoilNo}} / {{weight_coil_no}} | 重量/卷号 |
{{Quantity}} / {{quantity}} | 数量 |
{{Condition}} / {{condition}} | 状态（R态/M态/黑皮/光亮/其他） |
{{PresetName}} / {{preset_name}} | 检测方案名称 |
详情报告专用变量：
| 变量名 | 含义 |
|---|---|
{{piece}} | 工件编号 |
{{report_time}} | 报告生成时间 |
{{measurement_length}} | 测长（m） |
{{sn}} | 序列号 |
{{fixed_length}} | 定尺判定结果 |
{{scan_date}} | 扫描时间 |
{{is_qualified}} | 合格状态 |
{{ch1_max}} ~ {{ch4_max}} | 各通道最大值 |
{{svg_ch1}} ~ {{svg_ch4}} | 各通道 SVG 波形图 |
{{ch1_probe_brand}} | CH1 探头品牌 |
{{ch1_probe_freq}} | CH1 探头频率 |
{{ch1_probe_lens}} | CH1 探头镜片 |
{{ch1_probe_focal}} | CH1 探头焦距 |
| CH2-CH4 同理：ch2_probe_brand / ch3_probe_freq / ch4_probe_lens 等 | |
在欢迎页点击"统计"按钮，查看所有批次的汇总数据，包括总检测量、整体合格率、时间趋势等。
在批次列表中勾选多个批次（左侧复选框），点击"对比"按钮，系统生成对比视图，展示不同批次的合格率、工件数量等指标差异。
点击批次卡片进入批次详情页，页面自动生成 QR 二维码。QR 码内容包含以下关键字段，方便扫码快速追溯：
| QR 码字段 | 来源 |
|---|---|
| Spec | 标准 |
| HeatNo | 锭号 |
| Grade | 牌号 |
| Size | 规格 |
闸门判定是合格性评定的核心。系统支持两种闸门来源，可一键切换。
使用 CSV 文件中原始记录的闸门高度值。适用于遵循仪器设定标准的场景，保留现场探伤仪的原始判定参数。
使用预设方案中配置的闸门高度值。适用于统一判定标准的场景，如客户要求所有批次使用同一闸门值进行复评。
在分析结果页面筛选栏中，点击"数据闸门"/"方案闸门"切换按钮：
在波形显示页面，闸门线以水平虚线形式叠加在波形上方。当使用方案闸门时，波形会同时显示数据闸门线和方案闸门线，方便对比。
| 快捷键 | 功能 | 适用页面 |
|---|---|---|
| Ctrl + O | 选择文件目录 | 全局 |
| Ctrl + Q | 退出程序 | 全局 |
| ← | 上一个文件波形 | 波形显示页 |
| → | 下一个文件波形 | 波形显示页 |
软件支持从超声波探伤仪导出的标准 CSV 格式文件。
.csv（不区分大小写）CH-1 格式（带横杠），不是 CH1。文件名按数字排序，对应工件编号。
首次使用需要先完成软件激活（详见第 2 章），然后点击"+ 新建批次"，在创建批次时选择包含 CSV 文件的数据目录，系统会自动开始分析。
常见原因：① 许可证文件与本机不匹配（更换了硬件或复制了其他电脑的许可证）；② 许可证已过期；③ 许可证文件损坏。请确认机器码是否正确，重新联系供应商获取许可证。详见第 2 章。
请检查：① 文件扩展名为 .csv；② 通道名使用 CH-1 格式（带横杠）；③ 文件未损坏或被其他程序占用。
可能是闸门高度设置过高。请在"工具 → 预设方案管理"中检查方案闸门值，或切换到"数据闸门"使用原始值判定。
在"报告模板 → 模板配置"中管理。建议点击"打开目录"直接用文本编辑器修改 HTML 模板文件，使用 {{变量名}} 占位符插入动态数据。完整变量列表请参见 4.7 节。
模板管理中可添加多个模板文件。每个客户可独立维护一套模板，切换时在模板列表中选择对应模板即可。系统同时管理"统计报告模板"和"详情报告模板"两种类型。
在分析结果页面，系统持续监控数据目录。当有新文件时，"刷新"按钮自动高亮并显示新文件数量。点击后仅分析新增文件，不会重新处理已有数据。
创建批次时勾选"定尺"并输入目标长度（mm）。分析过程中，系统会自动检查每个工件的测量长度是否满足定尺要求，不满足的工件将标记为不合格。
表示该工件编号对应的 CSV 文件在数据目录中不存在（例如工件尚未检测），以灰色标识。缺失件号在批次追踪面板中也会提示。
QR 码用于批次快速追溯，包含标准、锭号、牌号、规格等关键字段。在批次详情页自动生成，可用手机扫描读取信息。
菜单 帮助 → 使用说明 可打开本手册的 HTML 版本（如已生成 PDF 版本则优先打开 PDF）。也可通过 帮助 → 关于 查看版本信息和快速操作指引。
可以。在欢迎页批次列表中，点击批次卡片右下角的"✏ 编辑"按钮即可修改产品信息、冶炼信息和检测设置等字段。
详情报告使用内嵌 SVG 矢量波形，需要使用现代浏览器（Chrome、Edge、Firefox）打开。如果用旧版 IE 打开可能无法正常显示。建议使用浏览器直接打开或通过"预览"功能查看。
不能。许可证与本机硬件（CPU + 硬盘序列号）绑定，更换硬件后机器码会变化。需重新获取机器码并联系供应商生成新的许可证文件。
软件会在到期前 30 天弹出提醒。请联系软件供应商续期，获取新的 .lic 许可证文件后在激活对话框中重新导入即可。
| 参数 | 规格 |
|---|---|
| 软件版本 | v1.21.1 |
| 开发平台 | .NET 8.0 + WPF |
| 支持通道 | 4 通道（CH-1 ~ CH-4） |
| 数据格式 | CSV（逗号/制表符分隔） |
| 报告格式 | PDF（内嵌 SVG 波形） |
| 模板格式 | HTML + 占位符变量 |
| 数据存储 | SQLite 本地数据库 |
| 波形格式 | Canvas 实时渲染 / SVG 矢量 |
| 授权方式 | RSA-2048 硬件绑定许可证（.lic 文件） |