# 校对台 v1.0.1 使用说明

1. 打开 https://tools.cymx.link，或解压离线包后双击 index.html。点击“体验报名／签到样例”可直接看到 7 条已知问题。
2. 选择基准表和待核对表，确认工作表、表头行与预览；将字段一一对应，勾选稳定的编号或多个组合字段作为匹配键。
3. 点击“开始核校”。按类型或关键词筛选结果；“导出全部结果”包含所有问题，“导出当前筛选”包含全部筛选命中项，不仅当前页。Excel 报告中另有核校说明、范围和规则。

## 如何理解结果
- 新增：右表有、左表没有。缺失：左表有、右表没有。
- 重复键：任一侧同一匹配键出现多次，每条源记录单独列出。
- 重复键关联行：另一侧虽然唯一，但对侧重复，不能自动配对。
- 空键：组成匹配键的任一字段为空，不自动配对。
- 字段变化：成功唯一匹配后，映射字段值不同；每个变更字段一条，所以条数不等于人数。
- 映射字段之外的内容不比较。跳过完全空白的数据行并显示数量；隐藏行参与核校。

## 规则与文件
保存规则不包含数据行，只包含列结构、映射、匹配键、工作表选择和选项。重新载入前需要选择结构相符的文件。文件来源名称和列名只显示为文本，不作为可执行内容。

载入失败的规则不会改变当前表头、映射及核校结果。结果统计卡可直接筛选问题类型，“清除筛选”恢复全部结果；Excel 报告也支持在表头筛选。报告单元格最多32,767字符，超过会明确指出位置并停止导出，不截断原值。

CSV 支持 UTF-8、GB18030，按文本读取。CSV 原始行号是逻辑记录号；引号包围字段内部换行不增加记录号。字段数不齐时保留全部列，缺值补空并警告。使用英文逗号作为分隔符。

XLSX 文本原值保留；普通数字取存储数值，纯零补位格式（例如 00000）保留前导零。Excel 若已损坏长编号精度或剥掉前导零，本工具无法还原，应回到源数据校验。数值长整数会提示可能丢失精度。

日期按 Excel 日期系统转成无时区日期文本；CSV 日期不会猜测日月顺序。公式只使用保存的缓存值，缓存可能过期；无缓存或错误单元格需要在 Excel/WPS 重算保存或粘贴为值。不会重算公式、刷新链接或运行宏。

## 边界
仅支持 XLSX/CSV，不支持 XLS、XLSM、加密文件；单文件 10MiB；工作簿最多20张工作表；每个选中表最多20,000条数据行、100列、500,000个表格位置（包括表头前区域）；表头行1—100；问题记录最多100,000条。超限明确拒绝，不截断。XLSX ZIP目录声明解压总量限制80MiB；工作线程超60秒可取消，超时会清空本次状态。

合并单元格和多级表头先整理成单行表头数据表。首张表不适合时，可以切换其他工作表或修改表头行。近期桌面Chrome/Edge为主要验证环境；手机适合查看，不承诺所有手机处理上限规模。

## 隐私与离线
文件仅在浏览器内存中处理，页面没有文件上传接口或内容遥测。页面 CSP 禁止网络连接，依赖随文件提供。刷新或“清空数据”会清除本次页面数据，不删除已下载报告。网络访问站点本身会产生普通服务器访问日志，但不包含你导入的表格内容。

离线包解压后即可双击 index.html；无需Python、Node或网络。下载报告通过浏览器保存。样例文件在 downloads 目录；报告是虚构数据。组织使用仍应遵守自己的数据和软件管理要求。

## 固定范围定制
目前未开放在线下单或支付。需要定制时向提供本工具的人说明脱敏样表、匹配规则、输出、规模和支持范围，确认验收与维护期限后再约定费用。不保证商业收益，不替代财务审计或业务审批。

技术组件：SheetJS CE 0.20.3，Apache-2.0；许可附于 SHEETJS-LICENSE.txt。程序不依赖运行时外部 CDN。
