@motionharness/bridge-davinci 0.0.22 → 0.0.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@motionharness/bridge-davinci",
-  "version": "0.0.22",
+  "version": "0.0.25",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -9,7 +9,7 @@
     "url": "git+https://github.com/VibeMG/vibe-motion-graphics.git",
     "directory": "packages/bridge/davinci"
   },
-  "description": "Optional DaVinci Resolve adapter for the Hotion Harness CLI",
+  "description": "MotionHarness Bridge Component for DaVinci Resolve",
   "exports": {
     ".": "./dist/runner.mjs"
   },

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

@@ -2,7 +2,7 @@
 <!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>CFBundleName</key><string>MotionHarness Bridge Component</string>
 <key>CFBundleExecutable</key><string>HotionHarness.ofx</string>
 <key>CFBundlePackageType</key><string>BNDL</string>
 <key>CFBundleVersion</key><string>1</string>

package/resources/{HotionHarnessStatus.app → MotionHarnessBridge.app}/Contents/Info.plist

@@ -2,9 +2,9 @@
 <!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>CFBundleName</key><string>MotionHarness Bridge Component</string>
+<key>CFBundleDisplayName</key><string>MotionHarness Bridge Component</string>
+<key>CFBundleExecutable</key><string>MotionHarnessBridge</string>
 <key>CFBundlePackageType</key><string>APPL</string>
 <key>CFBundleVersion</key><string>1</string>
 <key>CFBundleShortVersionString</key><string>1.0</string>

package/resources/MotionHarnessBridge.app/Contents/Resources/en.lproj/InfoPlist.strings

@@ -0,0 +1,2 @@
+"CFBundleDisplayName" = "MotionHarness Bridge Component";
+"CFBundleName" = "MotionHarness Bridge Component";

package/resources/MotionHarnessBridge.app/Contents/Resources/zh-Hans.lproj/InfoPlist.strings

@@ -0,0 +1,2 @@
+"CFBundleDisplayName" = "MotionHarness 桥接组件";
+"CFBundleName" = "MotionHarness 桥接组件";

package/resources/legacy-forwarder.lua

@@ -1,4 +1,4 @@
--- Hotion Harness legacy entry forwarder v1
+-- Motion 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)
@@ -48,7 +48,7 @@ return function(request)
     else
         action = 'error'
         payload = '{"workspace":' .. json_string(workspace)
-            .. ',"code":"SELECTION_UNAVAILABLE","message":"无法确认当前所选片段，请只选择一个 Hotion Harness 片段后重试。"}'
+            .. ',"code":"SELECTION_UNAVAILABLE","message":"无法确认当前所选片段，请只选择一个 MotionHarness 片段后重试。"}'
     end
     os.execute(quote(helper) .. ' --config ' .. quote(config) .. ' --action ' .. quote(action)
         .. ' --request ' .. quote(payload) .. ' >/dev/null 2>&1 &')

package/resources/menu-entry.py

@@ -9,6 +9,13 @@ import uuid
 from pathlib import Path
 
 
+_translations = {}
+
+
+def tr(source):
+    return _translations.get(source, source)
+
+
 class SelectionError(Exception):
     def __init__(self, code, message):
         super().__init__(message)
@@ -33,27 +40,28 @@ def command_environment(config):
     bridge_directory = config.get("bridgeDirectory")
     if isinstance(bridge_directory, str) and os.path.isabs(bridge_directory):
         environment["MH_BRIDGE_DIR"] = bridge_directory
+    environment["MH_UI_LOCALE"] = os.environ.get("MH_UI_LOCALE", config.get("locale", "zh-CN"))
     return environment
 
 
 def selected_target(application, management=False):
     if not application:
-        raise SelectionError("RESOLVE_UNAVAILABLE", "达芬奇尚未连接。请打开工程后重试。")
+        raise SelectionError("RESOLVE_UNAVAILABLE", tr("达芬奇尚未连接。请打开工程后重试。"))
     manager = application.GetProjectManager()
     project = manager.GetCurrentProject()
     timeline = project.GetCurrentTimeline() if project else None
     if not timeline:
-        raise SelectionError("NO_TIMELINE", "请打开时间线并选择一个 Hotion Harness 片段。")
+        raise SelectionError("NO_TIMELINE", tr("请打开时间线并选择一个 MotionHarness 片段。"))
     if project.IsRenderingInProgress():
-        raise SelectionError("RESOLVE_BUSY", "达芬奇正在导出，请完成后重试。")
+        raise SelectionError("RESOLVE_BUSY", tr("达芬奇正在导出，请完成后重试。"))
     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 视频片段。")
+        raise SelectionError("SELECTION_AMBIGUOUS", tr("请只选择一个 MotionHarness 视频片段。"))
     media = videos[0].GetMediaPoolItem()
     if not media:
-        raise SelectionError("NOT_PLAIN_MEDIA", "所选片段没有普通视频素材。请先转换旧版生成器。")
+        raise SelectionError("NOT_PLAIN_MEDIA", tr("所选片段没有普通视频素材。请先转换旧版生成器。"))
     encoded = (media.GetThirdPartyMetadata() or {}).get("motionharness.bridge") if media else None
     try:
         link = json.loads(encoded) if isinstance(encoded, str) else None
@@ -63,19 +71,19 @@ def selected_target(application, management=False):
         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 工程。")
+        raise SelectionError("NOT_LINKED", tr("所选视频未关联 MotionHarness 工程。"))
     database = manager.GetCurrentDatabase() if management else None
     if management and (not isinstance(database, dict) or not database):
-        raise SelectionError("SCOPE_UNAVAILABLE", "无法确认当前工程位置，请检查达芬奇连接。")
+        raise SelectionError("SCOPE_UNAVAILABLE", tr("无法确认当前工程位置，请检查达芬奇连接。"))
     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", "所选片段已改变，请重新点击。")
+        raise SelectionError("SELECTION_CHANGED", tr("所选片段已改变，请重新点击。"))
     if management:
         if manager.GetCurrentDatabase() != database:
-            raise SelectionError("SELECTION_CHANGED", "当前工程位置已改变，请重新点击。")
+            raise SelectionError("SELECTION_CHANGED", tr("当前工程位置已改变，请重新点击。"))
         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(),
@@ -104,8 +112,8 @@ 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 修复组件。")
+    global _translations
+    _translations = {}
     repair = None
     try:
         config = json.loads(config_path.read_text(encoding="utf-8"))
@@ -113,12 +121,18 @@ def main():
             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 修复组件。"
+        repair = tr("桥接安装配置缺失或损坏，请运行 mh bridge davinci install 修复组件。")
+    if os.environ.get("MH_UI_LOCALE", config.get("locale", "zh-CN")).startswith("en"):
+        try:
+            translations = json.loads(Path(config["translationsPath"]).read_text(encoding="utf-8"))
+            if isinstance(translations, dict):
+                _translations = translations
+        except (OSError, ValueError, TypeError, KeyError):
+            pass
+    if not status_path.is_absolute() or not status_path.is_file() or not os.access(status_path, os.X_OK):
+        raise RuntimeError(tr("缺少 MotionHarness 状态窗口，请运行 mh bridge davinci install 修复组件。"))
+    # The shared helper resolves the installed CLI launcher. Checking the old
+    # platform-binary path here would incorrectly reject a completed npm upgrade.
     request = {}
     if isinstance(config.get("workspace"), str):
         request["workspace"] = config["workspace"]
@@ -133,7 +147,7 @@ def main():
             request.update(code=error.code, message=str(error))
         except (ImportError, AttributeError, RuntimeError):
             action = "error"
-            request.update(code="SELECTION_UNAVAILABLE", message="无法读取所选片段，请检查达芬奇脚本连接。")
+            request.update(code="SELECTION_UNAVAILABLE", message=tr("无法读取所选片段，请检查达芬奇脚本连接。"))
     if action == "update":
         request["idempotencyKey"] = str(uuid.uuid4())
     arguments = [str(status_path), "--config", str(config_path), "--action", action,
@@ -141,9 +155,9 @@ def main():
     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 请求，状态窗口将显示进度。")
+    print(request["message"] if action == "error" else tr("正在打开 MotionHarness 工程…") if action == "edit" else
+          tr("正在读取所选 MotionHarness 片段…") if action == "manage" else
+          tr("正在提交 MotionHarness 请求，状态窗口将显示进度。"))
 
 
 if __name__ == "__main__":

package/resources/sidebar-help/en.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>MotionHarness Bridge Component · Add the sidebar editing entry</title>
+<link rel="stylesheet" href="guide.css">
+<h1>Add the sidebar editing entry</h1><p>The media sent through the bridge is already linked to its source project. Adding this optional effect does not render the video again.</p>
+<ol><li>On the <strong>Edit</strong> page in DaVinci Resolve, open the <strong>Effects Library</strong> (magic wand icon).</li><li>Search for <strong>MotionHarness Bridge Component</strong> and drag the Open FX effect onto the target animation clip.</li><li>Select the clip and click <strong>Edit MotionHarness project</strong> under <strong>Inspector → Effects → Open FX</strong>.</li></ol>
+<div class="diagram" role="img" aria-label="Illustration: Effects Library, inspector and target clip">
+<section class="panel"><h2>① Effects Library</h2><div class="search">⌕ MotionHarness</div><div class="effect">② MotionHarness Bridge Component</div></section>
+<section class="panel"><h2>Inspector → Effects → Open FX</h2><div class="effect">Edit MotionHarness project</div><p>Update this media · Check status · More…</p></section>
+<div class="timeline"><div class="clip">③ Target animation clip · Add the effect here</div></div></div>
+<p class="caption">Layout illustration. Labels follow the language selected when installing the component. Search for “MotionHarness” in either language.</p><aside><p><strong>Shortcut:</strong> Select the clip, press <kbd>Shift</kbd> + <kbd>Space</kbd>, and search for MotionHarness. If your shortcuts are customized, use the Effects Library.</p><p><strong>Cannot find the effect?</strong> Install the MotionHarness Bridge Component with <code>mh bridge davinci install</code>. Save your project and restart DaVinci Resolve after installation.</p><p><strong>Menu alternative:</strong> Workspace → Scripts → Utility → MotionHarness Bridge Component → Edit project. Clips with the effect already attached do not need it added again.</p></aside>
+</html>

package/resources/sidebar-help/guide.css

@@ -0,0 +1,14 @@
+/* Offline bridge guides use the graphite Studio palette in either language. */
+:root{color-scheme:dark;font:14px/1.6 "PingFang SC",system-ui,sans-serif;color:#e8e8e6;background:#17181a}
+*{box-sizing:border-box}
+body{max-width:960px;margin:auto;padding:24px}
+h1{margin:0 0 8px;font-size:22px;line-height:1.35}
+p,li{color:#a5a6aa}li{margin:10px 0}strong{color:#e8e8e6}
+code,kbd{padding:2px 6px;border-radius:4px;background:#25262a;font:12px/1.6 ui-monospace,monospace;overflow-wrap:anywhere}
+.diagram{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px;padding:16px;background:#1d1e21;border:1px solid #ffffff1c;border-radius:12px}
+.panel{min-width:0;padding:12px;border:1px solid #ffffff1c;border-radius:6px}.panel h2{margin:0 0 12px;font-size:14px}
+.search,.effect,.clip{margin:8px 0;padding:8px 10px;border-radius:4px;background:#25262a}
+.effect,.clip{border-inline-start:2px solid #ff6a1a;background:#ff6a1a12}
+.timeline{grid-column:1/-1;border-top:1px solid #ffffff1c;padding-top:12px}
+.caption{font-size:12px}aside{border-top:1px solid #ffffff1c;margin-top:20px;padding-top:8px}
+@media(max-width:600px){body{padding:16px}.diagram{grid-template-columns:minmax(0,1fr)}}

package/resources/sidebar-help/index.html

@@ -1,35 +1,13 @@
 <!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>
+<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>MotionHarness 桥接组件 · 添加侧栏编辑入口</title>
+<link rel="stylesheet" href="guide.css">
+<h1>添加侧栏编辑入口</h1><p>通过桥接发送的素材已关联源工程。添加这个可选效果不会重新导出视频。</p>
+<ol><li>进入达芬奇的<strong>「剪辑」页</strong>，打开左上角的<strong>「特效库」</strong>（魔棒图标）。</li><li>搜索 <strong>MotionHarness 桥接组件</strong>，将 Open FX 中的同名效果拖到时间线上的目标动效片段。</li><li>选中片段，在<strong>「检查器 → 特效 → Open FX」</strong>中点击<strong>「编辑 MotionHarness 工程」</strong>。</li></ol>
+<div class="diagram" role="img" aria-label="特效库、检查器和目标片段的布局示意">
+<section class="panel"><h2>① 特效库</h2><div class="search">⌕ MotionHarness</div><div class="effect">② MotionHarness 桥接组件</div></section>
+<section class="panel"><h2>检查器 → 特效 → Open FX</h2><div class="effect">编辑 MotionHarness 工程</div><p>更新此素材 · 查看状态 · 更多…</p></section>
+<div class="timeline"><div class="clip">③ 目标动效片段 · 将效果拖到这里</div></div></div>
+<p class="caption">布局示意图。名称按组件安装时的语言显示；中英文均可搜索“MotionHarness”。</p><aside><p><strong>快捷方式：</strong>选中片段，按 <kbd>Shift</kbd> + <kbd>Space</kbd>，搜索 MotionHarness 并添加。快捷键被自定义时，请使用特效库。</p><p><strong>找不到效果？</strong>先安装 MotionHarness 桥接组件：<code>mh bridge davinci install</code>。安装完成后保存工程并重启达芬奇。</p><p><strong>也可以使用菜单：</strong>工作区 → 脚本 → Utility → MotionHarness 桥接组件 → 编辑工程。已经添加过效果的片段无需重复添加。</p></aside>
 </html>