refactor(font): 移除持久化子集缓存并新增 ASS 内嵌字体方案

- 删除 FontSubsetCache（font_cache.py 及全部引用）：缓存对子集体积收益有限，
  却带来版本失效、磁盘占用与一致性维护成本。font_cache 配置项一并移除，
  GUI 的“清理字体缓存”入口下线，benchmark 脚本同步更新。
- 新增 ass_font_embedder 模块：按 Aegisub/libass 的 uuencode 方案把子集字体
  内嵌进 ASS 的 [Fonts] 段，生成自包含字幕。新增 font.embed_scheme
  （attachment / ass / both），贯穿配置、覆盖层、muxer 与 GUI，支持沿用附件、
  内嵌或两者并存。
- 修复子集字体 name 表处理：不再改写或折叠 name 表，保留原始 name 表，使
  GDI 打包的 weight 子族（如 HYXuanSong 65S、FOT-TsukuMin Pr6N E）在 libass
  下可被正确匹配；SUBSET_PROFILE_VERSION 由 1 升到 2 以触发旧子集失效。
- 同步更新本地化词条、前端设置与计划预览、集成/单元测试及文档。

Author: Masterain98

plexmuxy/ass_font_embedder.py

@@ -0,0 +1,122 @@
+"""Self-contained ASS generation with embedded fonts (Aegisub/libass compatible).
+
+This mirrors the scheme used by tools such as assfonts: the subsetted (or full)
+font binaries are uuencoded and placed in a ``[Fonts]`` section inserted just
+before the ``[events]`` section of the subtitle file. Players built on libass
+decode the embedded blobs and register them by the font's real family name, so
+the existing style references keep working without any name rewriting.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from fontTools.ttLib import TTFont
+
+_FONT_SUFFIXES = frozenset({".ttf", ".otf", ".ttc", ".otc", ".woff", ".woff2"})
+
+
+def _font_family_name(path: Path) -> str | None:
+    """Best-effort family name used for an embedded font's ``fontname:`` label."""
+    try:
+        with TTFont(path) as font:
+            name = font["name"]
+            for name_id in (1, 16, 4):
+                value = name.getDebugName(name_id)
+                if value:
+                    return value
+    except Exception:
+        return None
+    return None
+
+
+def _uuencode(data: bytes) -> str:
+    """Aegisub/libass uuencode variant.
+
+    Each 6-bit group is emitted as ``value + 33`` (``!`` for 0). There is no
+    per-line length byte; newlines are inserted purely for readability every
+    80 encoded characters.
+    """
+    out: list[str] = []
+    written = 0
+    length = len(data)
+    for i in range(0, length, 3):
+        b0 = data[i]
+        b1 = data[i + 1] if i + 1 < length else 0
+        b2 = data[i + 2] if i + 2 < length else 0
+        n = (b0 << 16) | (b1 << 8) | b2
+        groups = (length - i) if (length - i) < 3 else 3
+        groups += 1  # 1 byte -> 2 chars, 2 bytes -> 3, 3 bytes -> 4
+        for shift in (18, 12, 6, 0):
+            if groups <= 0:
+                break
+            out.append(chr(((n >> shift) & 0x3F) + 33))
+            groups -= 1
+            written += 1
+            if written == 80 and i + 3 < length:
+                out.append("\n")
+                written = 0
+    return "".join(out)
+
+
+def _read_ass_text(path: Path) -> tuple[str, str, bytes]:
+    """Return (text, encoding_for_encode, bom_bytes)."""
+    raw = path.read_bytes()
+    if raw.startswith(b"\xff\xfe"):
+        return raw.decode("utf-16-le"), "utf-16-le", b"\xff\xfe"
+    if raw.startswith(b"\xfe\xff"):
+        return raw.decode("utf-16-be"), "utf-16-be", b"\xfe\xff"
+    if raw.startswith(b"\xef\xbb\xbf"):
+        return raw.decode("utf-8-sig"), "utf-8-sig", b"\xef\xbb\xbf"
+    try:
+        return raw.decode("utf-8"), "utf-8", b""
+    except UnicodeDecodeError:
+        return raw.decode("utf-8", errors="replace"), "utf-8", b""
+
+
+def _encode_ass_text(text: str, encoding: str, bom: bytes) -> bytes:
+    data = text.encode(encoding)
+    if bom:
+        return bom + data
+    return data
+
+
+def _build_fonts_block(font_paths: list[Path]) -> str:
+    blocks: list[str] = []
+    for path in font_paths:
+        if path.suffix.lower() not in _FONT_SUFFIXES:
+            continue
+        if not path.exists():
+            continue
+        label = _font_family_name(path) or path.stem
+        encoded = _uuencode(path.read_bytes())
+        blocks.append(f"fontname: {label}\n{encoded}")
+    return "\n".join(blocks)
+
+
+def _insert_fonts_section(text: str, fonts_block: str) -> str:
+    """Insert a ``[Fonts]`` section (containing ``fonts_block``) before ``[events]``."""
+    lines = text.split("\n")
+    insert_at = None
+    for idx, line in enumerate(lines):
+        if line.strip().lower() == "[events]":
+            insert_at = idx
+            break
+    if insert_at is None:
+        return text.rstrip("\n") + "\n\n[Fonts]\n\n" + fonts_block + "\n"
+    return "\n".join(
+        lines[:insert_at] + ["[Fonts]", fonts_block, ""] + lines[insert_at:]
+    )
+
+
+def embed_fonts_into_ass(
+    subtitle_path: Path,
+    font_paths: list[Path],
+    output_path: Path,
+) -> Path:
+    """Write a self-contained ASS (fonts embedded in ``[Fonts]``) to ``output_path``."""
+    text, encoding, bom = _read_ass_text(subtitle_path)
+    fonts_block = _build_fonts_block(font_paths)
+    new_text = _insert_fonts_section(text, fonts_block)
+    output_path.write_bytes(_encode_ass_text(new_text, encoding, bom))
+    return output_path

plexmuxy/config.py

@@ -17,7 +17,6 @@
     ArchiveLimits,
     ConcurrencyConfig,
     FfmpegConfig,
-    FontCacheConfig,
     FontConfig,
     LanguageProfile,
     MatchingConfig,
@@ -188,7 +187,6 @@ def parse_v2_config(data: dict[str, Any]) -> AppConfig:
     matching_data = require_mapping(data, "matching", default={})
     subtitle_data = require_mapping(data, "subtitle", default={})
     font_data = require_mapping(data, "font", default={})
-    font_cache_data = require_mapping(data, "font_cache", default={})
     limit_data = require_mapping(font_data, "archive_limits", default={})
     mkvmerge_data = require_mapping(data, "mkvmerge", default={})
     ffmpeg_data = require_mapping(data, "ffmpeg", default={})
@@ -211,10 +209,10 @@ def parse_v2_config(data: dict[str, Any]) -> AppConfig:
     }, "matching")
     reject_unknown(subtitle_data, {"default_language", "show_author_in_track_name", "profiles"}, "subtitle")
     reject_unknown(font_data, {
-        "delete_fonts_after_mux", "unrar_path", "mode", "mime_mode", "missing_font_action",
+        "delete_fonts_after_mux", "unrar_path", "mode", "mime_mode", "embed_scheme",
+        "missing_font_action",
         "subset_failure_action", "archive_limits",
     }, "font")
-    reject_unknown(font_cache_data, {"enabled", "max_size_mb", "max_age_days"}, "font_cache")
     reject_unknown(limit_data, {
         "max_archive_size", "max_files", "max_total_size", "max_file_size", "max_depth",
         "allow_uninspected_archives",
@@ -286,6 +284,11 @@ def parse_v2_config(data: dict[str, Any]) -> AppConfig:
         unrar_path=str(font_data.get("unrar_path", "")),
         mode=choice(font_data.get("mode", "all"), {"all", "referenced", "subset"}, "font.mode"),
         mime_mode=choice(font_data.get("mime_mode", "legacy"), {"legacy", "modern"}, "font.mime_mode"),
+        embed_scheme=choice(
+            font_data.get("embed_scheme", "attachment"),
+            {"attachment", "ass", "both"},
+            "font.embed_scheme",
+        ),
         missing_font_action=choice(font_data.get("missing_font_action", "warn"), {"warn", "skip-video", "fail-job", "fallback-all"}, "font.missing_font_action"),
         subset_failure_action=choice(
             font_data.get("subset_failure_action", "fallback-full"),
@@ -294,11 +297,6 @@ def parse_v2_config(data: dict[str, Any]) -> AppConfig:
         ),
         archive_limits=limits,
     )
-    font_cache = FontCacheConfig(
-        enabled=bool_value(font_cache_data.get("enabled", True), "font_cache.enabled"),
-        max_size_mb=positive_int(font_cache_data.get("max_size_mb", 2048), "font_cache.max_size_mb"),
-        max_age_days=positive_int(font_cache_data.get("max_age_days", 90), "font_cache.max_age_days"),
-    )
     using_legacy_thread_count = "max_parallel_mux_jobs" not in concurrency_data and "thread_count" in concurrency_data
     raw_parallel = concurrency_data.get("max_parallel_mux_jobs", concurrency_data.get("thread_count", 1))
     if raw_parallel == "auto":
@@ -335,7 +333,7 @@ def parse_v2_config(data: dict[str, Any]) -> AppConfig:
         path_mappings.append(PlexPathMapping(local_root=local_root, server_root=server_root))
     return AppConfig(
         config_version=CURRENT_CONFIG_VERSION, media=media, task=task, matching=matching,
-        subtitle=subtitle, font=font, font_cache=font_cache,
+        subtitle=subtitle, font=font,
         mkvmerge=MkvMergeConfig(path=str(mkvmerge_data.get("path", ""))),
         ffmpeg=FfmpegConfig(path=str(ffmpeg_data.get("path", ""))),
         notifications=NotificationConfig(