打开文件前先写数据契约
在小型数据字典中定义预期列名、类型、必填状态、单位、日期格式、小数分隔符和允许值。即使公式正确，错误单位或误解空值也会让结果失去意义。
契约版本和生产系统名称应随文件传递。新增或重命名列必须明确复核，不能静默推断。
- 列出表头和类型。
- 说明单位与时区。
- 写明缺失值策略。
通过抽样验证分隔符与引号
逗号、分号和制表符习惯因地区而异。带引号单元格中的分隔符、换行或转义引号会破坏简单拆分。
第一行看起来正确还不够，应抽查开头、中间和结尾；未闭合引号或列数变化必须产生明确错误。
结合列画像与缺失模式判断
把推断类型、唯一值比例、范围和空白率与列的预期角色比较。标识符重复与分类值重复并不是同一种问题。
缺失值可能按行组、来源系统或日期聚集。在用零填充前，应分析缺失机制及其对决策的影响。
通过独立计算验收单位转换
记录源单位、目标单位、转换因子、取整和显示精度。温度等带偏移的转换不只是乘法；货币需要当前汇率来源，超出静态单位工具范围。还应明确小数舍入发生在单行还是汇总阶段，因为两种顺序可能产生不同总计。
至少独立重算一行，测试零值、负值、极大值和精度边界，并比较转换前后的总量与记录数是否保持。若结果用于财务、医疗或合规决策，应由具备授权的人复核来源单位和机构规则。保存契约版本与合成样例，而不是敏感原始表格。
此工作流中的工具与职责
每个工具提供不同证据，任何单一输出都不能批准整个流程。请从合成示例开始，执行验收检查；超过边界时不要进入下一步。
- CSV 分隔符检测器
- CSV 列分析器
- CSV 缺失数据模式分析器
- 单位换算器
把指南转化为安全试用流程
使用真实资料前，请先在CSV 分隔符检测器中用合成数据试做《计算前建立 CSV 导入契约》的步骤。勾选状态只保留在当前标签页。
把指南转化为可重复的检查流程
请使用这套包含 4 个工具的检查计划来落实《计算前建立 CSV 导入契约》。目标：通过明确契约、列画像、缺失模式和单位转换验收表格导入，而不是依赖表面显示。 请先用安全示例代替真实数据，并记录每一步的预期结果与验收决定。
CSV 分隔符检测器
- 准备
- 加载安全示例或输入自己的数据。
- 执行
- 在设备端运行并检查错误、警告与指标。
- 验收检查
- 在目标环境和边界案例中验证输出。
- 预期输出
- 行列统计、规范化记录以及问题单元格位置. 按行一致性评估逗号、分号、制表符与竖线。
CSV 列分析器
- 准备
- 粘贴数据或加载安全示例。
- 执行
- 运行处理并检查警告。
- 验收检查
- 在目标系统中验证结果。
- 预期输出
- 行列统计、规范化记录以及问题单元格位置. 在本地汇总列类型、缺失值、唯一性、范围与样本分布。
CSV 缺失数据模式分析器
- 准备
- 添加带表头的 CSV 数据。
- 执行
- 检查缺失值标记和模式。
- 验收检查
- 结合源系统、抽样和业务规则作出决定。
- 预期输出
- 匹配位置、捕获组以及需要复核的复杂度信号. 同时分析列和行的缺失模式，而不只是统计空值。
单位换算器
- 准备
- 单位、周期和计入假设明确的数值处理敏感真实数据前，请先用合成示例确认格式。
- 执行
- 运行设备端处理。公式、中间值、舍入规则和除零边界均保持可见。
- 验收检查
- 验收检查：通过手工示例、零值、负值、极值、单位换算以及权威规则进行比较结果不构成专业财务、医疗、法律或科学建议。
- 预期输出
- 计算结果、所用公式、单位和情景假设. 换算长度、质量、温度、数据容量和体积。
CSV 分隔符检测器适用以下边界：请在目标系统核验架构、编码和数据丢失假设。 如果未满足该条件，请勿把输出传递到工作流的下一步。
落实《计算前建立 CSV 导入契约》时，请记录工具名称、所选设置、浏览器版本，以及“发布前可审计质量检查”的接受或拒绝理由，而不是敏感内容。这样既能重复检查，也不会复制真实数据。