# xmflswood/pinyin-match

拼音匹配，具备分词、缩写、多音字匹配能力，支持繁体版

Repository: https://github.com/xmflswood/pinyin-match
Canonical: https://ross.abutalabs.com/products/pinyin-match
Language: JavaScript
License: MIT
License Family: permissive
Last push: 2025-12-07T04:29:40+00:00

## Health v2 (maintenance only)
Score: 57/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 56, release rhythm 35, longevity 100
- inputs: {"age_days": 2982, "days_push": 269, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1070, forks 128 (observed 2026-08-28T04:03:28.053633+00:00)

## What it is
A JavaScript library for fast pinyin-based matching of Chinese text, supporting polyphonic characters, traditional Chinese, and initial-letter abbreviations. It returns match position information usable for highlighting matched characters.

## Use cases
- search a contact list by typing pinyin initials
- fuzzy filter Chinese list items using pinyin abbreviations
- match Chinese text with polyphonic characters correctly
- highlight matched characters in search results
- support traditional Chinese pinyin search
- build a pinyin search box for a web app

## When to choose
- you need fast pinyin matching in JavaScript with polyphone and traditional Chinese support
- you need match position info for highlighting
- you need high performance on long polyphonic strings

## When to avoid
- you need full pinyin-to-hanzi conversion rather than matching
- your project is not in JavaScript or Go
- you need segmentation of arbitrary text rather than search matching

## Facets
- artifact type: library
- maturity: active
- function: search-engine, nlp, parser
- domain: frontend, web-development
- platform: browser
- tags: pinyin, chinese, fuzzy-matching, polyphonic-characters, traditional-chinese, text-search, highlighting, natural-language-processing, search, nodejs, javascript

## Member repositories
- xmflswood/pinyin-match (main) score 57

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:28.053633+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:54:14.720351+00:00, confidence not recorded.
  - readme: https://github.com/xmflswood/pinyin-match (fetched 2026-08-28T04:03:28.053633+00:00, sha cc0c27aaf80e)
  - registry_npm: https://registry.npmjs.org/pinyin-match (fetched 2026-08-29T12:56:18.187584+00:00, sha c6abac2a36d5)
- Data as of 2026-08-30T08:39:29.467469+00:00.