@motionharness/bridge-davinci 0.0.23 → 0.0.25

package/dist/resolve_rpc.py

@@ -29,8 +29,6 @@ import instance_runtime as instances
 import legacy_conversion as legacy
 from runtime_io import atomic_json, file_digest
 
-# Frame boundaries were read back on this exact build; do not extrapolate to unknown builds.
-VALIDATED_BUILD = "21.1.0.14"
 SUPPORTED_INSPECTOR_EFFECTS = {
     "Transform", "Source Transform", "Immersive Transform", "Cropping", "Source Cropping",
     "Source Looks", "Dynamic Zoom", "Composite", "Lens Correction", "Retime and Scaling",
@@ -39,10 +37,6 @@ SUPPORTED_INSPECTOR_EFFECTS = {
 ORIGINAL_PLAYBACK = {"perfProxyMediaMode": "0", "perfOptimisedMediaOn": "0", "perfRenderCacheMode": "none"}
 
 
-def validated_host(resolve):
-    return resolve.GetVersionString() == VALIDATED_BUILD and sys.platform == "darwin" and platform.machine() == "arm64"
-
-
 class BridgeFailure(Exception):
     def __init__(self, code, message, **details):
         super().__init__(message)
@@ -88,8 +82,7 @@ def project_for(resolve, requested=None, render_proof=None):
     # GetCurrentDatabase returns None throughout some renders on 21.1.0.14.
     # Monitoring/cancelling an already-started job may use its previously
     # verified project + complete queue fingerprint; starting still requires DB.
-    if (render_proof and requested and not manager.GetCurrentDatabase()
-            and validated_host(resolve) and project.IsRenderingInProgress()):
+    if render_proof and requested and not manager.GetCurrentDatabase() and project.IsRenderingInProgress():
         require(project.GetUniqueId() == requested["projectId"], "VERSION_CONFLICT", "运行中的任务已不属于原工程。")
         job = render_job(project, render_proof["jobId"])
         require(render_proof.get("expectedJobFingerprint") and fingerprint(job) == render_proof["expectedJobFingerprint"],
@@ -179,13 +172,13 @@ def sample_end_time(start, timeline_frames, source_fps, timeline_fps, source_fra
     return min(source_frames / source_rate, start / source_rate + (timeline_frames - 1) / timeline_rate + 1 / source_rate)
 
 
-def item_snapshot(item, timeline_id, track, validated=False, media_index=None, timeline_fps=None):
+def item_snapshot(item, timeline_id, track, media_index=None, timeline_fps=None):
     media = item.GetMediaPoolItem()
-    intrinsic_entry = intrinsic.read_entry(item, media_index or {}) if validated and not media else None
+    intrinsic_entry = intrinsic.read_entry(item, media_index or {}) if not media else None
     if intrinsic_entry:
         media = media_index[intrinsic_entry['identity']['mediaPoolItemId']]
-    unsupported = [] if validated else ["host-build-and-frame-conventions-unverified"]
-    kind = item.GetType() if validated else "unknown"
+    unsupported = []
+    kind = item.GetType()
     if not media and kind != "transition":
         unsupported.append("no-plain-media-source")
     fusion_count = item.GetFusionCompCount() if media else 0
@@ -199,7 +192,7 @@ def item_snapshot(item, timeline_id, track, validated=False, media_index=None, t
         unsupported.append("take-selector-or-multicam")
     props = media.GetClipProperty() if media else {}
     speed, properties, fades = None, None, None
-    if validated and media:
+    if media:
         if media.GetTimeline():
             unsupported.append("nested-or-compound-timeline")
         if kind != "video":
@@ -258,12 +251,12 @@ def item_snapshot(item, timeline_id, track, validated=False, media_index=None, t
         "sourceIn": source_in, "sourceOut": source_out,
         "mediaPoolItemId": media.GetUniqueId() if media else None, "unsupported": unsupported,
         "kind": kind, "speed": speed, "properties": properties, "fades": fades,
-        "enabled": item.GetClipEnabled() if validated and media else None,
-        "sourceStartTime": item.GetSourceStartTime() if validated and media else None,
-        "sourceEndTime": item.GetSourceEndTime() if validated and media else None,
-        "leftOffset": item.GetLeftOffset() if validated and media else None,
-        "rightOffset": item.GetRightOffset() if validated and media else None,
-        "markers": item.GetMarkers() if validated and media else None,
+        "enabled": item.GetClipEnabled() if media else None,
+        "sourceStartTime": item.GetSourceStartTime() if media else None,
+        "sourceEndTime": item.GetSourceEndTime() if media else None,
+        "leftOffset": item.GetLeftOffset() if media else None,
+        "rightOffset": item.GetRightOffset() if media else None,
+        "markers": item.GetMarkers() if media else None,
         **({"inspectorEntry": entry} if entry else {}),
         **({"intrinsicEntry": intrinsic_entry} if intrinsic_entry else {}),
     }
@@ -520,9 +513,6 @@ def grade_evidence(resolve, timeline, native_items, intrinsic_ids=None):
 
 @contextmanager
 def timeline_context(resolve, timeline):
-    if resolve is None or not validated_host(resolve):
-        yield
-        return
     project = resolve.GetProjectManager().GetCurrentProject()
     previous = project.GetCurrentTimeline()
     try:
@@ -538,42 +528,41 @@ def timeline_context(resolve, timeline):
             await_timeline(project, previous, resolve=resolve)
 
 
-def scan_timeline(timeline, resolve=None, grade_media_id=None):
+def scan_timeline(timeline, resolve, grade_media_id=None):
     with timeline_context(resolve, timeline):
         return scan_current_timeline(timeline, resolve, grade_media_id)
 
 
-def scan_current_timeline(timeline, resolve=None, grade_media_id=None):
-    validated = resolve is not None and validated_host(resolve)
+def scan_current_timeline(timeline, resolve, grade_media_id=None):
     items, native_items, paths = [], [], {}
     media_index = None
     for track in range(1, timeline.GetTrackCount("video") + 1):
         native = timeline.GetItemListInTrack("video", track) or []
         native_items.extend(native)
         for item in native:
-            if validated and not item.GetMediaPoolItem() and item.GetFusionCompCount() > 0 and media_index is None:
+            if not item.GetMediaPoolItem() and item.GetFusionCompCount() > 0 and media_index is None:
                 project = resolve.GetProjectManager().GetCurrentProject()
                 media_index = {m.GetUniqueId(): m for m in all_media(project.GetMediaPool().GetRootFolder())}
-            snapshot = item_snapshot(item, timeline.GetUniqueId(), track, validated, media_index, fps_value(timeline.GetSetting("timelineFrameRate")) if validated else None)
-            snapshot.update(trackEnabled=timeline.GetIsTrackEnabled("video", track) if validated else None,
-                            trackLocked=timeline.GetIsTrackLocked("video", track) if validated else None)
+            snapshot = item_snapshot(item, timeline.GetUniqueId(), track, media_index, fps_value(timeline.GetSetting("timelineFrameRate")))
+            snapshot.update(trackEnabled=timeline.GetIsTrackEnabled("video", track),
+                            trackLocked=timeline.GetIsTrackLocked("video", track))
             items.append(snapshot)
-            if validated and item.GetMediaPoolItem():
+            if item.GetMediaPoolItem():
                 paths[snapshot["id"]] = item.GetMediaPoolItem().GetClipProperty("File Path") or ""
             elif snapshot.get('intrinsicEntry'):
                 paths[snapshot['id']] = media_index[snapshot['mediaPoolItemId']].GetClipProperty('File Path') or ''
-    evidence = otio_evidence(resolve, timeline) if validated and items else {"complete": not items, "reasons": [], "hash": None}
-    if validated and items and evidence.get("clipCount") != sum(1 for item in items if item["kind"] == "video" and item["mediaPoolItemId"]):
+    evidence = otio_evidence(resolve, timeline) if items else {"complete": True, "reasons": [], "hash": None}
+    if items and evidence.get("clipCount") != sum(1 for item in items if item["kind"] == "video" and item["mediaPoolItemId"]):
         evidence["reasons"] = sorted(set(evidence["reasons"] + ["otio-item-coverage-mismatch"]))
         evidence["globalReasons"] = sorted(set(evidence.get("globalReasons", evidence["reasons"]) + ["otio-item-coverage-mismatch"]))
-    scoped_reasons = otio_item_reasons(evidence, items, paths, timeline.GetStartFrame(), fps_value(timeline.GetSetting("timelineFrameRate"))) if validated and items else {}
+    scoped_reasons = otio_item_reasons(evidence, items, paths, timeline.GetStartFrame(), fps_value(timeline.GetSetting("timelineFrameRate"))) if items else {}
     # A media readback retains grades only for that media's uses. Keep every
     # native item and OTIO check for indirect references, but avoid exporting
     # unrelated LUTs. Whole-timeline snapshots still inspect all grades.
     grade_items = [native for native, item in zip(native_items, items)
                    if grade_media_id is None or item["mediaPoolItemId"] == grade_media_id]
-    grades = grade_evidence(resolve, timeline, grade_items, {i['id'] for i in items if i.get('intrinsicEntry')}) if validated and grade_items and any(i["kind"] == "video" for i in items) else {}
-    entry_scope = scope_for(resolve.GetProjectManager(), resolve.GetProjectManager().GetCurrentProject()) if validated and any(i.get("inspectorEntry") or i.get('intrinsicEntry') for i in items) else None
+    grades = grade_evidence(resolve, timeline, grade_items, {i['id'] for i in items if i.get('intrinsicEntry')}) if grade_items and any(i["kind"] == "video" for i in items) else {}
+    entry_scope = scope_for(resolve.GetProjectManager(), resolve.GetProjectManager().GetCurrentProject()) if any(i.get("inspectorEntry") or i.get('intrinsicEntry') for i in items) else None
     for item in items:
         item["otioHash"] = evidence["hash"]
         item["unsupported"] = sorted(set(item["unsupported"] + scoped_reasons.get(item["id"], evidence["reasons"])))
@@ -585,10 +574,9 @@ def scan_current_timeline(timeline, resolve=None, grade_media_id=None):
             owner = entry["identity"]
             if any(owner[key] != value for key, value in entry_scope.items()):
                 item["unsupported"] = sorted(set(item["unsupported"] + ["inspector-identity-conflict"]))
-    if validated:
-        graph = timeline.GetNodeGraph()
-        if graph and any(graph.GetToolsInNode(index) for index in range(1, graph.GetNumNodes() + 1)):
-            for item in items: item["unsupported"] = sorted(set(item["unsupported"] + ["timeline-grade-unverified"]))
+    graph = timeline.GetNodeGraph()
+    if graph and any(graph.GetToolsInNode(index) for index in range(1, graph.GetNumNodes() + 1)):
+        for item in items: item["unsupported"] = sorted(set(item["unsupported"] + ["timeline-grade-unverified"]))
     return items
 
 
@@ -650,7 +638,7 @@ def media_identity(project, scope, media):
     return data
 
 
-def media_snapshot(project, scope, media, resolve=None):
+def media_snapshot(project, scope, media, resolve):
     data = media_identity(project, scope, media)
     media_id = media.GetUniqueId()
     uses = []
@@ -662,20 +650,20 @@ def media_snapshot(project, scope, media, resolve=None):
         items = scan_timeline(timeline, resolve, grade_media_id=media_id)
         uses.extend(i for i in items if i["mediaPoolItemId"] == media_id)
         # A nested timeline could reference this media indirectly.
-        if any(any(reason in i["unsupported"] for reason in ("nested-or-compound-timeline", "no-plain-media-source", "nested-or-unknown-otio-item", "nested-media-reference", "otio-inspection-unavailable", "otio-item-coverage-mismatch", "host-build-and-frame-conventions-unverified")) for i in items):
+        if any(any(reason in i["unsupported"] for reason in ("nested-or-compound-timeline", "no-plain-media-source", "nested-or-unknown-otio-item", "nested-media-reference", "otio-inspection-unavailable", "otio-item-coverage-mismatch")) for i in items):
             complete = False
-    settings = project.GetSettings() if resolve and validated_host(resolve) else {}
+    settings = project.GetSettings()
     data.update({"uses": uses, "usageScanComplete": complete,
                  "playbackPolicy": {key: settings.get(key) for key in ("perfProxyMediaMode", "perfOptimisedMediaOn", "perfRenderCacheMode")}})
     return data
 
 
-def timeline_snapshot(project, scope, timeline, resolve=None):
+def timeline_snapshot(project, scope, timeline, resolve):
     with timeline_context(resolve, timeline):
         return current_timeline_snapshot(project, scope, timeline, resolve)
 
 
-def current_timeline_snapshot(project, scope, timeline, resolve=None):
+def current_timeline_snapshot(project, scope, timeline, resolve):
     items = scan_timeline(timeline, resolve)
     sources = []
     # Rebuild once per snapshot, not once per source. Do not cache across calls:
@@ -691,8 +679,8 @@ def current_timeline_snapshot(project, scope, timeline, resolve=None):
         props = media.GetClipProperty() or {}
         sources.append({"mediaPoolItemId": media_id, "properties": {key: props.get(key) for key in ("File Path", "FPS", "Frames", "Resolution", "Input Color Space", "Input Gamma", "Data Level", "Proxy Media Path")},
                         "bridgeMetadata": (media.GetThirdPartyMetadata() or {}).get("motionharness.bridge")})
-    settings = project.GetSettings() if resolve and validated_host(resolve) else {}
-    data = {"scope": scope, "timelineId": timeline.GetUniqueId(), "name": timeline.GetName(), "validatedHost": bool(resolve and validated_host(resolve)),
+    settings = project.GetSettings()
+    data = {"scope": scope, "timelineId": timeline.GetUniqueId(), "name": timeline.GetName(),
             "fps": fps_value(timeline.GetSetting("timelineFrameRate")), "startFrame": timeline.GetStartFrame(),
             "resolution": {"width": int(timeline.GetSetting("timelineResolutionWidth")), "height": int(timeline.GetSetting("timelineResolutionHeight"))},
             "endFrame": timeline.GetEndFrame(), "items": items, "sources": sources,
@@ -790,7 +778,6 @@ def seek_timecode(project, timeline, requested, timeout=3.0, resolve=None):
 
 
 def preview_frame(resolve, project, scope, params, before=None):
-    require(validated_host(resolve), "CAPABILITY_UNAVAILABLE", "该平台与构建的画面捕获尚未验证。")
     require_active_project(resolve, project)
     require(not project.IsRenderingInProgress(), "RESOLVE_BUSY", "Resolve 正在导出。")
     timeline = timeline_for(project, params["timelineId"])
@@ -847,7 +834,7 @@ def playback_policy(project):
 
 
 def render_preset_evidence(resolve, project):
-    name = "Motion Harness Bridge delivery check " + str(uuid.uuid4())
+    name = "MotionHarness Bridge delivery check " + str(uuid.uuid4())
     require(project.SaveAsNewRenderPreset(name), "CAPABILITY_UNAVAILABLE", "无法核对导出预设的缓存策略。")
     try:
         with tempfile.TemporaryDirectory(prefix="mh-bridge-preset-") as directory:
@@ -861,7 +848,6 @@ def render_preset_evidence(resolve, project):
 
 
 def create_render(resolve, project, scope, params):
-    require(validated_host(resolve), "CAPABILITY_UNAVAILABLE", "该构建尚未验证指定任务导出。")
     require(not project.IsRenderingInProgress(), "RESOLVE_BUSY", "Resolve 已有输出任务在运行。")
     timeline = timeline_for(project, params["timelineId"])
     expected = params["expectedTimelineFingerprint"]
@@ -872,7 +858,7 @@ def create_render(resolve, project, scope, params):
     previous = project.GetCurrentTimeline()
     before_jobs = project.GetRenderJobList() or []
     require(not any(os.path.realpath(job.get("TargetDir", "")) == os.path.realpath(os.path.dirname(path)) and job.get("OutputFilename") == os.path.basename(path) for job in before_jobs), "TARGET_OCCUPIED", "输出位置已被其他队列项占用。")
-    backup = "Motion Harness Bridge restore " + str(uuid.uuid4())
+    backup = "MotionHarness Bridge restore " + str(uuid.uuid4())
     require(project.SaveAsNewRenderPreset(backup), "CAPABILITY_UNAVAILABLE", "无法保存原有导出配置，未修改设置。")
     job_id = None
     try:
@@ -920,7 +906,6 @@ def create_render(resolve, project, scope, params):
 
 
 def start_render(resolve, project, scope, params):
-    require(validated_host(resolve), "CAPABILITY_UNAVAILABLE", "该构建尚未验证指定任务导出。")
     require(not project.IsRenderingInProgress(), "RESOLVE_BUSY", "Resolve 正在执行其他渲染；未启动队列。")
     job = render_job(project, params["jobId"])
     require(params.get("expectedJobFingerprint") and fingerprint(job) == params["expectedJobFingerprint"], "VERSION_CONFLICT", "队列任务的输出设置已改变或没有核对记录，未启动。")
@@ -947,7 +932,6 @@ def start_render(resolve, project, scope, params):
 
 
 def finish_render(resolve, project, params):
-    require(validated_host(resolve), "CAPABILITY_UNAVAILABLE", "该构建尚未验证输出恢复。")
     render_job(project, params["jobId"])
     require(not project.IsRenderingInProgress(), "RESOLVE_BUSY", "仍有渲染运行，保留原始画面模式直至可核对的终态。")
     expected, actual = params["playbackPolicy"], playback_policy(project)
@@ -959,7 +943,7 @@ def finish_render(resolve, project, params):
 
 
 def export_references(resolve, project, scope, params):
-    require(validated_host(resolve) and not project.IsRenderingInProgress(), "RESOLVE_BUSY", "输出后画面核对需要已完成渲染的目标工程。")
+    require(not project.IsRenderingInProgress(), "RESOLVE_BUSY", "输出后画面核对需要已完成渲染的目标工程。")
     timeline = timeline_for(project, params["timelineId"])
     before = timeline_snapshot(project, scope, timeline, resolve)
     require(before["fingerprint"] == params["expectedTimelineFingerprint"], "VERSION_CONFLICT", "输出后的时间线已改变，不能生成原回执的参考画面。")
@@ -986,7 +970,6 @@ def export_references(resolve, project, scope, params):
 
 
 def preview_original(resolve, project, scope, params):
-    require(validated_host(resolve), "CAPABILITY_UNAVAILABLE", "该构建尚未验证原始媒体合成检查。")
     require(not project.IsRenderingInProgress(), "RESOLVE_BUSY", "不能在导出期间改变合成画面检查策略。")
     timeline = timeline_for(project, params["timelineId"])
     before = timeline_snapshot(project, scope, timeline, resolve)
@@ -1008,8 +991,6 @@ def preview_original(resolve, project, scope, params):
 
 
 def selection_snapshot(resolve, plain_media_only=False):
-    require(validated_host(resolve), "CAPABILITY_UNAVAILABLE", "该构建尚未验证时间线选择读取。")
-
     def plain_item(item):
         media = item.GetMediaPoolItem()
         require(media is not None and media is not False, "CAPABILITY_UNAVAILABLE", "请选择有直接视频源的普通片段；生成器入口暂不支持此操作。")
@@ -1123,7 +1104,7 @@ def inspector_operation(resolve, params):
     # A composition imported through the API is not an Edit-page Fusion effect.
     # Keep the graph experiment separate from the product's Inspector entry.
     require(params.get("remove") or params.get("compositionOnly") is True, "CAPABILITY_UNAVAILABLE",
-            "ImportFusionComp 不能创建 Edit 检查器效果，请通过原生特效库应用 Motion Harness Bridge 模板。")
+            "ImportFusionComp 不能创建 Edit 检查器效果，请通过原生特效库应用 MotionHarness Bridge 模板。")
     identity = params["identity"]
     require(identity.get("schemaVersion") == 1, "INVALID_REQUEST", "检查器入口身份版本无效。")
     selected = selection_snapshot(resolve)
@@ -1158,7 +1139,7 @@ def inspector_operation(resolve, params):
     before = timeline_snapshot(project, scope, timeline, resolve)
     targets = [value for value in before["items"] if value["id"] == item.GetUniqueId()]
     require(len(targets) == 1 and not targets[0]["unsupported"] and not targets[0].get("trackLocked"),
-            "UNSUPPORTED_TIMELINE_ITEM", "实验入口只接受完整读回通过、未锁定的普通 Motion Harness 片段。")
+            "UNSUPPORTED_TIMELINE_ITEM", "实验入口只接受完整读回通过、未锁定的普通 MotionHarness 片段。")
     with open(params["compositionPath"], "rb") as stream:
         data = stream.read()
     require(hashlib.sha256(data).hexdigest() == params["compositionSha256"] and data.startswith(b"-- MH Resolve Bridge inspector v1\n"),
@@ -1199,6 +1180,8 @@ def inspector_operation(resolve, params):
 
 
 def dispatch(resolve, operation, params):
+    # Resolve version and process architecture are diagnostic information only.
+    # Operations use the host APIs directly and report actual failures.
     if operation == "ofx_source_target":
         return ofx_source_target(resolve, params)
     if operation == "selection":
@@ -1233,22 +1216,19 @@ def dispatch(resolve, operation, params):
                 "scope": scope_for(manager, project) if project else None,
                 "timelines": [{"id": t.GetUniqueId(), "name": t.GetName()} for t in timelines(project)] if project else [],
                 "adapter": "documented-python-scripting", "officialMcp": "not-tested-by-scripting",
-                "replacement": "stable-playback-file-with-media-identity" if validated_host(resolve) else "host-build-unverified",
-                "frameConvention": "half-open" if validated_host(resolve) else "unverified",
-                "profile": {"platform": sys.platform, "architecture": platform.machine(), "basicBridgeValidated": validated_host(resolve)},
+                "replacement": "stable-playback-file-with-media-identity",
+                "frameConvention": "half-open",
+                "profile": {"platform": sys.platform, "architecture": platform.machine()},
                 "timelineReadback": "top-level-video; native speed/properties/fades and conservative OTIO structure check"}
     proof = params if operation in ("render_status", "cancel_render") else None
     project, scope = project_for(resolve, params.get("scope"), proof)
     if operation == "entry_target":
-        require(validated_host(resolve), "CAPABILITY_UNAVAILABLE", "该 Resolve 平台与构建尚未验证所选片段管理。")
         return entry_target(resolve, project, scope, params)
     if operation in ("legacy_preview", "legacy_convert", "legacy_check"):
-        require(validated_host(resolve), "CAPABILITY_UNAVAILABLE", "该 Resolve 平台与构建尚未验证旧生成器结构转换。")
         require(not project.IsRenderingInProgress(), "RESOLVE_BUSY", "Resolve 正在导出。")
         action = {"legacy_preview": legacy.preview, "legacy_convert": legacy.convert, "legacy_check": legacy.check}[operation]
         return action(resolve, project, scope, params, globals())
     if operation == "duplicate_instance":
-        require(validated_host(resolve), "CAPABILITY_UNAVAILABLE", "该 Resolve 平台与构建尚未验证单实例独立副本。")
         require(not project.IsRenderingInProgress(), "RESOLVE_BUSY", "Resolve 正在导出。")
         return instances.duplicate_instance(resolve, project, scope, params, globals())
     if operation == "timeline":
@@ -1293,8 +1273,6 @@ def dispatch(resolve, operation, params):
         require(len(found) <= 1, "RECOVERY_CONFLICT", "多个媒体对象拥有同一绑定身份，未自动选择。")
         return media_snapshot(project, scope, found[0], resolve) if found else None
     if operation in ("render_status", "cancel_render"):
-        if operation == "cancel_render":
-            require(validated_host(resolve), "CAPABILITY_UNAVAILABLE", "该构建尚未验证指定任务取消。")
         render_job(project, params["jobId"])
         status = project.GetRenderJobStatus(params["jobId"])
         if operation == "cancel_render" and status.get("JobStatus") == "Rendering":
@@ -1314,7 +1292,6 @@ def dispatch(resolve, operation, params):
             return media_snapshot(project, scope, media, resolve)
         before = media_identity(project, scope, media)
         require(not project.IsRenderingInProgress(), "RESOLVE_BUSY", "Resolve 正在导出，桥接没有修改媒体。")
-        require(validated_host(resolve), "CAPABILITY_UNAVAILABLE", "该 Resolve 平台与构建尚未验证自动修改的帧边界。")
         require(before["fingerprint"] == params["expectedFingerprint"], "VERSION_CONFLICT", "Resolve 原素材的身份、关联或媒体规格已变化。")
         if operation == "replace":
             repair = params.get("offlineRepair")
@@ -1363,7 +1340,6 @@ def dispatch(resolve, operation, params):
         return after
     if operation == "insert":
         require(not project.IsRenderingInProgress(), "RESOLVE_BUSY", "Resolve 正在导出。")
-        require(validated_host(resolve), "CAPABILITY_UNAVAILABLE", "该 Resolve 平台与构建尚未验证插入的帧边界。")
         timeline = timeline_for(project, params["timelineId"])
         before = timeline_snapshot(project, scope, timeline, resolve)
         require(before["fingerprint"] == params["expectedTimelineFingerprint"], "VERSION_CONFLICT", "时间线在插入前发生变化。")
@@ -1419,7 +1395,7 @@ def dispatch(resolve, operation, params):
                                                         "mediaType": 1, "trackIndex": track, "recordFrame": record}]) or []
         require(len(created) == 1, "APPLY_OUTCOME_UNKNOWN", "Resolve 未返回唯一插入对象，需核对后恢复。")
         save_insert_progress(params, before, "appended", media, created[0])
-        item = item_snapshot(created[0], timeline.GetUniqueId(), track, True, {media.GetUniqueId(): media}, before["fps"])
+        item = item_snapshot(created[0], timeline.GetUniqueId(), track, {media.GetUniqueId(): media}, before["fps"])
         sampling_matches = item["sourceIn"] == start and item["sourceOut"] == end
         if spec["fps"] != before["fps"]:
             expected_start = start * spec["fps"]["den"] / spec["fps"]["num"]