# @finbheara/names 中文文档 规范地址：https://npmcn.com/package/%40finbheara/names/ 版本：0\.31\.0 npm 元数据更新时间：2026-11-07T09:36:14.586Z 中文译文更新时间：2026-11-14T18:58:32.118Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40finbheara/names 原文对照：https://npmcn.com/package/%40finbheara/names/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：2.2 MB，106 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=22\.3 - 运行依赖：1 个 - 首次发布：2026-09-30T19:28:30.018Z - 最新版本发布：2026-11-07T09:36:14.390Z - 近 30 天下载量：3357（2026-10-15 至 2026-11-13，npm 官方下载统计） - 已发布版本数：34（近 12 个月 34 个） ## 中文简介 个人、学校和地名、姓氏-粒子词汇、分类词和人名正常化词典 ## 安装 ```sh npm install @finbheara/names ``` 也可以使用：`pnpm add @finbheara/names`、`yarn add @finbheara/names`、`bun add @finbheara/names` ## README # @ finbhea/ 名称 实际打印的人名: 解析、 正常化、 比较、 分解 从学校和地名. - **拼音词典** (单位:千美元)`names.txt`: ~15 000人 姓名、地点、学校和 多词短语,每个标出它是什么. - **姓氏-粒子词汇**数字 : `Mac`, (中文(简体) ), `Ní`, (中文(简体) ), `O`, (中文(简体) ), `van`, (中文(简体) ), `de` 剩下的,还有.. 每个显示一个拼写. - **人名规范化**: 一个打印单元格, a `PersonName` 出来,有一个 canonial 显示窗体,文件密钥和匹配密钥. - **一个词组分类器**:这个字符串是一个人,一个学校或一个地方,在哪里 人结束 学校开始? - **计量工具**:通过上述所有内容运行一串名称流,并查看其内容 无法识别. 它建立在爱尔兰舞蹈比赛的结果单上 一个舞者的名字 以 `O'RERVTON, MOIRA`, (中文(简体) ), `Moira ORervton` 财务报告和审定财务报表 `Moira O Rervton`和学校的名字 连接在舞者身上 规则一般为盎格鲁语,爱尔兰语和欧洲语名. ```sh npm install @finbheara/names ``` 无害环境管理,节点为 22.3 或 Bun为 1.4.3. MIT。 无条目进口a `node:` 模块,因此每个条目 用于浏览器或工人的捆绑 `Lexicon.load`,它读取文件,需要节点 或Bun在呼叫时间. ## 入境点 只导入您使用的; `/lexicon`, (中文(简体) ), `/particles`, (中文(简体) ), `/normalize` 财务报告和审定财务报表 `/phonetic` 从不装入 分类器的开花桌子. | 导入 | 什麽 | | --- | --- | | `@finbheara/names/normalize` | `PersonName`,它的工厂,比较,编曲,列表 | | `@finbheara/names/lexicon` | `names.txt` 解析:旗帜、多词短语、拼写、角色 | | `@finbheara/names/particles` | 粒子词汇 | | `@finbheara/names/classifier` | 人/学校/地点分类和分类 | | `@finbheara/names/phonetic` | 双元音:一个单词作为密钥听起来如何 | | `@finbheara/names/measure` | 普查和分类评价 | | `@finbheara/names` | 以上各项 | | `@finbheara/names/names.txt` | 原始词典 | ## 将名称正常化 ```ts import { isNoNamePrint, personName } from "@finbheara/names/normalize"; const n = personName("WYRKOW NÍ MHAOLVARNA"); n.nn2; // "NiMhaolvarna< spelling lookup; null for rules only traditions: null, // no tradition lookup parenthetical: (aside) => // what "( … )" or "\" … \"" in a name cell means aside === "Ontario" ? { refuse: "refuse-location-alias" } : "strip", capacity: 100_000, // memo size; 0 disables the memo }); names.parse("Anna (Ontario) Mailtina").isPerson(); // false names.parse("Lena (Xiaoyu) Zumock").nn2; // "Zumock<` 为文件打印相同的 名称单元格,每行1个。 规格是 `docs/NAME-NORMALIZATION.md`。 。 。 . ### 将拆分器对应于已公布的指纹 A 类 `Last, First` 打印自己的姓氏. `buildAnchorIndex` 从 打印其文件宣布其顺序, `anchoredSurname` 找到打印 同一名称的顺序 `primedVerdict` 说是否一个拆分者放置了边界 在这里。 分裂者是一个争论,所以故意错误的控制(`edgeOnlySplit`, (中文(简体) ), `compoundLessSplit`)显示栏可以失败. `unprimedTally` 按顺序猜测 扣留的申报,以及 `clearsUnprimedFloor` 将其平衡率与 `UNPRIMED_FLOOR`。 。 。 . ```ts import { anchoredSurname, buildAnchorIndex, edgeOnlySplit, primedVerdict, splitPersonName, } from "@finbheara/names/normalize"; const prints = [ { name: "van der Quell, Pealling", declared: "Last, First" as const }, { name: "Pealling van der Quell", declared: "First Last" as const }, ]; const anchor = anchoredSurname(prints[1], buildAnchorIndex(prints)); // "vanderquell" primedVerdict(prints[1], anchor, splitPersonName).verdict; // "consistent" primedVerdict(prints[1], anchor, edgeOnlySplit).verdict; // "inconsistent" ``` ### 两个名字如何关联 ```ts import { createGivenFamilyList, createNameIndex, createNameKinship, givenFamilyTable, nameKinship, personName, } from "@finbheara/names/normalize"; nameKinship(personName("Kate Smith"), personName("Katherine Smith")); // { relation: "candidate", via: ["given-family"], reason: "middles-equal", gateSafe: true } nameKinship(personName("Mary Larson"), personName("Mary Conley-Larson")).via; // ["surname-part"] nameKinship(personName("Mary Larson"), personName("Mary Carlson")).reason; // "surname-differs" nameKinship(personName("Kate M Smith"), personName("Katherine Conley-Smith")).via; // ["surname-part", "given-family", "middle-absent"] nameKinship(personName("Connor Smith"), personName("Conor Smith")).via; // ["given-variant"] nameKinship(personName("Evie Smith"), personName("Genevieve Smith")); // { relation: "candidate", via: ["given-family-not-gate"], reason: "middles-equal", gateSafe: false } nameKinship(personName("Beth Smith"), personName("Bethany Smith")); // the extended family list // { relation: "candidate", via: ["given-maybe"], reason: "middles-equal", gateSafe: false } nameKinship(personName("Grace Zumock"), personName("Ailbhe Grace Zumock")); // a middle name used // { relation: "candidate", via: ["given-middle"], reason: "middles-equal", gateSafe: false } // four opt-in readings, each off by default: a suffix one side lacks, a run of initials, // a hyphenated first name with its first half spelt another way, an Irish surname form const wide = createNameKinship({ suffixAbsent: true, initialRuns: true, joinedVariants: true, surnameForms: true, }); wide(personName("Lena Zumock"), personName("Lena Zumock II")).via; // ["suffix-absent"] wide(personName("JR Zumock"), personName("Zumock, Joseph R.")).via; // ["given-initials"] wide(personName("Ann Marie Zumock"), personName("Zumock, Anne-Marie")).via; // ["given-joined", "given-family"] wide(personName("Lena Nolan"), personName("Ó Nualláin, Lena")).via; // ["surname-form"] // the given-name tolerance is a list of providers, asked in order const tableOnly = createNameKinship({ given: [givenFamilyTable] }); tableOnly(personName("Beth Smith"), personName("Bethany Smith")).reason; // "given-differs" const common = createNameKinship({ given: [givenFamilyTable, createGivenFamilyList({ maxTier: 1 })], // common forms only }); common(personName("Maggie Smith"), personName("Marjorie Smith")).reason; // "given-differs" const index = createNameIndex("nn3"); // a NameMap with a tolerant lookup index.set(personName("Mary Conley-Larson"), 1).set(personName("Mary Carlson"), 2); index.get(personName("Mary Larson")); // undefined: get stays exact index.related(personName("Mary Larson")); // [{ name: Conley-Larson<(); blocker .add("row-1", personName("Mary Larson")) .add("row-2", personName("Mary Conley-Larson")) .add("row-3", personName("Mary Larson")) .add("row-4", personName("Mary Carlson")); for (const { a, b, kinship } of blocker.pairs()) console.log(a.id, b.id, kinship.relation); // row-1 row-3 same // row-1 row-2 candidate // row-2 row-3 candidate ``` `candidate` 它说两个指纹可能就是一个人. `via` 列表中 耐用对子,和 `gateSafe` 当其中任何一个都是一扇门时,是虚假的 自己承认吧. A 类 `?` (或U+FFFD)在平面上是一个丢失的被捕获的字母. 关卡保持什么打印 保留,以及 `nameKinship` 读取每个 `?` 当指纹有分歧时 没有它: ```ts import { lostLetterForm, nameKinship, personName } from "@finbheara/names/normalize"; nameKinship(personName("Zoë Bérard"), personName("Zo? B?rard")); // { relation: "candidate", via: ["lost-letter"], reason: "middles-equal", gateSafe: false } personName("Orlaith N? Varraigh").nn2; // "NiVarraigh<("nn3", { spanishNames: true }); index.set(personName("Ana Inés Varrondo Quelmar"), 1); index.related(personName("Inés Varrondo")).map((m) => m.value); // [1] ``` 由OCR从扫描页读取的名字可能带有识别器混淆的格言:一个小写 `l` 资本 `I`, (中文(简体) ), `rn` 页:1 `m`。 。 。 . `ocrConfusion(a, b)` 比较两个字,回答: 运行它读作他们的可信任, `[]` 如果文字已经同意作为NN3读取,或 `null`它不产生任何结果,也不产生关键:`OCR_CONFUSABLES`页:1 读取 glyph, 包含大小写, 包没有设定阈值, 所以调用者计算 经营或拒绝一个班级本身. `createNameKinship({ ocrConfusables: true })` 读取字段 字段,关系会说 `different`,通过 `ocr-glyph` (从来不是安全的大门),和每 回答它用它携带的运行作为 `confusions`· ; `createNameIndex` 财务报告和审定财务报表 `createNameBlocker` 选择相同的选项, 因此每个匹配都带有相同的数组 : ```ts import { OCR_CONFUSABLES, createNameIndex, createNameKinship, ocrConfusion, personName, } from "@finbheara/names/normalize"; ocrConfusion("Quamby", "Quarnby"); // [{ class: "rn-m", a: "m", b: "rn", at: 3 }] ocrConfusion("lvarra", "Ivarra"); // [{ class: "I-l", a: "l", b: "I", at: 0 }] ocrConfusion("LVARRA", "IVARRA"); // null: a capital L is no capital I's confusable ocrConfusion("Quarnby", "QUARNBY"); // []: equal as NN3 reads them const ocr = createNameKinship({ ocrConfusables: true }); ocr(personName("Kate Quamby"), personName("Kate Quarnby")); // { relation: "candidate", via: ["ocr-glyph"], reason: "middles-equal", gateSafe: false, // confusions: [{ class: "rn-m", a: "m", b: "rn", at: 3, field: "surname", index: 0 }] } const noRn = createNameKinship({ ocrConfusables: OCR_CONFUSABLES.filter((r) => r.class !== "rn-m"), }); noRn(personName("Kate Quamby"), personName("Kate Quarnby")).relation; // "different" const index = createNameIndex("nn3", { ocrConfusables: true }); index.set(personName("Kate Quarnby"), 1); index.related(personName("Kate Quamby")).map((m) => m.kinship.confusions); // [[{ class: "rn-m", … }]] ``` ### 只有一个名字,一个有名的 ```ts import { createNameRoster, givenOnlyName, personName } from "@finbheara/names/normalize"; givenOnlyName("Lena").nn2; // "< personName(p)), ); roster.match(givenOnlyName("Mairead")); // { kind: "unique", name: Rervton< given-name-tables.json # or bunx ``` `--output json` 财务报告和审定财务报表 `--schema 1` 是默认的。 PRINTED表格是合同:a 只要软件包能保持它的形状 新的形状就是新的 计划,所以今天写的命令 继续工作。 表格中存储的文件是 不是它的一部分。 司马一是 ```jsonc { "$comment": [ /* how to read it */ ], "table": "given-name", "schema": 1, "variants": { "CONNOR": ["CONOR"], … }, // canonical -> its other spellings "families": { "CATHERINE": ["KATE", …], … }, // the curated gate tier: root -> forms "notAtGate": ["MEGAN", …], // forms a gate must not admit as forms "extended": { "BETHANY": { "BETH": 1 }, … } // root -> form -> tier (1 common .. 3 rare) } ``` 读它像图书馆一样 `$comment` 说:读出每个名字 拼写第一; 两个名称仅在共享根时关联, 一个表单满足 EveryY root it 坐在下面,没有什么是过渡性的(`EVIE` 开会 `EVE` 财务报告和审定财务报表 `EVA`,不分别满足 (其他部分)。 一个共享的根是 `given-family` 除非一个名字只作为 `notAtGate` 形式; 名字是根本身总是通过。 一个 `extended` 双层是稀有的 成员,根数为 1. 为避免比较每对,索引每个名称下 它的每个根 和比较在根, 从来没有一个根 每个名字. ## 密码和屏蔽键 ```ts import { doubleMetaphone } from "@finbheara/names/phonetic"; import { initialsBlock, metaphoneBlocks, personName, surnameBlock } from "@finbheara/names/normalize"; doubleMetaphone("SMITH"); // ["SM0", "XMT"] primary, secondary doubleMetaphone("KAVANAGH"); // ["KFNK", "KFNK"] const n = personName("Moira O'Rervton"); surnameBlock(n.surnameKey()); // "ORERVTON" A-Z letters only metaphoneBlocks(n.surnameKey()); // ["ARRF"] initialsBlock(n.givenFields()[0] ?? "", n.surnameKey()); // "MO" ``` `doubleMetaphone` 普通口音密钥:印刷名和转写口语 语言被问到同样的问题。 三个块键桶名值 比较和决定无;每个答案 `null` (或 `[]`无所事事的地方 桶装上,所以一个自相残杀 永远不能把空心. ### 作为数据库列的名称 ```ts import { NAME_COLUMNS, nameColumns, personName } from "@finbheara/names/normalize"; NAME_COLUMNS; // ["nn0", …, "nn4", "surname_key", "given_key", "blk_surname", "blk_initials", // "blk_metaphone", "blk_metaphone_alt"] nameColumns(personName("Moira O'Rervton")); // { nn0: "Moira O'Rervton", …, nn3: "ORERVTON<=22\.3。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @finbheara/names 可以商用吗？ @finbheara/names 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @finbheara/names 的下载量有多少？ 根据 npm 官方下载统计，@finbheara/names 在 2026/10/15 – 2026/11/13 这 30 天内被下载 3,357 次，日均约 112 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @finbheara/names 还在维护吗？ 最新版本 0\.31\.0 发布于 2026/11/07（7 天前）；至今共发布 34 个版本，其中过去 12 个月发布了 34 个；首次发布于 2026/10/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。