项目管理
图像、人工标注与识别结果都保存在项目里。当前项目：—
项目编码与统一命名
项目编码—
图像名形如 P26010801-001-ORI.jpg：特征码 ORI=原始、REC=已识别、VOID=作废。改编码会把项目内图像一起改名。
图像与识别
项目图像的缩略图、上传、批量识别、下载与作废都在「02 图像导入」面板的「开始分析」上方。
导入图像
载入岩体表面照片或内置样例。图像只在本地解码，不上传到任何外部服务。
项目图像
0 张
勾选后「下载原图 / 下载识别结果」会打包成 ZIP（浏览器会问保存位置）；作废把特征码改成 VOID，恢复按是否有识别结果回到 REC / ORI。
批量任务
勾选项目里的图（不勾 = 全部）。两个子任务可分开跑：只识别出掩膜、不做量测；量化必须在识别之上。
点表格里的任意一行可把该图载入画布并回看识别 / 量化结果；勾选后可批量删除结果、重做或保存汇总。
尺寸标定
把像素换算成毫米。没有标定块时保持 fixed（1 px = 1 mm），统计值会标注为“像素当量”。
在画布上依次点击两点；点击后会填入上面的 P1 / P2 输入框。
自动标定会在图像中寻找一对彩色标定块（需要几何后端）。
未标定
图像加工
分割前的图像处理：先做对比度增强（Retinex / CLAHE / 直方图均衡 …），再做尺寸调整或尺寸校正。加工后的图会一路传给分割、骨架、量测和重建。
预处理链（按顺序执行）
顺序即执行顺序：先去噪再增强（bilateral → CLAHE）与反过来结果不同。CLAHE 适合低对比度岩面；Retinex 适合阴影/光照不均；直方图均衡可能放大噪声。
尺寸链（调整与校正）
「mm-per-px」是尺寸校正：按目标物理分辨率重采样（例如统一到 0.1 mm/px），标定比例会按比例自动换算，长度与宽度仍然可比。
裂缝分割
分割器输出 0–1 概率图，阈值二值化后再由修整器清除碎点、填补小孔。
运行后端
概率图只用于预览分割质量，不参与几何统计。
流程：分割阶段
参数默认值来自插件注册表；留空表示使用插件默认。
骨架提取
骨架化把掩膜压成 1 px 中心线；拓扑阶段统计节点、端点、分叉、环与连通分量。
min_branch_px 控制短枝过滤（像素）；simplify_eps_px 控制折线简化强度。
几何量测
宽度算法把骨架点映射到局部法向宽度（mm）；长度阶段汇总折线长度。
本步统计
统计由“按配方重建”写入；单张图跑完即更新。
执行
用左侧六阶段的选择跑完整流水线（与对比页同一实现）。
裂缝重建
导出当前结果。CSV 带 UTF-8 BOM，可直接用 Excel 打开。
导出格式
先完成一次分析或配方重建。
人工标注（画笔）
画笔
标注与当前图像同尺寸；保存后可再次载入，并给出 IoU / Dice / Precision / Recall。
算法对比
勾选 2–8 条配方（含“当前选择”），同一张图并排跑；表格数值来自 compare_recipes。
已选0 / 8
配方来自 configs/recipes；也可以只勾“当前选择”看左侧参数的效果。
知识宝库
对本地 papers/ 全文做离线 BM25 检索（bigram + 标题加权），不联网。
论文库列出 `papers/` 下的全部原文；知识库 94 篇里 30 篇存了 PDF 副本，其余只做全文检索。
试验创新
把已申请的发明专利算法接进本系统做应用验证。成熟度未到 L3 前，结果只用于研究对比，不进入正式报告。
成熟度分级
晋级按"人工复核通过"的案例数累计：L1 试验 ≥1 例，L2 验证 ≥10 例，L3 成熟 ≥30 例。只有 L3 允许进入自动分析主流程。
专利算法
运行前需先在第 05–07 步得到折线结果；未跑识别时会自动执行一次当前配方。
隧道影像拼接
![拼接全景]()
只做相邻帧顺序拼接，不做回环与光束法平差。
验证记录
点「通过 / 驳回」记录人工复核；累计够例数后可「申请晋级」。
专利来源与本版实现边界
- 专利 01 工程结构裂缝表示方法及 JSON 数据结构 → 裂缝树 / 多叉堆 / 区间统计
- 专利 02 基于知识图谱的结构裂缝数字化模型 → 端节点—裂缝主体—端节点图谱 + 邻接表/矩阵
- 专利 03 基于几何图神经网络的裂缝结构性能评估 → 几何加权消息传递 + 损伤五级
- 专利 05 基于无人机摄影技术的裂缝特征及时获取 → 透镜成像 GSD 与标定误差
- 隧道巡检无人机专利 → 相邻影像 SIFT/ORB 匹配 + 单应拼接（本版只做拼接部分）
- 专利 04（山区汇水流量）与裂缝系统关联弱，登记为"关联扩展 / 暂缓"