fix(font): 允许缺失渲染器可替换的空白/格式码点，避免误判缺失字形

之前 ASS 字幕中的 \h（U+00A0 不换行空格）等空白码点若在某字体的
cmap 中缺失，会被判定为「缺失字形」，导致整族字体回退为完整字体、
子集化被完全跳过。许多 CJK 字体本就省略这些码点（渲染器用普通空格
替代绘制），不应阻断匹配与子集化。

- font_catalog: 新增 is_optional_codepoint，识别渲染器可替代的空白与
  格式码点（NBSP/FIGURE SPACE/NARROW NBSP/WORD JOINER/BOM 及 Zs/Zl/Zp/
  Cc/Cf 类别），其缺失不算字形缺失。
- font_matching: 匹配时只把「必需缺失」码点计入 missing_codepoints，
  使含 \h 的中文字幕仍能被子集化而非回退完整字体。
- font_subset: subset_font_face 遇到仅缺失可选码点时，从请求中剔除后
  继续子集化，而非整体抛出 FontSubsetError 回退完整字体；请求清空时
  给出明确的空子集错误。

fix(gui): 在结果卡片中渲染可读的警告正文

之前混流结果只显示警告数量（如「4 个警告」），用户无法得知具体
内容。现在结果卡片可展开显示逐条警告的人类可读文案，并补充
en/zh-CN 的 result.warnings 与 warning.* 文案及对应样式。

fix(diagnostics): 优先采用绝对路径的 input_dir 提取媒体根目录

media 根目录提取原先在 report/job 任一命中即返回，且相对路径会静默
解析到进程工作目录（泄露应用运行时路径）。现改为优先返回绝对路径，
相对路径仅作为最后兜底解析。

Co-Authored-By: Claude <noreply@anthropic.com>

Author: Masterain98

plexmuxy/diagnostics.py

@@ -45,19 +45,34 @@ def _extract_media_root(job_context: dict | None) -> Path | None:
 
     Must run *before* path redaction: the job context is otherwise scrubbed to
     ``<PATH>/name`` so troubleshooting agents can no longer resolve the original
-    media resources. Prefers ``report.input_dir`` over ``job.input_dir``.
+    media resources.
+
+    Candidates are collected from both ``report.input_dir`` and
+    ``job.input_dir``; the persisted job record reflects the directory the user
+    actually selected for the task, while the report reflects what was actually
+    processed. An absolute path is always preferred so a relative or stale value
+    can never be silently resolved against the process working directory (which
+    would surface the application's own runtime path in the diagnostics).
     """
     if not isinstance(job_context, dict):
         return None
+    candidates: list[Path] = []
     for key in ("report", "job"):
         candidate = job_context.get(key)
         if isinstance(candidate, dict):
             root = candidate.get("input_dir")
             if isinstance(root, (str, Path)) and str(root).strip():
                 try:
-                    return Path(root).expanduser().resolve()
+                    candidates.append(Path(root).expanduser())
                 except (OSError, RuntimeError):
-                    return Path(root)
+                    candidates.append(Path(str(root)))
+    absolute = [candidate for candidate in candidates if candidate.is_absolute()]
+    if absolute:
+        return absolute[0]
+    if candidates:
+        # Only relative values remain; resolve against the working directory as
+        # a last resort rather than reporting a bare relative fragment.
+        return candidates[-1].resolve()
     return None
 
 

plexmuxy/font_catalog.py

@@ -36,6 +36,37 @@ def normalize_font_name(value: str) -> str:
     return " ".join(value.split()).casefold()
 
 
+# Whitespace/format codepoints a renderer resolves without a dedicated glyph
+# (e.g. libass draws a NO-BREAK SPACE using the regular space advance). Many CJK
+# fonts omit these from their cmap even though the glyph is effectively present.
+# Treating a missing entry here as a fatal "missing glyph" would force an entire
+# family back to a full-font attachment, defeating font subsetting for scripts
+# that merely contain a ``\h`` (U+00A0).
+_RENDERER_SUBSTITUTED_CODEPOINTS = frozenset({
+    0x00A0,  # NO-BREAK SPACE (ASS \h)
+    0x2007,  # FIGURE SPACE
+    0x202F,  # NARROW NO-BREAK SPACE
+    0x2060,  # WORD JOINER
+    0xFEFF,  # ZERO WIDTH NO-BREAK SPACE / BOM
+})
+
+
+def is_optional_codepoint(codepoint: int) -> bool:
+    """Return True when a font need not provide a glyph for ``codepoint``.
+
+    Whitespace separators, control and format characters are rendered via
+    substitution rather than an outline, so their absence must never block font
+    matching or subsetting.
+    """
+    if codepoint in _RENDERER_SUBSTITUTED_CODEPOINTS:
+        return True
+    try:
+        category = unicodedata.category(chr(codepoint))
+    except (ValueError, OverflowError):
+        return False
+    return category in {"Zs", "Zl", "Zp", "Cc", "Cf"}
+
+
 def build_font_catalog(
     font_paths: Iterable[Path],
     *,

plexmuxy/font_matching.py

@@ -4,7 +4,7 @@
 from pathlib import Path
 from typing import Literal
 
-from .font_catalog import normalize_font_name
+from .font_catalog import is_optional_codepoint, normalize_font_name
 from .models import FontFaceRef, FontUsage
 
 FontMatchStatus = Literal["matched", "missing", "ambiguous", "missing-glyphs"]
@@ -53,9 +53,13 @@ def match_font_usage(usage: FontUsage, catalog: list[FontFaceRef]) -> FontMatchR
         )
     face = next(iter(unique.values()))
     available = set(face.unicode_codepoints)
-    missing = tuple(sorted(set(usage.codepoints) - available))
-    if missing:
-        return FontMatchResult(usage, "missing-glyphs", face=face, missing_codepoints=missing)
+    missing = set(usage.codepoints) - available
+    # Whitespace/format codepoints the renderer substitutes (e.g. NBSP) must not
+    # count as missing glyphs; otherwise a single ``\h`` would fail the match and
+    # force the whole family to a full-font fallback instead of subsetting.
+    mandatory_missing = tuple(sorted(cp for cp in missing if not is_optional_codepoint(cp)))
+    if mandatory_missing:
+        return FontMatchResult(usage, "missing-glyphs", face=face, missing_codepoints=mandatory_missing)
     return FontMatchResult(usage, "matched", face=face)
 
 

plexmuxy/font_subset.py

@@ -9,7 +9,7 @@
 from fontTools import subset
 from fontTools.ttLib import TTFont
 
-from .font_catalog import normalize_font_name
+from .font_catalog import is_optional_codepoint, normalize_font_name
 from .models import FontFaceRef, FontMimeMode, font_mime_type_for_outline
 
 SUBSET_PROFILE_VERSION = 1
@@ -79,10 +79,21 @@ def subset_font_face(
     font = TTFont(source, fontNumber=face.face_index, lazy=False, recalcTimestamp=False)
     original_modified = int(getattr(font.get("head"), "modified", 0) or 0)
     available = set((font.getBestCmap() or {}).keys())
-    missing = sorted(requested - available)
+    missing = requested - available
     if missing:
+        mandatory_missing = sorted(cp for cp in missing if not is_optional_codepoint(cp))
+        if mandatory_missing:
+            font.close()
+            raise FontSubsetError(
+                f"Source font is missing requested codepoints: {_format_codepoints(mandatory_missing)}"
+            )
+        # The only absentees are whitespace/format codepoints the renderer
+        # substitutes (e.g. NBSP). Drop them from the request so the family can
+        # still be subset instead of falling back to the full source font.
+        requested -= missing
+    if not requested:
         font.close()
-        raise FontSubsetError(f"Source font is missing requested codepoints: {_format_codepoints(missing)}")
+        raise FontSubsetError("Cannot create an empty font subset")
 
     options = subset.Options()
     options.layout_features = ["*"]

plexmuxy_gui/static/app.css

@@ -1459,6 +1459,34 @@ button.plan-save-fab:hover:not(:disabled) { background: var(--color-brand); filt
   contain-intrinsic-size: auto 240px;
 }
 
+/* Collapsible, human-readable warning list on a finished job card. The UI used
+   to show only a warning *count*; now the actual messages are revealed here. */
+.result-warnings {
+  border: 1px solid color-mix(in srgb, var(--color-warn, #b7791f) 45%, var(--color-border));
+  border-radius: var(--radius-sm);
+  background: color-mix(in srgb, var(--color-warn, #b7791f) 10%, var(--color-canvas));
+  padding: 8px 12px;
+}
+.result-warnings > summary {
+  cursor: pointer;
+  font-weight: 600;
+  color: var(--color-fg-strong, #1a202c);
+  list-style: none;
+}
+.result-warnings > summary::-webkit-details-marker { display: none; }
+.result-warnings > summary::before {
+  content: "▸ ";
+  color: var(--color-warn, #b7791f);
+}
+.result-warnings[open] > summary::before { content: "▾ "; }
+.result-warnings .warning-list {
+  margin: 8px 0 2px;
+  padding-left: 18px;
+  display: grid;
+  gap: 4px;
+}
+.result-warnings .warning-item { font-size: 13px; line-height: 1.5; color: var(--color-fg); }
+
 .plan-card.has-edits { border-color: color-mix(in srgb, var(--color-brand) 55%, var(--color-border)); }
 .plan-enabled { flex-wrap: wrap; justify-content: flex-end; }
 

plexmuxy_gui/static/js/results.js

@@ -20,9 +20,51 @@ function renderResultCard(result) {
   const heading = itemNode(result.output_name, result.output_path); heading.firstChild && (heading.firstChild.className = "");
   title.append(heading, badge(result.success ? t("result.success") : t("result.failed"), result.success ? "ok" : "danger")); card.append(title);
   const counts = element("div", "count-row"); counts.append(badge(result.verified ? t("result.verified") : t("result.notVerified"), result.verified ? "ok" : "warn"), badge(countText(result.warnings.length, "count.warning.one", "count.warning.other"), result.warnings.length ? "warn" : "info")); card.append(counts);
+  const warnNode = renderWarnings(result.warnings);
+  if (warnNode) card.append(warnNode);
   if (result.error) card.append(element("div", "inline-error", `${result.error_code ? `[${result.error_code}] ` : ""}${result.error}`)); return card;
 }
 
+// Render a collapsible, human-readable list of job warnings. Previously the UI
+// only showed the warning *count*, so users could not tell what the warnings
+// actually meant.
+function renderWarnings(warnings) {
+  if (!warnings || !warnings.length) return null;
+  const details = element("details", "result-warnings");
+  details.append(element("summary", "", t("result.warnings")));
+  const list = element("ul", "warning-list");
+  for (const warning of warnings) {
+    list.append(element("li", "warning-item", humanizeWarning(warning)));
+  }
+  details.append(list);
+  return details;
+}
+
+// Turn machine-readable warning codes (e.g. "font_codepoints_missing:...")
+// into text a user can understand.
+function humanizeWarning(text) {
+  if (!text) return "";
+  const idx = text.indexOf(":");
+  const code = idx === -1 ? text.trim() : text.slice(0, idx);
+  const rest = idx === -1 ? "" : text.slice(idx + 1).trim();
+  switch (code) {
+    case "font_codepoints_missing": {
+      const m = rest.match(/:\s*(.+)$/);
+      return t("warning.fontCodepointsMissing", { font: m ? m[1].trim() : rest });
+    }
+    case "font_subset_fallback_all":
+      return t("warning.fontSubsetFallbackAll");
+    case "subset_fallback_full_font":
+      return t("warning.subsetFallbackFullFont", { detail: rest });
+    case "font_family_missing":
+      return t("warning.fontFamilyMissing", { family: rest });
+    case "font_match_ambiguous":
+      return t("warning.fontMatchAmbiguous", { family: rest });
+    default:
+      return text;
+  }
+}
+
 
 
 function localizeEnum(prefix, value) {

plexmuxy_gui/static/locales/en.json

@@ -285,6 +285,12 @@
   "result.ok": "ok",
   "result.verified": "verified",
   "result.notVerified": "not verified",
+  "result.warnings": "Warnings",
+  "warning.fontCodepointsMissing": "Font \"{font}\" is missing required glyphs; a fallback font was used.",
+  "warning.fontSubsetFallbackAll": "Font subsetting was skipped and the full original fonts were attached.",
+  "warning.subsetFallbackFullFont": "Subsetting failed for a font; the full original font was attached instead: {detail}",
+  "warning.fontFamilyMissing": "No matching installed font was found for \"{family}\".",
+  "warning.fontMatchAmbiguous": "Multiple fonts matched \"{family}\"; one was chosen automatically.",
   "progress.running": "Mux job in progress",
   "progress.aria": "Mux job progress",
   "progress.preparing": "Preparing next file",

plexmuxy_gui/static/locales/zh-CN.json

@@ -285,6 +285,12 @@
   "result.ok": "正常",
   "result.verified": "已验证",
   "result.notVerified": "未验证",
+  "result.warnings": "警告",
+  "warning.fontCodepointsMissing": "字体「{font}」缺少所需字形，已改用回退字体。",
+  "warning.fontSubsetFallbackAll": "已跳过字体子集化，直接附加了原始完整字体。",
+  "warning.subsetFallbackFullFont": "某字体子集化失败，已改用完整原始字体：{detail}",
+  "warning.fontFamilyMissing": "未找到与「{family}」匹配的已安装字体。",
+  "warning.fontMatchAmbiguous": "有多个字体匹配「{family}」，已自动选用其中之一。",
   "progress.running": "封装任务进行中",
   "progress.aria": "封装任务进度",
   "progress.preparing": "正在准备下一个文件",