使用指南
修改文件之前，先读懂它。
测量点文件检查器帮助回答一个具体问题：这份点表的结构是否适合工作流的下一步？当你收到外业采集器的导出文件、准备 CAD 导入数据，或收到没有明确格式说明的点表时，都可以使用它。CogoKit 检查文本及所选字段，定位需要注意的源记录，但不判断测量值是否正确反映现场。
检查与编辑是两个独立步骤。所有点都保留在结果中，包括重复点号和有错误的记录。缺失值仍为空白，描述仍是原始业务数据，不会被改写成展示标签。这样便于对照报告和文件，解释记录为什么被标记。请根据结果明确修正源数据，再检查修改后的文件。
准备清晰可读的点文件
使用 UTF-8 编码的 CSV 或 TXT，以逗号、分号或制表符分隔字段。文件可以包含标题行和开头的 UTF-8 字节顺序标记。空行会统计后跳过，但非空记录不会因为出错而被丢弃。包含分隔符的描述应使用双引号包围，字段内部的双引号需连续写两次。支持正确引用的多行描述，并保留开始和结束行号。
当前最多接受 10 MiB、100,000 条点记录。无效 UTF-8、UTF-16 以及含空字符的二进制文本会被拒绝，不会猜测编码。如果采集器导出其他字符集，请在源软件中重新导出 UTF-8。读取失败不会生成部分成功的报告。大型项目可拆分为来源明确的小文件，并将文件名保留在检查报告中。
确认字段顺序、坐标轴与单位
检查前请指定点号、北坐标和东坐标列。源数据不包含高程或描述时，可以不映射这两列。常见的 PNEZD 依次为点号、北坐标、东坐标、高程、描述；PENZD 将东坐标放在北坐标之前。这些是文件布局，不是坐标参考系统。Autodesk 的 点文件文档 介绍了命名导入格式及各字段的解释方式。
自动预览会建议分隔符与已识别的列标题。无法识别标题时，会先按常见顺序显示，仍需你确认。检查器不会自动将 X、Y 映射为北坐标或东坐标，因为它们的含义取决于导出软件及其约定。如果只有这两个列名，请查看源说明或已知控制点。仅靠两列数字的大小无法可靠判断坐标轴。
平面单位和高程单位需要分别选择，可使用米、国际英尺或历史数据中的美国测量英尺。选择单位不会对坐标字符串进行乘除或修改。这两种英尺定义不同，旧文件应保留其记载的单位。 NIST 的美国测量英尺说明 介绍了该单位退出新工作使用的背景，同时说明历史资料的处理情况。本检查器不进行单位转换或基准转换。
选择符合交接要求的检查规则
点号缺失、平面坐标缺失、无效数值、引号格式错误和列数不一致均属于错误，受影响的记录不会计入当前规则下的可处理记录。坐标可以为负数或零，支持有限十进制数、正负号和科学记数法。当前不将千位分隔符或小数逗号视为有效数字格式，请使用小数点，并用文件分隔符分开字段。
下一步任务需要高程时，请启用“要求每个点都有高程”。关闭时，缺失高程只产生提示，记录仍可按二维数据处理；开启后，同一条记录会报错。无论开关如何，非数字的高程始终报错。可选的纯数字点号规则只允许数字，这是针对目标用途设置的局部规则，不代表兼容所有测量或 CAD 软件版本。
所有重复点号都会产生警告，不会覆盖、合并或重新编号。标识按原始文本精确比较：0012 与 12 不同，前后空格也会保留并单独提示。可选坐标与高程范围同样产生警告。端点包含在范围内，恰好等于最小值或最大值不算越界。比较使用未经显示舍入的解析值，范围警告仅要求复核，不证明外业测量有误。
可以亲自复现的完整示例
点击 试用示例 加载八个模拟点，标题采用 PNEZD 顺序。保持高程要求和纯数字点号规则关闭，使用逗号分隔，所有范围留空，并确认映射与单位。点 0012 在源文件第 4、5 行重复；第 6 行的 0014 缺少北坐标；第 7 行的 0015 没有高程。0011 的描述包含引号内的逗号，仍是一个有效字段。
预期结果为 共 8 条记录，7 条可处理，1 条被阻止。问题清单包含 1 个北坐标缺失错误、2 个重复点号警告、1 个高程缺失提示。重复记录仍计入可处理数量，因为警告不代表结构无法读取，但导入前仍需复核。启用高程要求后再次检查，高程缺失会变为错误，结果为 2 条被阻止、6 条可处理。任何缺失值都不会自动补零。
点位预览会绘制七个点，因为缺少北坐标的记录无法定位。选择图上的点可在表格中定位记录，选择表格行可查看准确的源文本。图中上北右东，横纵比例相同，不含底图，也不表示地理位置。较大文件只绘制前 1,000 条平面坐标有效的记录，检查与报告导出仍覆盖全部已接受数据。
结合上下文阅读检查结果
错误、警告和信息提示是不同的问题级别。同一记录可能有多个问题，因此问题数不一定等于记录数。记录状态取其最高问题级别。“可处理”仅表示没有触发已实现的错误规则，并不代表数据已批准、准确或适用于任意目标系统。没有发现问题的文件仍可能存在坐标轴颠倒、单位假设错误或坐标参考不适用的情况。
选择结果可查看原始行和字段。表格每页显示 25 条，筛选作用于完整结果。即使表格只展示已映射的测量字段，额外列也保留在记录中。修改输入文本、映射、单位或检查选项会使旧报告失效，避免把旧结果误当作新数据的检查结果。检查由后台任务执行，取消会终止当前检查并保留输入。
导出复核记录，明确保留原始数据
完整 JSON 报告包含工具版本、检查时间、来源名称、原始文本、标题、字段映射、单位、全部记录和问题。额外列及原始字段字符串均被保留，不作数值舍入。独立 CSV 包含源行号与问题解释。二者都用于复核，不会悄悄移除被阻止的点、改写描述或生成重新格式化的仪器文件。
问题 CSV 使用逗号分隔、带引号字段和 UTF-8 字节顺序标记。可能被表格软件解释为公式的文本会加上单引号，包括部分以符号开头的值。此保护用于表格复核，因此不能把问题清单作为原始点数据导入仪器。准确的原始值仍保留在 JSON 和源文本下载中。打印报告列出摘要、设置与全部问题，JSON 则是更完整的存档记录。
了解文件检查的能力边界
全部处理都在浏览器内存中完成，不上传文件，也不在浏览器本地存储中保存项目数据。你可以主动下载报告、恢复初始输入或清空会话。刷新页面同样会丢弃当前数据。当前没有配置离线应用缓存，因此不承诺安装后的离线运行。已下载副本是你掌握的普通文件，清空浏览器会话不会删除这些文件。
本工具不根据数值识别坐标参考、不与控制资料对比、不计算法定边界、不认证观测结果，也不能替代目标软件的导入测试。平面预览不能作为地理地图使用。如果交接依赖局部原点、高程基准、网格与地面关系或约定格式，请在检查之外确认并随项目保存。有效的结果应说明检查了什么，以及哪些部分仍需专业判断。