MoviePilot/tests/test_metamusic.py

from pathlib import Path
from typing import Optional

import pytest

from app.core.meta import (
    MetaMusic,
    MusicNameContext,
    MusicNameParseResult,
    MusicNameParser,
    MusicNamePattern,
    MusicNameRegistry,
)
from app.core.metainfo import MetaInfo, MetaInfoPath


def parse_title(title: str) -> MetaMusic:
    """构造种子/文件名标题解析结果，供识别断言复用。"""
    return MetaMusic(org_string=title, title=title, parse_title=True)


def test_music_name_registry_supports_dynamic_pattern_and_parser(monkeypatch):
    """外部程序可独立注册命名模式和解析器，并在使用后完整注销。"""
    pattern_name = "test_program"
    parser_name = "test_program_parser"

    def match_program(context: MusicNameContext):
        """匹配测试程序的双冒号命名。"""
        if not context.text.startswith("PROGRAM::"):
            return None
        parts = context.text.split("::")
        return parts if len(parts) == 3 else None

    def parse_program(context, matched):
        """把测试程序命名解析为艺术家和标题。"""
        _prefix, artist, title = matched.payload
        return MusicNameParseResult(
            title=title,
            artists=[artist],
            year=context.year,
        )

    MusicNameRegistry.register_pattern(
        MusicNamePattern(pattern_name, match_program, priority=1000)
    )
    MusicNameRegistry.register_parser(
        MusicNameParser(parser_name, (pattern_name,), parse_program, priority=1000)
    )
    try:
        monkeypatch.setattr(
            "app.core.meta.metamusic.rust_accel.parse_metamusic",
            lambda *_args, **_kwargs: (_ for _ in ()).throw(
                AssertionError("自定义注册表不应调用 Rust")
            ),
        )
        context = MusicNameContext(
            raw="PROGRAM::周杰伦::晴天",
            normalized="PROGRAM::周杰伦::晴天",
            text="PROGRAM::周杰伦::晴天",
            artists=(),
        )
        matched = MusicNameRegistry.match_pattern(context)
        parser = MusicNameRegistry.match_parser(matched)

        assert matched.pattern_name == pattern_name
        assert parser.name == parser_name

        # FLAC 由公共层剔除，扩展解析器只需处理自身命名结构。
        meta = parse_title("PROGRAM::周杰伦::晴天 FLAC")
        assert meta.artists == ["周杰伦"]
        assert meta.title == "晴天"
        assert meta.audio_format == "FLAC"
    finally:
        MusicNameRegistry.unregister_parser(parser_name)
        MusicNameRegistry.unregister_pattern(pattern_name)

    assert parser_name not in {parser.name for parser in MusicNameRegistry.get_parsers()}
    assert pattern_name not in {pattern.name for pattern in MusicNameRegistry.get_patterns()}


def test_music_name_registry_same_name_replacement_falls_back_to_python(monkeypatch):
    """同名替换内置解析器时应保留 Python 动态扩展语义。"""
    original = next(
        parser for parser in MusicNameRegistry.get_parsers()
        if parser.name == "fallback"
    )

    def parse_replacement(context, _matched):
        """为同名替换用例返回固定解析结果。"""
        return MusicNameParseResult(
            title=f"Python:{context.text}",
            artists=["扩展解析器"],
        )

    replacement = MusicNameParser(
        "fallback",
        ("fallback",),
        parse_replacement,
    )
    MusicNameRegistry.register_parser(replacement, replace=True)
    try:
        monkeypatch.setattr(
            "app.core.meta.metamusic.rust_accel.parse_metamusic",
            lambda *_args, **_kwargs: (_ for _ in ()).throw(
                AssertionError("同名替换解析器时不应调用 Rust")
            ),
        )

        meta = parse_title("自定义曲名")

        assert meta.title == "Python:自定义曲名"
        assert meta.artists == ["扩展解析器"]
    finally:
        MusicNameRegistry.register_parser(original, replace=True)

    assert MusicNameRegistry._uses_default_components()


def test_parse_query_uses_rust_and_maps_music_fields(monkeypatch):
    """MetaMusic 公共查询入口应使用 Rust 并回填完整核心字段。"""
    calls = []
    parsed = {
        "title": "晴天",
        "artists": ["周杰伦"],
        "album": "叶惠美",
        "year": 2003,
        "disc_number": 1,
        "track_number": 3,
        "audio_format": "FLAC",
        "audio_lossless": True,
        "bit_depth": 24,
        "sample_rate": 96000,
        "bitrate": 2304000,
    }

    def parse_metamusic(title, artists=None, year=None):
        """记录 Rust wrapper 调用并返回完整音乐字段。"""
        calls.append((title, artists, year))
        return parsed

    monkeypatch.setattr(
        "app.core.meta.metamusic.rust_accel.parse_metamusic",
        parse_metamusic,
    )

    meta = MetaMusic.parse_query("周杰伦 - 晴天 FLAC 24bit 96kHz")

    assert calls == [("周杰伦 - 晴天 FLAC 24bit 96kHz", None, None)]
    assert {
        key: getattr(meta, key)
        for key in parsed
    } == parsed


def test_apply_title_preserves_existing_fields_from_rust(monkeypatch):
    """Rust 解析只应补充空字段，不覆盖标签或文件后缀证据。"""
    monkeypatch.setattr(
        "app.core.meta.metamusic.rust_accel.parse_metamusic",
        lambda *_args, **_kwargs: {
            "title": "Rust 曲名",
            "artists": ["Rust 歌手"],
            "album": "Rust 专辑",
            "year": 2026,
            "disc_number": 2,
            "track_number": 8,
            "audio_format": "AAC",
            "audio_lossless": False,
            "bit_depth": 16,
            "sample_rate": 48000,
            "bitrate": 320000,
        },
    )

    meta = MetaMusic(
        org_string="source.flac",
        title="source",
        artists=["标签歌手"],
        album="标签专辑",
        year=2003,
        disc_number=1,
        track_number=3,
        audio_format="FLAC",
        bit_depth=24,
        sample_rate=96000,
        bitrate=2304000,
        parse_title=True,
    )

    assert meta.title == "Rust 曲名"
    assert meta.artists == ["标签歌手"]
    assert meta.album == "标签专辑"
    assert meta.year == 2003
    assert meta.disc_number == 1
    assert meta.track_number == 3
    assert meta.audio_format == "FLAC"
    assert meta.audio_lossless is True
    assert meta.bit_depth == 24
    assert meta.sample_rate == 96000
    assert meta.bitrate == 2304000


def test_apply_title_falls_back_when_rust_returns_none(monkeypatch):
    """Rust wrapper 不可用时应完整执行现有 Python 命名解析。"""
    monkeypatch.setattr(
        "app.core.meta.metamusic.rust_accel.parse_metamusic",
        lambda *_args, **_kwargs: None,
    )

    meta = MetaMusic.parse_query("周杰伦 - 晴天 FLAC 24bit 96kHz")

    assert meta.title == "晴天"
    assert meta.artists == ["周杰伦"]
    assert meta.audio_format == "FLAC"
    assert meta.bit_depth == 24
    assert meta.sample_rate == 96000


def test_metainfo_audio_suffix_remains_authoritative_with_rust(monkeypatch):
    """音频文件后缀应优先于标题中的演唱会音频编码标记。"""
    calls = []

    def parse_metamusic(title, artists=None, year=None):
        """模拟 Rust 从标题规格中识别出 AAC。"""
        calls.append((title, artists, year))
        return {
            "title": "S.H.E十七音乐会",
            "artists": ["S.H.E"],
            "year": 2018,
            "audio_format": "AAC",
            "audio_lossless": False,
        }

    monkeypatch.setattr(
        "app.core.meta.metamusic.rust_accel.parse_metamusic",
        parse_metamusic,
    )
    filename = "S H E - S H E十七音乐会 2018 WEB-DL 1080P AVC AAC-FHDMv.flac"

    meta = MetaInfo(filename)

    assert calls == [(filename.removesuffix(".flac"), None, None)]
    assert meta.title == "S.H.E十七音乐会"
    assert meta.artists == ["S.H.E"]
    assert meta.audio_format == "FLAC"
    assert meta.audio_lossless is True


def test_metainfo_path_uses_rust_once_and_keeps_python_directory_context(
        monkeypatch,
):
    """音频路径只应用 Rust 解析一次文件名，目录线索仍由 Python 补齐。"""
    calls = []

    def parse_metamusic(title, artists=None, year=None):
        """记录路径中的 Rust 文件名解析并返回曲目字段。"""
        calls.append((title, artists, year))
        return {
            "title": "我的地盘",
            "artists": [],
            "track_number": 1,
            "audio_format": "AAC",
            "audio_lossless": False,
        }

    monkeypatch.setattr(
        "app.core.meta.metamusic.rust_accel.parse_metamusic",
        parse_metamusic,
    )
    path = MetaInfoPath(
        Path("/music/周杰伦 - 七里香 (2004) [FLAC]/01.我的地盘.flac")
    )

    assert calls == [("我的地盘", None, None)]
    assert path.title == "我的地盘"
    assert path.track_number == 1
    assert path.album == "七里香"
    assert path.artists == ["周杰伦"]
    assert path.album_artist == "周杰伦"
    assert path.year == 2004
    assert path.audio_format == "FLAC"
    assert path.audio_lossless is True


@pytest.mark.parametrize(
    ("raw", "artists", "title", "year", "audio_format"),
    [
        (
            "The Beatles - Vinyl Collection【2020】【CD】【FLAC分轨】",
            ["The Beatles"],
            "Vinyl Collection",
            2020,
            "FLAC",
        ),
        (
            "Primeval - Forged In Earth【2026】【WEB】【FLAC分轨】(24/48bit)",
            ["Primeval"],
            "Forged In Earth",
            2026,
            "FLAC",
        ),
        (
            "Professor Green - Alive Till I'm Dead 2010-FLAC 分轨-nbarock",
            ["Professor Green"],
            "Alive Till I'm Dead",
            2010,
            "FLAC",
        ),
        (
            "Togenashi Togeari 5th One Man Live Moments of Sound 2025 "
            "1080p BluRay x265 10bit FLAC 2.0-ADE",
            [],
            "Togenashi Togeari 5th One Man Live Moments of Sound",
            2025,
            "FLAC",
        ),
        (
            "田震 - 田震 (1996) FLAC {HRS-004-2}",
            ["田震"],
            "田震",
            1996,
            "FLAC",
        ),
        (
            "[2022.02.23] 中恵光城 - SELENiTE -Mitsuki Nakae Works Best Album- "
            "[CD][FLAC+CUE+LOG+BK][KDSD-01049]",
            ["中恵光城"],
            "SELENiTE -Mitsuki Nakae Works Best Album",
            None,
            "FLAC",
        ),
        (
            "[260123] 映画「超かぐや姫！」劇中曲「超かぐや姫！ 」 "
            "[48kHz/24bit][FLAC]",
            [],
            "映画「超かぐや姫!」劇中曲「超かぐや姫! 」",
            None,
            "FLAC",
        ),
        (
            "[Audio-4U] 茶太 — Chata 1.0 (flac)",
            ["茶太"],
            "Chata 1.0",
            None,
            "FLAC",
        ),
    ],
)
def test_apply_title_real_site_music_samples(
        raw: str,
        artists: list[str],
        title: str,
        year: Optional[int],
        audio_format: str,
):
    """真实站点音乐种子标题应剔除公共干扰并保留有效命名字段。"""
    meta = parse_title(raw)

    assert meta.artists == artists
    assert meta.title == title
    assert meta.year == year
    assert meta.audio_format == audio_format


@pytest.mark.parametrize(
    ("raw", "artists", "title", "year"),
    [
        (
            "Aimer-Aimer Hall Tour 2022 ''Walpurgisnacht'' Live at "
            "TOKYO GARDEN THEATER Blu-ray 1080p AVC LPCM 2.0",
            [],
            "Aimer-Aimer Hall Tour ''Walpurgisnacht'' Live at TOKYO GARDEN THEATER",
            2022,
        ),
        (
            "MANATSU NO ZENKOKU TOUR 2021 FINAL! IN TOKYO DOME "
            "Blu-ray 1080p AVC LPCM 2.0",
            [],
            "MANATSU NO ZENKOKU TOUR FINAL! IN TOKYO DOME",
            2021,
        ),
        (
            "Rainie Yang - Ban Shu Xuan Yan 2008 DVD 480i MPEG-2 MPEG-2",
            ["Rainie Yang"],
            "Ban Shu Xuan Yan",
            2008,
        ),
        (
            "SARD UNDERGROUND LIVE TOUR 2025 FANTASY "
            "Blu-ray 1080p AVC LPCM2.0",
            [],
            "SARD UNDERGROUND LIVE TOUR FANTASY",
            2025,
        ),
        (
            "Kylie: Tension Tour Live 2026 2160p NF WEB-DL "
            "DDP 5.1 H.265-CHORTLE",
            [],
            "Kylie: Tension Tour Live",
            2026,
        ),
        (
            "Nogizaka46 2021 'Kimi ni Shikarareta' Type-A, B, C, D，"
            "Blu-ray 1080p AVC",
            [],
            "Nogizaka46 'Kimi ni Shikarareta' Type-A, B, C, D",
            2021,
        ),
        (
            "SBS Korea Pop Music Festival in Summer 2026 "
            "1080p AAC 2.0 x264@JJL",
            [],
            "SBS Korea Pop Music Festival in Summer",
            2026,
        ),
        (
            "RTHK31 China Philharmonic Orchestra Concert Series - "
            "23rd Anniversary Concert 260704 1080i HDTV H264-NGBRTHK31",
            ["RTHK31 China Philharmonic Orchestra Concert Series"],
            "23rd Anniversary Concert",
            2026,
        ),
    ],
)
def test_music_video_scene_pattern_uses_music_specific_token_parser(
        raw: str,
        artists: list[str],
        title: str,
        year: int,
):
    """影视式音乐资源应按音乐 token 语义清理，且保留年份后的演出名称。"""
    context = MetaMusic._prepare_name_context(raw=raw, artists=[], year=None)
    matched = MusicNameRegistry.match_pattern(context)
    meta = parse_title(raw)

    assert matched.pattern_name == "music_video_scene"
    assert meta.artists == artists
    assert meta.title == title
    assert meta.year == year


@pytest.mark.parametrize(
    "raw",
    [
        "Daft Punk - Random Access Memories 2013 FLAC",
        "[Audio-4U] 茶太 — Chata 1.0 (flac)",
    ],
)
def test_music_video_scene_pattern_requires_combined_video_signature(raw: str):
    """普通音频标题只有格式或版本数字时，不得误入音乐视频场景模式。"""
    context = MetaMusic._prepare_name_context(raw=raw, artists=[], year=None)
    matched = MusicNameRegistry.match_pattern(context)

    assert matched.pattern_name != "music_video_scene"


@pytest.mark.parametrize(
    ("raw", "artists", "title", "year", "audio_format"),
    [
        (
            "The Bug Club - On the Intricate Inner Workings of the System "
            "2025-FLAC 分軌-Redacted",
            ["The Bug Club"],
            "On the Intricate Inner Workings of the System",
            2025,
            "FLAC",
        ),
        (
            "李宇春 - 皇后与梦想 - 2006-FLAC分轨-OpenCD-九月萌",
            ["李宇春"],
            "皇后与梦想",
            2006,
            "FLAC",
        ),
        ("西班牙幻想曲SACD", [], "西班牙幻想曲", None, "DSD"),
        ("無字天碟 Indefinable（WAV+CUE原抓）", [], "無字天碟 Indefinable", None, "WAV"),
        ("刘星-无所事事（WAV+CUE原抓）", ["刘星"], "无所事事", None, "WAV"),
        ("喜多郎-古事记SACD", ["喜多郎"], "古事记", None, "DSD"),
        ("巫启贤太傻（黄金版）WAV分轨原抓", [], "巫启贤太傻(黄金版)", None, "WAV"),
        (
            "王若琳 - The Adult Storybook 2009 SACD",
            ["王若琳"],
            "The Adult Storybook",
            2009,
            "DSD",
        ),
    ],
)
def test_common_audio_release_noise_is_removed(
        raw: str,
        artists: list[str],
        title: str,
        year: Optional[int],
        audio_format: str,
):
    """真实音频发布尾链只提供格式和年份，不应污染艺术家或标题。"""
    meta = parse_title(raw)

    assert meta.artists == artists
    assert meta.title == title
    assert meta.year == year
    assert meta.audio_format == audio_format


def test_strip_track_prefix_handles_dot_separator():
    """曲序前缀 01. 应剥离并返回曲名。"""
    track, disc, title = MetaMusic.split_track_prefix("01.晴天")

    assert (track, disc, title) == (1, None, "晴天")


def test_strip_track_prefix_handles_dash_and_space():
    """常见 rip 命名 01 - 曲名 和 01 曲名 都应识别曲序。"""
    assert MetaMusic.split_track_prefix("03 - 七里香") == (3, None, "七里香")
    assert MetaMusic.split_track_prefix("05 借口") == (5, None, "借口")


def test_strip_track_prefix_handles_disc_track_number():
    """碟号-曲序前缀 1-02 应同时提取碟号和曲序。"""
    track, disc, title = MetaMusic.split_track_prefix("1-02 半岛铁盒")

    assert (track, disc, title) == (2, 1, "半岛铁盒")


def test_strip_track_prefix_handles_number_only_name():
    """纯数字文件名只能得到曲序，曲名返回 None 由调用方兜底。"""
    track, disc, title = MetaMusic.split_track_prefix("07")

    assert (track, disc, title) == (7, None, None)


def test_strip_track_prefix_keeps_normal_title():
    """普通曲名不应被误判为曲序前缀。"""
    assert MetaMusic.split_track_prefix("晴天") == (None, None, None)
    assert MetaMusic.split_track_prefix("2002") == (None, None, None)


def test_split_artist_title():
    """歌手 - 曲名结构应拆分，无分隔符时原文作为标题。"""
    artist, title = MetaMusic.split_artist_title("周杰伦 - 晴天")

    assert artist == "周杰伦"
    assert title == "晴天"
    assert MetaMusic.split_artist_title("晴天") == (None, "晴天")


def test_parse_disc_dir():
    """CD1、Disc 2 等碟片目录应识别碟号。"""
    assert MetaMusic.parse_disc_dir("CD1") == 1
    assert MetaMusic.parse_disc_dir("Disc 2") == 2
    assert MetaMusic.parse_disc_dir("disk03") == 3
    assert MetaMusic.parse_disc_dir("无损音乐") is None


def test_parse_album_dir_extracts_artist_album_year():
    """专辑目录名应提取歌手、专辑、年份和音质描述。"""
    info = MetaMusic.parse_album_dir("周杰伦 - 七里香 (2004) [FLAC 24bit-96kHz]")

    assert info["artist"] == "周杰伦"
    assert info["album"] == "七里香"
    assert info["year"] == 2004
    assert "FLAC" in info["quality_text"]


def test_parse_album_dir_without_artist():
    """没有歌手分隔的目录名整体作为专辑名。"""
    info = MetaMusic.parse_album_dir("Random Access Memories (2013)")

    assert info["artist"] is None
    assert info["album"] == "Random Access Memories"
    assert info["year"] == 2013


def test_apply_path_context_fills_wav_meta(tmp_path):
    """无标签 WAV 应从文件名和目录结构补齐曲序、专辑和歌手。"""
    album_dir = tmp_path / "周杰伦 - 七里香 (2004) [FLAC]"
    album_dir.mkdir()
    wav_file = album_dir / "01.我的地盘.wav"
    wav_file.write_bytes(b"RIFF")

    meta = MetaMusic(org_string=wav_file.name, title=wav_file.stem, audio_format="WAV")
    meta.apply_path_context(wav_file)

    assert meta.track_number == 1
    assert meta.title == "我的地盘"
    assert meta.album == "七里香"
    assert meta.artists == ["周杰伦"]
    assert meta.album_artist == "周杰伦"
    assert meta.year == 2004


def test_apply_path_context_uses_disc_subdir(tmp_path):
    """CD1 子目录内的文件应继承碟号并向上找到专辑目录。"""
    album_dir = tmp_path / "Daft Punk - Discovery (2001)"
    disc_dir = album_dir / "CD1"
    disc_dir.mkdir(parents=True)
    wav_file = disc_dir / "01 - One More Time.flac"
    wav_file.write_bytes(b"fLaC")

    meta = MetaMusic(org_string=wav_file.name, title=wav_file.stem, audio_format="FLAC")
    meta.apply_path_context(wav_file)

    assert meta.disc_number == 1
    assert meta.track_number == 1
    assert meta.title == "One More Time"
    assert meta.album == "Discovery"
    assert meta.artists == ["Daft Punk"]


def test_apply_path_context_keeps_existing_tags(tmp_path):
    """已有标签字段不应被目录猜测覆盖。"""
    album_dir = tmp_path / "周杰伦 - 七里香 (2004)"
    album_dir.mkdir()
    audio_file = album_dir / "01.我的地盘.mp3"
    audio_file.write_bytes(b"")

    meta = MetaMusic(
        org_string=audio_file.name,
        title="我的地盘",
        artists=["周杰伦"],
        album="七里香",
        year=2004,
        track_number=1,
        audio_format="MP3",
    )
    meta.apply_path_context(audio_file)

    assert meta.title == "我的地盘"
    assert meta.artists == ["周杰伦"]
    assert meta.album == "七里香"
    assert meta.year == 2004


def test_apply_path_context_uses_full_dynamic_filename_parser(tmp_path):
    """无标签文件名应进入完整动态模式，清理音乐视频场景规格。"""
    audio_file = tmp_path / (
        "S H E - S H E十七音乐会 2018 WEB-DL 1080P AVC AAC-FHDMv.flac"
    )
    audio_file.write_bytes(b"fake-flac")
    meta = MetaMusic(
        org_string=audio_file.name,
        title=audio_file.stem,
        audio_format="FLAC",
    )

    meta.apply_path_context(audio_file)

    assert meta.artists == ["S.H.E"]
    assert meta.title == "S.H.E十七音乐会"
    assert meta.year == 2018
    assert meta.audio_format == "FLAC"


def test_apply_path_context_only_fills_missing_tag_fields(tmp_path):
    """部分标签存在时保留标签值，只从完整文件名解析补充空字段。"""
    audio_file = tmp_path / "周杰伦 - 文件名曲目 2018 FLAC.flac"
    audio_file.write_bytes(b"fake-flac")
    meta = MetaMusic(
        org_string=audio_file.name,
        title="标签曲名",
        artists=[],
        album="标签专辑",
        year=2020,
    )

    meta.apply_path_context(audio_file)

    assert meta.title == "标签曲名"
    assert meta.artists == ["周杰伦"]
    assert meta.album == "标签专辑"
    assert meta.year == 2020
    assert meta.audio_format == "FLAC"
    assert meta.audio_lossless is True


def test_apply_title_splits_artist_and_track():
    """标准「歌手 - 曲名」种子标题应拆分艺术家与曲名。"""
    meta = parse_title("周杰伦 - 晴天")

    assert meta.artists == ["周杰伦"]
    assert meta.title == "晴天"


def test_apply_title_splits_multi_artists():
    """多艺术家 & 联名写法应拆分为列表保留顺序。"""
    meta = parse_title("章子怡 & 周深 - 灯火里的中国")

    assert meta.artists == ["章子怡", "周深"]
    assert meta.title == "灯火里的中国"


def test_apply_title_strips_quality_tokens():
    """格式、位深采样与发行标记不应进入曲名。"""
    meta = parse_title("[250917] SARD UNDERGROUND - 故障した車 FLAC")

    assert meta.artists == ["SARD UNDERGROUND"]
    assert meta.title == "故障した車"
    assert meta.audio_format == "FLAC"


def test_apply_title_strips_video_tokens():
    """演唱会视频种子的分辨率与编码标记不应进入曲名。"""
    meta = parse_title("S H E - S H E十七音乐会 2018 WEB-DL 1080P AVC AAC-FHDMv")

    # 连续单字母空格序列是缩写点号被压平的结果，还原为 S.H.E 才能与条目署名比对
    assert meta.artists == ["S.H.E"]
    assert meta.title == "S.H.E十七音乐会"
    # 尾部年份提取为发行年份线索
    assert meta.year == 2018


def test_apply_title_splits_latin_hyphen_artist_album():
    """拉丁「艺术家-专辑」无空格连字符命名应拆分，单侧单词不采信。"""
    meta = parse_title("Gene Clark-White Light 1971 - FLAC 16bit 44 1khz")

    assert meta.artists == ["Gene Clark"]
    assert meta.title == "White Light"
    assert meta.year == 1971
    # 左侧单词（Heize-Undo）与右侧发布组标签不触发拆分
    assert parse_title("Heize-Undo.2022.FLAC").artists == []
    # 全大写复合词属于艺术家名本身，不能从 KUNG-FU 中间拆开。
    compound = parse_title("ASIAN KUNG-FU GENERATION Discography (2003-2026) [FLAC]")
    assert compound.artists == []
    assert compound.title == "ASIAN KUNG-FU GENERATION Discography (2003-2026)"


def test_apply_title_splits_various_artists_prefix():
    """场景命名的 Various Artists-Title 无空格连字符前缀应拆分为合辑署名。"""
    meta = parse_title("Various.Artists-Reply.1988.OST")

    assert meta.artists == ["Various Artists"]
    assert meta.title == "Reply 1988 OST"


def test_apply_title_splits_year_sandwich():
    """「艺术家 年份 专辑」三明治结构按中部年份拆分并提取年份。"""
    meta = parse_title("Leehom Wang 2010 The 18 Martial Arts")

    assert meta.artists == ["Leehom Wang"]
    assert meta.title == "The 18 Martial Arts"
    assert meta.year == 2010

    # 多艺术家分隔符与单词专辑名同样适用
    meta = parse_title("ASKA&SENS 1993 YAH YAH YAH")
    assert meta.artists == ["ASKA", "SENS"]
    assert meta.title == "YAH YAH YAH"
    assert meta.year == 1993


def test_apply_title_year_sandwich_guards():
    """三明治拆分的护栏：规格残留与长艺术家段不误拆。"""
    # 剩余段数字开头是规格（2.0）不是专辑名
    assert parse_title("K3 Kan Het S02 2014 2.0 -MINIBEL").artists == []
    # 剩余段连字符开头是发布组标签（-PTer）不是专辑名
    assert parse_title("Ashton Celebration 2013 -PTer").artists == []
    # 艺术家段超过 4 个词时拒绝拆分（含曲名与年份的完整标题）
    assert parse_title("Bee Gees One Night Only 1997 -ProfessorP").artists == []


def test_apply_title_restores_letter_abbrev():
    """单字母点号缩写还原不误伤合法缩写与单词。"""
    meta = parse_title("E.S.Posthumus - Ashielf Alpen FLAC")

    # 点分少于 3 处的合法缩写不被场景点分/还原逻辑破坏
    assert meta.artists == ["E.S.Posthumus"]
    assert meta.title == "Ashielf Alpen"


def test_apply_title_strips_release_group_tag():
    """格式标记后的发布组标签（大小写混合）应整体剔除。"""
    meta = parse_title("某某乐队 - 星空 FLAC-FHDMv")

    assert meta.title == "星空"


def test_apply_title_strips_date_prefix():
    """电视录制标题开头的日期前缀应剔除。"""
    meta = parse_title("2018.01.10 藤田麻衣子 思い続ければ FLAC")

    assert meta.title == "藤田麻衣子 思い続ければ"
    assert meta.audio_format == "FLAC"


def test_apply_title_date_prefix_with_time():
    """带时分秒的录制前缀（下划线分隔）同样应剔除。"""
    meta = parse_title("2024-01-27_20-00_ＷＯＷＯＷプライム_松任谷由実　５０ｔｈ　Ａｎｎｉｖｅｒｓａｒｙ")

    assert "2024" not in (meta.title or "")
    assert "松任谷由実" in (meta.title or "")
    assert "50th" in (meta.title or "")


def test_apply_title_keeps_song_named_with_year():
    """曲名自带的年份数字（非日期结构）不应被误剔除。"""
    meta = parse_title("2002年的第一场雪")

    assert meta.title == "2002年的第一场雪"


def test_apply_title_year_range_as_year():
    """全集标题尾部的年份区间应提取结束年并剥离出标题。"""
    meta = parse_title("天国的情人-邓丽君作品全集1967-1995")

    assert meta.title == "天国的情人"
    assert meta.artists == ["邓丽君"]
    assert meta.year == 1995


def test_apply_title_year_range_in_title_kept():
    """年份区间后随内容文字时属于标题本身，只提取年份不剥离。"""
    meta = parse_title("许茹芸 - 许茹芸1995-2000年光华真纪录 (2001)")

    assert meta.artists == ["许茹芸"]
    assert meta.title == "许茹芸1995-2000年光华真纪录"
    # 括号年份优先于区间提取的结束年
    assert meta.year == 2001


def test_apply_title_scene_dot_naming():
    """场景点分命名的点号应归一为空格，发布组标签剔除。"""
    meta = parse_title("Shan.Ge.Liao.Zai.2023.WEB-DL.FLAC-CMCTA")

    assert meta.title == "Shan Ge Liao Zai"
    assert meta.year == 2023
    assert meta.audio_format == "FLAC"


def test_apply_title_scene_dot_with_symbols():
    """点分命名中环绕符号的点（.&.、.-.）也应归一并支持艺术家拆分。"""
    meta = parse_title(
        "Deep.Purple.&.Orchestra.-.Live.At.Montreux.1999.2022.1080p.BluRay.AVC.DTS-HD.MA5.1"
    )

    assert meta.artists == ["Deep Purple", "Orchestra"]
    assert meta.title == "Live At Montreux 1999 2022"


def test_apply_title_keeps_artist_abbreviation_dots():
    """点分隔少于 3 处的艺术家缩写点号不应被归一。"""
    meta = parse_title("E.S.Posthumus - Maraboot")

    assert meta.artists == ["E.S.Posthumus"]
    assert meta.title == "Maraboot"


def test_apply_title_va_alias_artist():
    """合辑署名 VA 应归一为 MusicBrainz 规范署名 Various Artists。"""
    meta = parse_title("VA - Funky Jazz Saxophone 2024 FLAC")

    assert meta.artists == ["Various Artists"]
    assert meta.title == "Funky Jazz Saxophone"
    assert meta.year == 2024


def test_apply_title_va_scene_prefix():
    """场景命名 VA-Title 无空格连字符写法应按别名前缀拆分。"""
    meta = parse_title(
        "VA-Once.Upon.a.Time.in.Hollywood.Original.Motion.Picture.Soundtrack.2019.FLAC.24bit.96kHz"
    )

    assert meta.artists == ["Various Artists"]
    assert meta.title == "Once Upon a Time in Hollywood Original Motion Picture Soundtrack"
    assert meta.year == 2019


def test_apply_title_keeps_single_word_title():
    """无音质标记时「艺术家 - 单词曲名」的曲名不应被当发布组标签剔除。"""
    meta = parse_title("E.S.Posthumus - Maraboot")

    assert meta.title == "Maraboot"


def test_apply_title_keeps_title_with_quality_tokens():
    """存在音质标记时，空格连字符后的单词曲名也不应被当发布组标签剔除。"""
    meta = parse_title("Yes - Aurora [Bonus Tracks Edition, 24-bit Hi-Res] (2026) [FLAC]")

    assert meta.artists == ["Yes"]
    assert meta.title == "Aurora"
    assert meta.year == 2026


def test_apply_title_album_marker():
    """「歌手《专辑名》」书名号命名应提取艺术家、专辑与碟号。"""
    meta = parse_title("李宗盛《理性与感性作品音乐会-CD2》2006-FLAC-分轨")

    assert meta.artists == ["李宗盛"]
    assert meta.album == "理性与感性作品音乐会"
    assert meta.title == "理性与感性作品音乐会"
    assert meta.disc_number == 2
    assert meta.year == 2006


def test_apply_title_bilingual_album_marker_prefix():
    """双语原声命名应保留英文艺术家/标题，不把整段前缀当成艺术家。"""
    meta = parse_title(
        "Max Richter - Ad Astra Original Motion Picture Soundtrack "
        "马克斯·里希特 - 《星际探索》电影原声带 2019 FLAC-SeedPool"
    )

    assert meta.artists == ["Max Richter"]
    assert meta.title == "Ad Astra Original Motion Picture Soundtrack"
    assert meta.album == "星际探索"
    assert meta.year == 2019


def test_apply_title_strips_cue_and_plus():
    """APE+CUE 类格式联合写法应剔除，残留加号不阻断标题提取。"""
    meta = parse_title("世界著名古典大师名版收藏（15）RCA发烧古典系列-2007-FLAC-APE+CUE")

    assert meta.artists == []
    assert meta.title == "世界著名古典大师名版收藏(15)RCA发烧古典系列"
    assert meta.year == 2007


def test_apply_title_cjk_hyphen_artist_suffix():
    """CJK「曲名-歌手」无空格连字符写法应反向拆分艺术家。"""
    meta = parse_title("因为有你-毛阿敏")

    assert meta.artists == ["毛阿敏"]
    assert meta.title == "因为有你"


def test_apply_title_does_not_split_ascii_hyphen_inside_cjk_title():
    """CJK 标题中的 A-on 等拉丁复合词不能生成虚假的艺术家。"""
    meta = parse_title(
        "[250226] 重戦機エルガイム A-on STORE 連動特典"
        "「重戦機エルガイム(カセット版復刻CD)」 [FLAC+CUE]"
    )

    assert meta.artists == []
    assert meta.title.startswith("重戦機エルガイム A-on STORE")


def test_apply_title_double_em_dash_split():
    """双破折号分隔的「主题——歌手」写法应拆分艺术家。"""
    meta = parse_title("为你盛开——许巍 无尽光芒巡回演唱会 2025")

    assert meta.artists == ["许巍"]
    assert meta.title.startswith("为你盛开")


def test_apply_title_keeps_english_hyphen_title():
    """英文曲名中的连字符是标题组成部分，不做艺术家拆分。"""
    meta = parse_title("Dire Straits - Alchemy-Live 1983")

    assert meta.artists == ["Dire Straits"]
    assert meta.title == "Alchemy-Live"
    assert meta.year == 1983


def test_apply_title_lossless_declaration():
    """「无损」声明词应剥离出标题并推断无损音质。"""
    meta = parse_title("某某 - 晴天 FLAC 无损")

    assert meta.title == "晴天"
    assert meta.audio_lossless is True


def test_apply_title_track_prefix_in_title():
    """标题中的曲序前缀应提取为曲序并还原曲名。"""
    meta = parse_title("01.晴天")

    assert meta.track_number == 1
    assert meta.title == "晴天"


def test_apply_title_bracket_date_prefix():
    """发行日期方括号前缀应整体剔除。"""
    meta = parse_title("[250917] 某歌手 - 某曲名")

    assert meta.artists == ["某歌手"]
    assert meta.title == "某曲名"


def test_apply_title_spec_segments_do_not_shift_split():
    """尾部规格段（WEB-DL/位深/发布组）不应把拆分点推到艺术家与曲名的连字符上。"""
    meta = parse_title(
        "许茹芸 - 等得到 (电影《如影随心》主题曲 独唱版) (2019) - WEB-DL - 24bit ALAC-HHWEB")

    assert meta.artists == ["许茹芸"]
    # 含书名号的括号注释是版本说明，应拼回曲名而不触发专辑结构
    assert meta.title == "等得到 (电影《如影随心》主题曲 独唱版)"
    assert meta.year == 2019


def test_apply_title_album_marker_with_song_artist_prefix():
    """书名号前的「曲名-歌手」连字符段应反向拆分，首段作为曲名线索。"""
    meta = parse_title("为你盛开-许巍《无尽光芒》2019.FLAC")

    assert meta.artists == ["许巍"]
    assert meta.album == "无尽光芒"
    assert meta.title == "为你盛开"
    assert meta.year == 2019


def test_apply_title_album_marker_rest_disc_number():
    """书名号后仅剩碟号时应提取为碟号，曲名回退用专辑名。"""
    meta = parse_title("李宗盛《理性与感性作品音乐会》 CD2 (2006)")

    assert meta.artists == ["李宗盛"]
    assert meta.album == "理性与感性作品音乐会"
    assert meta.disc_number == 2
    assert meta.title == "理性与感性作品音乐会"
    assert meta.year == 2006


def test_apply_title_keeps_single_paren_disambiguation():
    """单层括号注释是条目消歧后缀，应保留在曲名中。"""
    meta = parse_title("周杰伦 - 晴天 (电影版)")

    assert meta.artists == ["周杰伦"]
    assert meta.title == "晴天 (电影版)"


def test_apply_title_collection_with_space_sample_rate():
    """合集/精选是发行形态标记，空格写法的采样率（44 1khz）也应剔除；
    剔除后仅剩悬空分隔符时艺术家仍需拆出。"""
    meta = parse_title("周杰伦 - 合集  2000-2022 - FLAC 16bit 44 1khz")

    assert meta.artists == ["周杰伦"]
    assert meta.title is None
    assert meta.year == 2022
    assert meta.audio_format == "FLAC"


@pytest.mark.parametrize("title", ["孙楠 - 楠得精选 2001", "[合集] 缘之空音乐合集 [FLAC]"])
def test_apply_title_keeps_collection_words_inside_work_name(title: str):
    """合集/精选嵌在作品名中时是有效文字，只清理独立发行标签。"""
    meta = parse_title(title)

    assert "精选" in (meta.title or "") or "合集" in (meta.title or "")