{"ok": true, "site": "https://xingyuan.beer", "contract_version": "key-golden/1", "key_version": 1, "key_digest": "04a7872db8c93607ee3462fffb1645b385d83ca06a3b932ecabe9628689f3506", "key_format": "<normalized title>|<sorted normalized artists joined by '/'>", "key_rule": ["NFKC normalize, then casefold.", "Drop anything inside brackets: (), （）, [], 【】 — including version tags such as (Live) and (剪辑版).", "Drop a 'feat.' / 'ft.' / 'featuring' tail from the title.", "Keep only ASCII letters/digits and CJK; drop every other character, then join the sorted, normalized artist names with '/'."], "key_stability": "The key is derived from the raw title and artists, so it is stable across snapshots as long as those two stay identical after normalization. A retitled track, an added artist, or an alias (周杰伦 vs Jay Chou) produces a different key — treat a key change as a new identity, not as the same song renamed.", "known_gaps": ["'X - Live' (dash suffix, no brackets) normalizes to 'xlive' and does not merge with 'X'.", "Separators inside one artist string are not split: 'R!N/Gemie' stays one artist, so it does not collide with artists ['R!N', 'Gemie'].", "Artist aliases (周杰伦 / Jay Chou) are not merged: the site undercounts cross-platform presence rather than inventing a merge.", "Bracket stripping also merges different recordings of the same title (a 65-second edit with the full-length original): the key is not a recording identity."], "cases": [{"title": "晴天", "artists": ["周杰伦"], "key": "晴天|周杰伦", "case": "base", "note": "Reference case: CJK title + single artist, punctuation stripped from the key only."}, {"title": "晴天 (Live)", "artists": ["周杰伦"], "key": "晴天|周杰伦", "case": "merge", "note": "Bracket content is dropped: live and studio versions share a key (deliberate for chart aggregation; raw rows are still stored for audit)."}, {"title": "晴天 (剪辑版)", "artists": ["周杰伦"], "key": "晴天|周杰伦", "case": "merge", "note": "A 65-second edit also merges with the full-length original. Known over-merge: never use the key alone to decide 'same recording'."}, {"title": "晴天 - Live", "artists": ["周杰伦"], "key": "晴天live|周杰伦", "case": "gap", "note": "Known gap: a dash suffix is not a bracket, so it does not merge with 晴天."}, {"title": "七里香 feat. 杨瑞代", "artists": ["周杰伦"], "key": "七里香|周杰伦", "case": "feature", "note": "A feat./ft./featuring tail is dropped from the title; the guest artist is not appended to the artist set."}, {"title": "合作曲", "artists": ["甲", "乙"], "key": "合作曲|乙/甲", "case": "artist-order", "note": "Artist order does not matter: names are a sorted set."}, {"title": "合作曲", "artists": ["乙", "甲"], "key": "合作曲|乙/甲", "case": "artist-order", "note": "Same collaboration, reversed order, same key."}, {"title": "Call your name (Gv)", "artists": ["澤野弘之", "R!N/Gemie"], "key": "callyourname|rngemie/澤野弘之", "case": "gap", "note": "Real production row (2026-11-10): the slash inside one artist string survives."}, {"title": "Call your name (Gv)", "artists": ["澤野弘之", "R!N", "Gemie"], "key": "callyourname|gemie/rn/澤野弘之", "case": "gap", "note": "Same song from a platform that splits the collaboration: a second identity. This is the live undercount the key version exists to make visible."}, {"title": "@someone创作的原声", "artists": [], "key": "someone创作的原声|", "case": "not-a-song", "note": "Douyin sound titles are not song titles; the @-sound text stays, so it cannot collide with a real title."}, {"title": "ＡＢＣ", "artists": ["周杰伦"], "key": "abc|周杰伦", "case": "unicode", "note": "NFKC + casefold: full-width and half-width ASCII collapse to the same key."}, {"title": "   ", "artists": [], "key": "", "case": "empty", "note": "No title and no artist yields an empty key; such rows never join an aggregate."}, {"title": "夜曲", "artists": ["周杰伦"], "key": "夜曲|周杰伦", "case": "alias", "note": ""}, {"title": "夜曲", "artists": ["Jay Chou"], "key": "夜曲|jaychou", "case": "alias", "note": "Known non-merge: the Chinese and English names of one artist make two identities."}], "use": "Join tracks across snapshots and boards with charts.json's dedupe_key; run the cases above against your own implementation before trusting a join.", "related": "https://xingyuan.beer/charts.json"}