shuangying0001-beep/field-aligner

field-aligner —— 字段名模糊匹配与对齐

把任意来源的字段名，映射到你定义的规范字段 key。中文/英文/驼峰/下划线混用都认得。 纯函数实现（Node ESM，零依赖）。词汇表可注入，默认带一份通用示例词表。

适用场景

• 对接 ERP / 开放平台 / 内部中台：对方字段名和你库里的字段名不一致
• 多数据源合并：不同系统同一含义字段叫法不同
• 文档 / 表格结构化：把表头映射到标准字段

提供的函数

函数	说明
normalize(name)	归一化：小写 + 去 _-空格
buildVocabulary(input)	把 {key:[aliases]} 或 [{key,aliases}] 规范为统一结构
matchField(name, vocabulary, opts?)	单字段匹配，返回 {key, matched, score, via}
batchMatchFields(names, vocabulary, opts?)	批量匹配
DEFAULT_VOCABULARY	通用示例词表（电商/通用字段）

匹配策略：

1. 精确：归一化后 key 或任一别名完全相等 → via:'exact'
2. 模糊：子串包含（重叠越长分越高），分数 ≥ fuzzyThreshold（默认 0.6）→ via:'fuzzy'
3. 都不中 → {key:null, matched:false, via:'none'}

用法

import { matchField, batchMatchFields, DEFAULT_VOCABULARY } from './scripts/field-aligner.mjs';

// 1) 用默认词表
const r = matchField('商品标题', DEFAULT_VOCABULARY);
// => { key: 'title', matched: true, score: 1, via: 'exact' }

// 2) 注入你自己的词表
const myVocab = {
  order_no:   ['订单号', '单号', 'orderNumber'],
  buyer_name: ['买家', '收货人', 'buyer'],
};
batchMatchFields(['订单号', '买家', '备注'], myVocab);
// => { 订单号:{key:'order_no',...}, 买家:{key:'buyer_name',...}, 备注:{key:null,...} }

自测

node scripts/field-aligner.mjs --selftest