Crate lyrics_helper 

Lyricify 歌词助手 —— 统一的歌词解析、生成、解密和搜索门面库。

本 crate 聚合了底层各子 crate 的功能，提供简洁的顶层 API。

示例

use lyrics_helper::{parse_auto, generate_string, LyricsTypes};

let lrc_text = "[00:01.00]Hello World";
let lyrics = parse_auto(lrc_text).unwrap();
let output = generate_string(&lyrics, LyricsTypes::Lrc).unwrap();
assert!(output.contains("Hello World"));

Re-exports

pub use lyrics_crypto as decrypter;

pub use lyrics_generators as generators;

pub use lyrics_parsers as parsers;

pub use lyrics_search as search;

Modules

helpers

辅助工具模块，提供字符串处理、数学运算、时间偏移、跨文档逐词计时、繁简转换和格式识别等功能。

models

歌词数据模型模块。

providers

歌词 API 提供者模块，封装各平台的 Web API 客户端。

searchers

traits

核心 trait 定义，包括歌词解析器、生成器和解密器接口。

Structs

FileInfo

歌词文件的格式和同步类型信息。

FullSyllableInfo

完整音节信息，由多个 SyllableInfo 子项组成。

KrcDecrypter

KRC 格式歌词解密器，实现 LyricsDecrypter trait。

LyricsData

歌词数据的顶层容器，包含解析后的完整歌词信息。

QrcDecrypter

QRC 格式歌词解密器，实现 LyricsDecrypter trait。

SyllableInfo

单个音节信息，包含文本内容和时间范围。

TrackMetadata

歌曲元数据，包含标题、艺术家、专辑等信息。

Enums

AdditionalFileInfo

不同歌词格式的附加文件信息。

LineInfo

歌词行信息，支持四种变体：简单行、音节行、完整行、完整音节行。

LyricsAlignment

歌词文本对齐方式。

LyricsRawTypes

歌词原始格式类型，包含 LyricsTypes 的所有变体以及额外的原始子格式。

LyricsTypes

歌词格式类型，用于标识已解析歌词的来源格式。

SearchError

搜索或歌词获取过程中的错误。

SyllableItem

音节项，对应 C# 的 ISyllableInfo。

SyncTypes

歌词同步类型，描述歌词数据的时间同步精度。

Functions

decrypt_krc

解密 KRC 加密歌词字符串（Base64 编码），返回解密后的明文歌词。

decrypt_qrc

解密 QRC 加密歌词字符串，返回解密后的明文歌词。

flatten_syllable_items

将音节项列表展开为普通音节列表（合并音节展开为其子音节）。

generate_string

根据指定的歌词类型，将歌词数据生成为对应格式的字符串。

generator_for

返回指定歌词类型对应的生成器，不支持生成的类型返回 None。

get_text_from_syllable_items

将音节项列表拼接为完整文本字符串。

get_text_from_syllable_list

将音节列表拼接为完整文本字符串。

parse

根据指定的歌词原始类型解析歌词内容，返回解析后的 LyricsData。

parse_auto

自动检测歌词格式并解析歌词内容，返回解析后的 LyricsData。

parser_for

返回指定原始类型对应的解析器。

to_syllable_items

将普通音节列表包装为音节项列表。