Fcp Bridge

拼接套件

   

Final Cut Pro，解锁。一个命令面板、MCP服务器和一个开放的插件框架，几乎可以做任何事情。

编辑？从这里开始。 这 SplitKit官方网站 和那个 常见问题 是最友好的方式。问题、帮助或功能请求？加入SplitKit频道 FCP咖啡厅不和谐Bug报告： . 迫不及待地想看看你怎么处理它。🥳

______________________________________________________________________

三大支柱

🎹 1.命令面板

*对任何东西只敲一个键。*

击打 Cmd+Shift+P 在修补的FCP内部。模糊搜索100+内置编辑操作——刀片、修剪、颜色、速度、标记、效果、过渡、导出——或键入纯英语，然后让 苹果智能 （在设备上，私人）弄清楚你的意思。


试着说…

• *“每5秒添加一次标记”*
• *“将此剪辑减慢到一半速度”*
• *“每个场景都有变化”*
• *“消除所有沉默”*
• *“添加交叉溶解”*

不再搜索菜单。不再记忆捷径。没有云。

______________________________________________________________________

🤖 2.MCP服务器

*Claude（或任何其他法学硕士）可以驱动你的编辑器，并教它新的技巧。*

SplitKit附带了一个MCP服务器，该服务器提供了约200个工具，涵盖了每个主要的FCP子系统。点 克劳德代码, 克劳德桌面版，或任何与MCP兼容的AI客户端，你可以说：

• *“把这次40分钟的采访缩短到最好的时刻”*
• *删除此播客中的静音，添加字幕，然后导出*
• *“从这些剪辑中拼凑出一个粗略的剪辑，与这首歌的节拍同步”*

它不是围绕键盘快捷键的聊天包装。MCP直接与FCP的内部ObjC运行时对话，因此它可以读取时间线状态、检查剪辑、刀片、重定时、颜色校正、应用效果和渲染，而无需触摸UI。

每周都变得更聪明的编辑

当你第一次要求复杂的东西时，人工智能可能有点笨拙。这是即兴创作——将基本元素拼接在一起，根据你的时间线试错，偶尔会选择很长的路。

当这种情况发生时，不要满足于解决方法。 告诉它培养能力。

每一次笨拙的第一次尝试都是将该工作流转化为一流功能的提示。你六个月后使用的编辑器比你今天安装的编辑器更智能，而且大部分改进不会来自SpliceKit团队。它将来自你，以及社区将插件运回。

______________________________________________________________________

🧩 3.插件框架

*一切都是插件。*

SplitKit不是一个功能列表，而是一个平台。一旦SpliceKit dylib加载到Final Cut Pro中，整个ObjC运行时（78000多个类，包括所有私有API）都将开放供插件使用。

插件可以做什么

• 在FCP中添加新的面板和窗口
• 在工具栏、菜单或增强功能菜单上放置按钮
• 在命令选项板中注册命令
• 通过MCP服务器公开新工具
• 连接到时间线事件、选择更改和播放
• 发布自定义运动模板、FxPlug效果和工作流扩展
• 用Objective-C/C++、Swift、Lua或Python编写

你可以让人工智能来构建一个

描述你想要什么。把说明书交给克劳德。它根据SpliceKit框架编写插件——该项目提供了为人工智能消费设计的完整API参考文档。

______________________________________________________________________

示例插件（盒子里有什么）

每一个都是一个插件。它们被捆绑在一起，这样你就可以在安装SpliceKit的那天使用它，它们也可以作为任何构建自己的工作示例。

基于文本的编辑器

使用设备上的语音识别（NVIDIA Parakeet-25种语言，无云，带扬声器日记）转录时间线上的每个片段。点击一个单词跳转到那里。选择一个句子，点击删除，视频将被剪切以匹配。拖动单词以重新排序剪辑。导出为SRT或纯文本。


音频混音器

混合方式 角色，而不是逐个剪辑。将压缩器、均衡器或混响放在Dialogue总线上，每个标记为Dialogue的剪辑都会继承它——过去、现在和未来。重新设置剪辑的角色，它会立即接受新总线的处理。从一个面板中为每个角色设置音量、独奏和静音。


章节

时间线上方的颜色编码部分栏，一目了然地显示您的编辑形状。命名部分，为其着色，点击一下即可在它们之间跳转——非常适合长篇编辑、播客、多章项目，或者任何你想在不擦洗的情况下看到结构的地方。


静音去除器

将其指向采访或播客录音，它会发现并切断每一个无声的停顿。可配置的阈值、最小持续时间和填充。纯苹果原生AVFoundation+引擎盖下加速。

社交媒体标题

生成13种内置样式（粗体流行、霓虹灯、卡拉OK、打字机、弹跳等）的逐字高亮动画字幕。字幕直接作为可编辑的动态标题出现在您的时间线上。

场景检测

使用vImage直方图比较查找镜头中的每个镜头变化。添加标记、剪切时间线或两者兼而有之。

节拍检测和歌曲剪辑

从任何音乐文件中提取BPM、节拍、小节和歌曲部分。手 歌曲剪辑 一首音乐曲目和一个片段文件夹，并在您的时间线上恢复一个节拍同步的音乐视频，具有可选择的节奏（自然、中等、快速、激进）或自定义步长。

LiveCam

内置网络摄像头亭，可直接录制到您的库或活动时间线。实时预览，带有颜色调整、音频仪表和适用于人的主题提升绿屏磨砂 *和* 对象（macOS 14+）。选择“透明”作为绿色屏幕颜色，LiveCam将ProRes 4444写入一个真正的alpha通道。

URL导入

粘贴YouTube、Vimeo或Twitter链接，并将其作为真实剪辑拉入您的库中。自动发现 yt-dlp 和 ffmpeg 从您的shell PATH。

批量导出

只需一个命令，时间线上的每个剪辑都会导出为自己的文件——所有效果、颜色等级和过渡都会内置。

原生BRAW和VP9支持

放下Blackmagic RAW(.braw)VP9/WebM文件直接放在您的时间线上——无需转码、无包装、无需安装第三方工具包。SpliceKit附带了一个BRAW RAW处理器和一个VP9解码器，可通过苹果的MediaExtension框架插入FCP，因此剪辑显示为具有缩略图、擦除和全质量解码的一流媒体。对于任何剪切Blackmagic相机镜头或从网络上下载WebM视频的人来说，这都是一个巨大的解锁。

双时间线、FlexMusic、蒙太奇制作、OpenTimelineIO交换、Lua REPL、进程内调试器…

…以及更多。它们中的每一个都是代码 Sources/ 你可以通过阅读、叉选或直觉来寻找零件。

______________________________________________________________________

60秒内安装

最简单的方法是GUI修补程序。下载最新版本，打开它，单击按钮。


1. 下载 拼接套件 从 最新版本
2. 解压缩并打开应用程序
3. 点击 补丁 --它处理其余的事情

修补程序将Final Cut Pro复制到 ~/Applications/SpliceKit/，注入SpliceKit dylib，重新签名，并设置MCP服务器。 您的原始Final Cut Pro从未被触碰。

完成后，单击 启动FCP 在修补程序中，或从打开新副本 ~/Applications/SpliceKit/.按 Cmd+Shift+P 打开命令面板，您就可以关闭了。

更喜欢终端？ ./patcher/patch_fcp.sh 做同样的工作。

______________________________________________________________________

将其连接到Claude（或任何MCP客户端）

GUI修补程序为您设置MCP服务器。如果您跳过了该步骤，或者您正在从仓库签出中运行，那么这是手动路径。

单线设置

make mcp-setup

这在以下位置创建了一个孤立的Python虚拟环境 ~/.venvs/splicekit-mcp 并从以下位置安装固定依赖项 mcp/requirements.txt.

如果你更喜欢手工操作：

python3 -m venv ~/.venvs/splicekit-mcp
~/.venvs/splicekit-mcp/bin/python -m pip install -r mcp/requirements.txt

确认所有东西都连接好了

make mcp-doctor

检查venv是否存在， mcp 清洁进口， .mcp.json 指向venv，FCP网桥正在监听 127.0.0.1:9876.

将MCP客户端指向服务器

使用虚拟环境的Python作为MCP commandThe args 路径取决于您安装SpliceKit的方式：

从回购结算：

{
  "mcpServers": {
    "splicekit": {
      "command": "/Users/yourname/.venvs/splicekit-mcp/bin/python",
      "args": ["/absolute/path/to/SpliceKit/mcp/server.py"]
    }
  }
}

从打包的安装程序中：

{
  "mcpServers": {
    "splicekit": {
      "command": "/Users/yourname/.venvs/splicekit-mcp/bin/python",
      "args": ["/Applications/SpliceKit.app/Contents/Resources/mcp/server.py"]
    }
  }
}

MCP服务器连接到Final Cut Pro中运行的SplitKit桥接器 127.0.0.1:9876 --所以补丁的Final Cut Pro必须运行。

______________________________________________________________________

这安全吗？这合法吗？苹果会禁止我吗？

简短回答： 是的，它是安全的。是的，这是合法的。不，苹果不会禁止你。

• 您的FCP保持不变。 SplitKit制作了一个 *复制* 在 ~/Applications/SpliceKit/。您的App Store FCP永远不会被修改。安装不会影响您的库、项目和媒体文件。
• 这是合法的。 互操作性的逆向工程受到明确保护 DMCA第1201（f）条 （美国）和欧盟软件指令。SpliceKit获得了麻省理工学院的许可。
• 苹果公司没有禁止运行经过修改的本地应用程序的Apple ID。 没有先例，其机制（dyld注入+代码签名）与BetterTouchTool、Alfred、Hammerspoon、可访问性工具和每个Xcode调试器会话使用的机制相同。
• 现实风险 FCP更新可能会破坏兼容性（只需重新修补），私有API在边缘情况下可能会出现意外行为（Cmd+Z是你的朋友）。

设计稳定

SpliceKit的设计至少与库存FCP一样稳定，而且在几个方面，其稳定性要高得多。

• 完全可逆，任何时候。 SpliceKit永远不会改变FCP存储项目、库或媒体的方式。随时退出修补副本，在香草版App Store FCP中打开完全相同的库，并继续编辑，零损失。没有什么被锁定，没有什么被迁移。
• 与任何FXPlug 4插件相同的安全级别，具有更多的余量。 SpliceKit插件与苹果自己的FXPlug系统在相同的信任级别上运行，其架构为我们提供了比FXPlug更多的工具。昂贵的工作在后台线程上运行，热路径被明确设计为不争用，状态更改受到保护，因此插件不会踩到FCP的内部。当FXPlug插件必须希望FCP从性能峰值中恢复时，SpliceKit的构建是为了从一开始就防止峰值的发生。
• SpliceKit积极修复本地FCP错误。 FCP中的一些长期问题已经在修改后的副本中得到了修补，这意味着修补后的版本在这些领域比库存更稳定-- 这是一个视频示例.
• 内置自动碰撞报告功能 （通过Sentry）用于修补程序和注入运行时，因此任何意外的情况都会立即出现并迅速得到解决。共享日志 Discord 的中文翻译是“不和谐”或“纷争”。 或 对于额外的上下文仍然有用。

完整的纯英文版本在 docs/WHAT_IS_SPLICEKIT.md.

______________________________________________________________________

构建插件

如果你是来建造东西的，这是给你的部分。

到底发生了什么

SpliceKit将动态库注入Final Cut Pro的重新签名副本中。加载后：

• 完整的ObjC运行时已公开（78000多个类，包括所有私有API）
• JSON-RPC 2.0服务器监听 127.0.0.1:9876
• MCP服务器将工具调用转换为网桥RPC
• Flexo、Ozone、TimelineKit、LunaKit、Helium、ProCore——所有FCP的内部框架——都可以通过直接访问 objc_msgSend
• CloudKit/ImagePlayground周围的崩溃点（需要重新签名的应用程序没有的权限）被清除了

┌─────────────────────────────────────────────┐
│  Final Cut Pro (patched copy)               │
│  ┌───────────────────────────────────────┐  │
│  │  SpliceKit.framework (LC_LOAD_DYLIB)  │  │
│  │  ├── Command Palette                  │  │
│  │  ├── MCP / JSON-RPC server on :9876   │  │
│  │  ├── Plugin loader (hot-reload)       │  │
│  │  └── your plugins here                │  │
│  └───────────┬───────────────────────────┘  │
│              │ objc_msgSend                  │
│  ┌───────────▼───────────────────────────┐  │
│  │  Flexo / Ozone / TimelineKit / ...    │  │
│  └───────────────────────────────────────┘  │
└──────────────────────┬──────────────────────┘
                       │ TCP :9876
        ┌──────────────▼──────────────┐
        │  MCP server / Python REPL / │
        │  nc / curl / Lua / your app │
        └─────────────────────────────┘

建设方式

• 原生插件 （ObjC/Swift/C++）——链接到 SpliceKit.framework，将你的dylib放入插件文件夹，用热加载 debug.loadPlugin示例 Plugins/ 和 Sources/.
• 卢，FCP内部 --Ctrl+Opt+L打开一个REPL sk 模块。掉落 .lua 文件进入 ~/Library/Application Support/SpliceKit/lua/auto/ 用于实时编码。完整SDK docs/LUA_SDK_REFERENCE.md.
• Python/任何带有TCP套接字的语言 — python3 Scripts/splicekit_client.py 为您提供交互式运行时REPL。或者： echo '{"jsonrpc":"2.0","method":"system.version","id":1}' | nc 127.0.0.1 9876
• MCP工具 --将插件的功能作为MCP工具公开，任何AI客户端都可以驱动它们。
• 让AI来构建它 -中的API参考 docs/ 被写为AI消耗品。描述你想要什么，把规范交给Claude，它就可以为你编写插件。
• 打开一个PR到SplitKit本身 --如果您构建的内容对其他编辑器有用，请将其发送到上游。捆绑的“功能”（基于文本的编辑器、静音去除器、LiveCam、歌曲剪辑等）都是作为插件开始的。分叉仓库，放入你的插件 Plugins/ 或 Sources/，并打开a 拉取请求 --社区插件是SpliceKit成长的方式。

值得了解的关键FCP内部

从源代码构建

git clone https://github.com/elliotttate/SpliceKit.git
cd SpliceKit
make all && make deploy

文档地图

• docs/WHAT_IS_SPLICEKIT.md --简明英语之旅
• docs/FCP_API_REFERENCE.md -FCP内部构件的完整API参考
• docs/COMMAND_PALETTE_GUIDE.md --命令面板和苹果智能
• docs/LUA_SDK_REFERENCE.md · docs/LUA_SCRIPTING_GUIDE.md --Lua插件脚本
• docs/TRANSCRIPT_EDITING_GUIDE.md --基于文本编辑器插件
• docs/FXPLUG_PLUGIN_GUIDE.md --FxPlug 4插件开发
• docs/WORKFLOW_EXTENSIONS_GUIDE.md --工作流扩展
• docs/DEBUG_TOOLS_GUIDE.md --进程内调试、跟踪、热加载
• docs/RUNTIME_INTROSPECTION_GUIDE.md --ObjC运行时探索
• docs/FCPXML_FORMAT_REFERENCE.md --FCPXML格式
• docs/SCENE_BEAT_DETECTION_GUIDE.md · docs/FLEXMUSIC_AND_MONTAGE_GUIDE.md --检测和蒙太奇插件

______________________________________________________________________

社区

• 问题、帮助、功能请求: FCP咖啡厅不和谐 （SplitKit通道）
• 错误报告:
• 功能、视频、常见问题: splitkit.fcp.cafe

社区改造项目被重新采用到他们扩展的官方产品中有着悠久的传统。如果SpliceKit有助于推动Final Cut Pro向前发展，那么每个人都会赢。

______________________________________________________________________

许可证

麻省理工学院.使用它，修改它，用它来发布你自己的插件。

向前和向上🥳