@motionharness/bridge-davinci 0.0.0-stage → 0.0.22

package/dist/runtime_io.py

@@ -0,0 +1,31 @@
+"""File evidence and durable journals shared by the Resolve operations."""
+import hashlib
+import json
+import os
+import uuid
+
+
+def file_digest(path):
+    digest = hashlib.sha256()
+    with open(path, "rb") as stream:
+        for block in iter(lambda: stream.read(1024 * 1024), b""):
+            digest.update(block)
+    return "sha256:" + digest.hexdigest()
+
+
+def atomic_json(path, value, *, allow_nan=True):
+    pending = path + "." + str(uuid.uuid4()) + ".pending"
+    try:
+        with os.fdopen(os.open(pending, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600), "w", encoding="utf-8") as stream:
+            json.dump(value, stream, ensure_ascii=False, allow_nan=allow_nan)
+            stream.flush()
+            os.fsync(stream.fileno())
+        os.replace(pending, path)
+        descriptor = os.open(os.path.dirname(path), os.O_RDONLY)
+        try:
+            os.fsync(descriptor)
+        finally:
+            os.close(descriptor)
+    finally:
+        if os.path.exists(pending):
+            os.unlink(pending)

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@motionharness/bridge-davinci",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.22",
+  "private": false,
+  "type": "module",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VibeMG/vibe-motion-graphics.git",
+    "directory": "packages/bridge/davinci"
+  },
+  "description": "Optional DaVinci Resolve adapter for the Hotion Harness CLI",
+  "exports": {
+    ".": "./dist/runner.mjs"
+  },
+  "files": [
+    "dist/runner.mjs",
+    "dist/*.py",
+    "bridge-manifest.json",
+    "resources",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "OPENFX_LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "engines": {
+    "node": ">=22.18"
+  },
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ]
+}

package/resources/HotionHarness.ofx.bundle/Contents/Info.plist

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+<key>CFBundleIdentifier</key><string>com.hotionharness.bridge.davinci</string>
+<key>CFBundleName</key><string>Hotion Harness</string>
+<key>CFBundleExecutable</key><string>HotionHarness.ofx</string>
+<key>CFBundlePackageType</key><string>BNDL</string>
+<key>CFBundleVersion</key><string>1</string>
+</dict></plist>

package/resources/HotionHarnessStatus.app/Contents/Info.plist

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+<key>CFBundleIdentifier</key><string>com.hotionharness.bridge.status</string>
+<key>CFBundleName</key><string>Hotion Harness</string>
+<key>CFBundleDisplayName</key><string>Hotion Harness</string>
+<key>CFBundleExecutable</key><string>HotionHarnessStatus</string>
+<key>CFBundlePackageType</key><string>APPL</string>
+<key>CFBundleVersion</key><string>1</string>
+<key>CFBundleShortVersionString</key><string>1.0</string>
+<key>LSUIElement</key><true/>
+</dict></plist>

package/resources/legacy-forwarder.lua

@@ -0,0 +1,55 @@
+-- Hotion Harness legacy entry forwarder v1
+-- Explicit button callbacks only; image evaluation never executes this file.
+local helper, config, workspace = @@HELPER@@, @@CONFIG@@, @@WORKSPACE@@
+local function quote(value)
+    return "'" .. tostring(value):gsub("'", "'\\''") .. "'"
+end
+local function json_string(value)
+    assert(type(value) == 'string', 'Missing legacy entry identity')
+    return '"' .. value:gsub('[%z\1-\31\\"]', function(c)
+        if c == '\\' then return '\\\\' end
+        if c == '"' then return '\\"' end
+        return string.format('\\u%04x', string.byte(c))
+    end) .. '"'
+end
+local function clicked_target()
+    local application = Resolve()
+    local manager = application and application:GetProjectManager()
+    local project = manager and manager:GetCurrentProject()
+    local timeline = project and project:GetCurrentTimeline()
+    assert(timeline and not project:IsRenderingInProgress())
+    local video = nil
+    for _, item in ipairs(timeline:GetSelectedClips() or {}) do
+        if string.lower(item:GetType() or '') == 'video' then assert(video == nil); video = item end
+    end
+    assert(video)
+    return { projectId = project:GetUniqueId(), timelineId = timeline:GetUniqueId(), itemId = video:GetUniqueId() }
+end
+return function(request)
+    local ok, clicked = pcall(clicked_target)
+    local again_ok, again = pcall(clicked_target)
+    ok = ok and again_ok and clicked.projectId == again.projectId
+        and clicked.timelineId == again.timelineId and clicked.itemId == again.itemId
+        and type(request) == 'table' and (request.action == 'edit' or request.action == 'more')
+    if ok then
+        for _, key in ipairs({'workspaceKey', 'sourceId', 'bindingId'}) do
+            if type(request[key]) ~= 'string' or request[key] == '' then ok = false end
+        end
+    end
+    local action, payload = 'legacy', nil
+    if ok then
+        local fields = {'"workspace":' .. json_string(workspace)}
+        for _, key in ipairs({'action', 'workspaceKey', 'sourceId', 'bindingId'}) do
+            fields[#fields + 1] = json_string(key) .. ':' .. json_string(request[key])
+        end
+        fields[#fields + 1] = '"clicked":{"projectId":' .. json_string(clicked.projectId)
+            .. ',"timelineId":' .. json_string(clicked.timelineId) .. ',"itemId":' .. json_string(clicked.itemId) .. '}'
+        payload = '{' .. table.concat(fields, ',') .. '}'
+    else
+        action = 'error'
+        payload = '{"workspace":' .. json_string(workspace)
+            .. ',"code":"SELECTION_UNAVAILABLE","message":"无法确认当前所选片段，请只选择一个 Hotion Harness 片段后重试。"}'
+    end
+    os.execute(quote(helper) .. ' --config ' .. quote(config) .. ' --action ' .. quote(action)
+        .. ' --request ' .. quote(payload) .. ' >/dev/null 2>&1 &')
+end

package/resources/legacy-inspector-v1.lua

@@ -0,0 +1,31 @@
+-- MH Resolve Bridge inspector v1
+-- Called only by an explicit Inspector button. Nothing executes during rendering.
+local node, cli, workspace = @@NODE@@, @@CLI@@, @@WORKSPACE@@
+local mh, node_dir = @@MH@@, @@NODE_DIR@@
+
+local function quote(value)
+    return "'" .. tostring(value):gsub("'", "'\\''") .. "'"
+end
+
+local function json_string(value)
+    assert(type(value) == 'string', 'Hotion Harness Bridge: missing Inspector identity')
+    return '"' .. value:gsub('[%z\1-\31\\"]', function(c)
+        if c == '\\' then return '\\\\' end
+        if c == '"' then return '\\"' end
+        return string.format('\\u%04x', string.byte(c))
+    end) .. '"'
+end
+
+return function(request)
+    assert(type(request) == 'table', '请从 Hotion Harness Bridge 检查器按钮打开。')
+    assert(request.action == 'edit' or request.action == 'more', 'Hotion Harness Bridge: unknown action')
+    local fields = {}
+    for _, key in ipairs({'action', 'workspaceKey', 'sourceId', 'bindingId'}) do
+        fields[#fields + 1] = json_string(key) .. ':' .. json_string(request[key])
+    end
+    local payload = '{' .. table.concat(fields, ',') .. '}'
+    local command = 'PATH=' .. quote(node_dir) .. ':"$PATH" MH_BRIDGE_MH=' .. quote(mh) .. ' ' .. quote(node) .. ' ' .. quote(cli) .. ' inspector-action --workspace ' .. quote(workspace) .. ' --json ' .. quote(payload)
+    -- The controller opens public MH or the Bridge window. This UI callback
+    -- never waits on Resolve or MH, and never renders/synchronizes a video.
+    os.execute(command .. ' >/dev/null 2>&1 &')
+end

package/resources/menu-entry.py

@@ -0,0 +1,150 @@
+"""Installed menu: snapshot the selected video, then use the public CLI."""
+
+import json
+import hashlib
+import os
+import subprocess
+import sys
+import uuid
+from pathlib import Path
+
+
+class SelectionError(Exception):
+    def __init__(self, code, message):
+        super().__init__(message)
+        self.code = code
+
+
+def command_environment(config):
+    environment = dict(os.environ)
+    tools = config.get("tools") if isinstance(config.get("tools"), dict) else {}
+    paths = {name: path for name, path in tools.items()
+             if name in {"node", "pnpm", "ffmpeg", "ffprobe"}
+             and isinstance(path, str) and os.path.isabs(path)}
+    allowed = list(dict.fromkeys(os.path.dirname(path) for path in paths.values()))
+    preferred = config.get("toolDirectories")
+    preferred = preferred if isinstance(preferred, list) else []
+    directories = list(dict.fromkeys([value for value in preferred if value in allowed] + allowed))
+    if directories:
+        environment["PATH"] = os.pathsep.join(directories + [environment.get("PATH", "/usr/bin:/bin")])
+    for name in ("ffmpeg", "ffprobe"):
+        if name in paths:
+            environment["MH_" + name.upper()] = paths[name]
+    bridge_directory = config.get("bridgeDirectory")
+    if isinstance(bridge_directory, str) and os.path.isabs(bridge_directory):
+        environment["MH_BRIDGE_DIR"] = bridge_directory
+    return environment
+
+
+def selected_target(application, management=False):
+    if not application:
+        raise SelectionError("RESOLVE_UNAVAILABLE", "达芬奇尚未连接。请打开工程后重试。")
+    manager = application.GetProjectManager()
+    project = manager.GetCurrentProject()
+    timeline = project.GetCurrentTimeline() if project else None
+    if not timeline:
+        raise SelectionError("NO_TIMELINE", "请打开时间线并选择一个 Hotion Harness 片段。")
+    if project.IsRenderingInProgress():
+        raise SelectionError("RESOLVE_BUSY", "达芬奇正在导出，请完成后重试。")
+    selected = timeline.GetSelectedClips() or []
+    identifiers = sorted(item.GetUniqueId() for item in selected)
+    videos = [item for item in selected if item.GetType().lower() == "video"]
+    if len(videos) != 1:
+        raise SelectionError("SELECTION_AMBIGUOUS", "请只选择一个 Hotion Harness 视频片段。")
+    media = videos[0].GetMediaPoolItem()
+    if not media:
+        raise SelectionError("NOT_PLAIN_MEDIA", "所选片段没有普通视频素材。请先转换旧版生成器。")
+    encoded = (media.GetThirdPartyMetadata() or {}).get("motionharness.bridge") if media else None
+    try:
+        link = json.loads(encoded) if isinstance(encoded, str) else None
+    except (ValueError, TypeError):
+        link = None
+    linked = isinstance(link, dict) and link.get("schemaVersion") == 1 and all(
+        isinstance(link.get(key), str) and link[key] for key in ("bindingId", "sourceId", "artifactId")
+    )
+    if not linked and not management:
+        raise SelectionError("NOT_LINKED", "所选视频未关联 Hotion Harness 工程。")
+    database = manager.GetCurrentDatabase() if management else None
+    if management and (not isinstance(database, dict) or not database):
+        raise SelectionError("SCOPE_UNAVAILABLE", "无法确认当前工程位置，请检查达芬奇连接。")
+    current = manager.GetCurrentProject()
+    active = current.GetCurrentTimeline() if current else None
+    if not current or current.GetUniqueId() != project.GetUniqueId() or not active or active.GetUniqueId() != timeline.GetUniqueId() or sorted(
+        item.GetUniqueId() for item in (active.GetSelectedClips() or [])
+    ) != identifiers:
+        raise SelectionError("SELECTION_CHANGED", "所选片段已改变，请重新点击。")
+    if management:
+        if manager.GetCurrentDatabase() != database:
+            raise SelectionError("SELECTION_CHANGED", "当前工程位置已改变，请重新点击。")
+        database_id = "sha256:" + hashlib.sha256(json.dumps(database, sort_keys=True, separators=(",", ":"), ensure_ascii=False).encode()).hexdigest()
+        return {"selection": {"scope": {"databaseId": database_id, "projectId": project.GetUniqueId()},
+                "timelineId": timeline.GetUniqueId(), "itemId": videos[0].GetUniqueId(), "mediaPoolItemId": media.GetUniqueId(),
+                **({key: link[key] for key in ("bindingId", "sourceId", "artifactId")} if linked else {})}}
+    return {"bindingId": link["bindingId"], "selection": {
+        "projectId": project.GetUniqueId(), "mediaPoolItemId": media.GetUniqueId(),
+        "sourceId": link["sourceId"], "artifactId": link["artifactId"]}}
+
+
+def resolve_application():
+    application = globals().get("resolve")
+    if application:
+        return application
+    try:
+        import DaVinciResolveScript
+    except ImportError:
+        # Installed SDK locations, as documented by the Resolve scripting API.
+        sdk = "/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules"
+        if sys.platform == "darwin" and sdk not in sys.path:
+            sys.path.append(sdk)
+        import DaVinciResolveScript
+    return DaVinciResolveScript.scriptapp("Resolve")
+
+
+def main():
+    config_path = Path(__HOTION_CONFIG_PATH_JSON__)
+    status_path = Path(__HOTION_STATUS_PATH_JSON__)
+    action = __HOTION_ACTION_JSON__
+    if not status_path.is_absolute() or not status_path.is_file() or not os.access(status_path, os.X_OK):
+        raise RuntimeError("缺少 Hotion Harness 状态窗口，请运行 mh bridge davinci install 修复组件。")
+    repair = None
+    try:
+        config = json.loads(config_path.read_text(encoding="utf-8"))
+        if not isinstance(config, dict):
+            raise ValueError("invalid config")
+    except (OSError, ValueError, TypeError):
+        config = {}
+        repair = "桥接安装配置缺失或损坏，请运行 mh bridge davinci install 修复组件。"
+    if repair is None:
+        cli_path = config.get("cliPath")
+        executable = Path(cli_path) if isinstance(cli_path, str) and cli_path else None
+        if not executable or not executable.is_absolute() or not executable.is_file() or not os.access(executable, os.X_OK):
+            repair = "找不到 Hotion Harness 主程序，请运行 mh bridge davinci install 修复组件。"
+    request = {}
+    if isinstance(config.get("workspace"), str):
+        request["workspace"] = config["workspace"]
+    if repair:
+        action = "error"
+        request.update(code="INSTALL_MISSING", message=repair)
+    else:
+        try:
+            request.update(selected_target(resolve_application(), management=action == "manage"))
+        except SelectionError as error:
+            action = "error"
+            request.update(code=error.code, message=str(error))
+        except (ImportError, AttributeError, RuntimeError):
+            action = "error"
+            request.update(code="SELECTION_UNAVAILABLE", message="无法读取所选片段，请检查达芬奇脚本连接。")
+    if action == "update":
+        request["idempotencyKey"] = str(uuid.uuid4())
+    arguments = [str(status_path), "--config", str(config_path), "--action", action,
+                 "--request", json.dumps(request, ensure_ascii=False)]
+    subprocess.Popen(arguments, stdin=subprocess.DEVNULL,
+                     stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL,
+                     env=command_environment(config), close_fds=True, start_new_session=True)
+    print(request["message"] if action == "error" else "正在打开 Hotion Harness 工程…" if action == "edit" else
+          "正在读取所选 Hotion Harness 片段…" if action == "manage" else
+          "正在提交 Hotion Harness 请求，状态窗口将显示进度。")
+
+
+if __name__ == "__main__":
+    main()

package/resources/sidebar-help/index.html

@@ -0,0 +1,35 @@
+<!doctype html>
+<html lang="zh-CN">
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>添加 Hotion Harness 侧栏入口</title>
+<style>
+  :root{color-scheme:light dark;font:15px/1.7 system-ui,-apple-system,sans-serif;color:#e9e9ed;background:#191a1e}
+  *{box-sizing:border-box}body{max-width:1080px;margin:auto;padding:32px 24px}h1{font-size:26px;line-height:1.3;margin:0 0 10px}p{margin:10px 0;color:#bfc0ca}
+  ol{padding-left:24px}li{padding-left:6px;margin:14px 0}strong{color:#fff}kbd,code{font:inherit;background:#303139;border-radius:5px;padding:2px 6px}
+  figure{position:relative;margin:24px 0 8px;border:1px solid #555661;border-radius:10px;overflow:hidden}img{display:block;width:100%;height:auto}
+  .pin{position:absolute;color:#fff;background:#275bd9;border:2px solid white;border-radius:50%;width:25px;height:25px;line-height:21px;text-align:center;font-size:13px;font-weight:700;box-shadow:0 1px 6px #000}
+  .one{left:13%;top:1%}.two{left:9%;top:7%}.three{left:23%;top:71%}
+  .caption{font-size:13px}details{margin:14px 0}summary{cursor:pointer;color:#9cbeff}.full{overflow:auto;max-height:70vh;border:1px solid #555661;margin-top:10px}.full img{width:1512px;max-width:none}
+  aside{border-top:1px solid #40414b;margin-top:24px;padding-top:16px}a{color:#9cbeff}
+  @media(max-width:520px){body{padding:20px 16px}h1{font-size:22px}.pin{width:20px;height:20px;line-height:16px;font-size:11px}}
+</style>
+<h1>添加侧栏编辑入口</h1>
+<p>这是一个可选入口。通过桥接发送的素材已经关联源工程，添加效果不会重新导出视频。</p>
+<ol>
+  <li>进入达芬奇的<strong>「剪辑」页</strong>，打开左上角的<strong>「特效库」</strong>（魔棒图标）。</li>
+  <li>点击特效库的放大镜，搜索 <strong>Hotion Harness</strong>。找到 Open FX 中的同名效果，将它<strong>拖到时间线上的目标动效片段</strong>。</li>
+  <li>选中这个片段，打开右侧<strong>「检查器 → 特效 → Open FX」</strong>，点击<strong>「编辑 Hotion Harness 工程」</strong>。</li>
+</ol>
+<figure>
+  <img src="resolve-sidebar.png" alt="达芬奇真实界面：左上方打开特效库，搜索 Hotion Harness，搜索结果可拖到下方时间线的动效示例片段。">
+  <span class="pin one" aria-hidden="true">1</span><span class="pin two" aria-hidden="true">2</span><span class="pin three" aria-hidden="true">3</span>
+</figure>
+<p class="caption">真实界面截图 · ① 特效库　② 搜索框与效果列表　③ 拖入目标片段。窗口宽度不同时，工具栏可能只显示图标。</p>
+<details><summary>放大截图</summary><div class="full"><img src="resolve-sidebar.png" alt="可横向滚动查看的达芬奇界面大图"></div></details>
+<aside>
+  <p><strong>快捷方式：</strong>先选中片段，按 <kbd>Shift</kbd> + <kbd>Space</kbd>，搜索 Hotion Harness 并点击添加。快捷键被自定义时，请使用上面的特效库路径。</p>
+  <p><strong>找不到效果？</strong>先安装桥接组件：<code>mh bridge davinci install</code>。安装完成后保存工程并重启达芬奇，再搜索。</p>
+  <p><strong>暂时不添加也可以：</strong>从「工作区 → 脚本 → Utility → Hotion Harness → 编辑工程」打开工程。已经添加过效果的片段无需重复添加。</p>
+</aside>
+</html>