重构 改为标准化输出

backend/engine/cdsl_engine/batch_rebuild.py

@@ -343,6 +343,10 @@ def batch_analyze(
     if not files:
         raise ValueError(f"No *.cdsl.json files found in {cdsl_dir}")
     if part_ids is not None:
+        # ``part_ids`` are exact CDSL filename stems.  This is intentionally
+        # independent from document ``part_id``: imported provenance may use
+        # different case or normalisation than its collision-free artifact
+        # filename.  Phase pools return these same stems.
         requested = {str(part_id).strip() for part_id in part_ids if str(part_id).strip()}
         available = {path.name.removesuffix(".cdsl.json") for path in files}
         unknown = sorted(requested - available)