CDET · QGIS 插件
面向建库与质检的吸附 / 拓扑检测，以及按空间关系给字段命名。多图层、多模式、可导出命名方案。作者：有余。
本页介绍可在 QGIS 里安装的插件。插件在你自己的电脑上运行，不经过有余服务器。可下载 ZIP 手动安装；源码可在 GitHub 公开。页面含详细功能说明，便于搜索检索。
- 目录 CDET
- 点线面关系
- 特殊拓扑检测
- 命名方案
也可在 QGIS「插件 → 从 ZIP 安装」选择该文件。线上只更新插件包时，用 upload_qgis_zip.ps1 替换 downloads 里的 ZIP 即可。
正式页面：https://yuyouhui.online/tools/qgis/cdet/
这个插件解决什么问题
道路、管线、宗地建库时，最常见的不是「有没有画」，而是「有没有按容差接上」： 点是否落在线上、线端是否相接、面是否盖住点、有没有悬挂、交叉却没打断。 CDET 把这些检测做成可调容差的工作台，并支持把空间命中结果写回属性字段。
吸附检测
- 多图层：被检图层 vs 参考图层，按几何类型组合判断关系
- 容差吸附：点-线、线-点、线-线、面-点、点-面等常见关系
- 可提取「已吸附（命中）」或未命中要素，便于返工
- 线-点等场景支持聚合/连续段等更细规则（见插件内说明）
特殊检测（质检向）
- 悬挂端点：线端悬空未接到参考
- 交叉未打断：线交叉但未在交点打断
- 无效几何：自相交、未闭合等无效形状
- 面积筛选：按面积阈值挑出异常面
- 尖角 / 回头线 / 过密顶点：线形质量问题
- 点与点过近：重复点或过密采样
- 重复要素：用空间索引加速大图层比对
空间命名模式
- 按空间关系决定「是否命中参考」，命中后写入参考字段或规则值
- 模式标题按「【类别】一句话」组织，便于业务人员选择
- 支持 K / N / 比例等参数（选中后可调）
- 多匹配策略：取最近、取重叠最多、拼接去重、取出现最多、最小/最大等
- 命名方案：多子任务打包，可导入导出 JSON
适合谁搜这些词
QGIS 吸附检测、拓扑质检、悬挂点检查、交叉未打断、管线接点检查、 点是否在线上、面内点检测、空间关系写字段、建库拓扑工具。
English summary
Snap / topology oriented detection for vector layers, plus spatial naming write-back. Special checks: hanging endpoints, unsplit crossings, invalid geometry, near-duplicate points, and more.
怎么用
- 下载本页 ZIP，在 QGIS「从 ZIP 安装插件」
- 打开 CDET，选择被检图层与参考图层，设置吸附容差
- 选「吸附检测」或「特殊检测」，或进入空间命名模式配置写字段规则
- 执行后查看命中结果；需要时提取已吸附/未吸附要素，或预览修正
常见问题
CDET 和拓扑检查器什么关系？
互补。CDET 更偏「相对参考图层是否吸附/空间命中」和写字段命名，不是整库拓扑规则全集。
容差怎么理解？
要素是否算「贴上」按你设的吸附容差判断，单位跟工程/图层坐标系一致。
特殊检测包含哪些？
悬挂端点、交叉未打断、无效几何、面积筛选、尖角/回头线/过密顶点、点与点过近等。
空间命名能批量吗？
可以。支持命名方案：多条子任务、导入导出 JSON，一次跑多条规则。
需要额外库吗？
不需要，纯 PyQGIS。