Kinocut

Kinocut

为 AI Agent 提供带护栏的视频编辑 MCP 服务。
本地优先的 FFmpeg 工具、Video Receipts、质量关卡、Hyperframes，以及 Shorts/Reels 内容再利用方案 — 适用于 Claude Code、Cursor 和任何 MCP 客户端。免费，采用 Apache-2.0 许可证。前身为 mcp-video。

演示 • 状态 • 1.16.5 • 1.16.4 • 1.16.3 • 1.16.2 • 1.16.1 • 更新日志 • 后续规划 • 安装 • 快速入门 • 工具 • 工具参考 • 修复 • 360° 组装 • AI 视频 • Agent 技能 • kinocut.dev • 什么是 Kinocut？ • 常见问题 • llms.txt

Kinocut 是一个免费、开源的视频编辑 MCP 服务和 AI Agent 工作流引擎（另提供 Python 客户端和 kino CLI），让 AI Agent 使用类型化工具和 Video Receipts 修剪、添加字幕、再利用本地视频媒体并进行质量检查，而不是凭空编造 FFmpeg 标志。

目录

• 什么是 Kinocut？
• 看看它如何运行
• 安装
• 快速入门
• MCP 工具
• 状态和版本发布
• 360 双摄组装
• 更新日志
• 常见问题
• Agent 技能

---

什么是 Kinocut？

简而言之： Kinocut 是一款免费的、本地优先的视频编辑 MCP 服务（另附 Python 客户端和 kino CLI），让 AI Agent 能使用类型化工具和视频回执来剪辑、添加字幕、改编内容并进行质量把关，而不是凭空编造 FFmpeg 参数。

Kinocut 是免费的开源 Model Context Protocol（MCP） 服务、Python 库和 kino CLI，为 AI Agent 提供带护栏的本地视频编辑能力。它封装了 FFmpeg（以及可选的 Hyperframes / Whisper 扩展），提供类型化工具、预检校验、视频回执溯源，以及质量和发布检查点，让 Agent 制作的媒体在发布前可以接受检查。

别名	kino（CLI）；以前称为 mcp-video / mcp_video
最新发布版本	PyPI 官方版本 · GitHub 发布版本
产品网站	kinocut.dev
PyPI	kinocut
MCP Registry	tech.kyanitelabs/kinocut
源代码	GitHub（规范源） · Forgejo（下游镜像）
许可证	Apache-2.0
运行环境	您的设备（macOS、Linux、Windows）——需要在 PATH 中找到 FFmpeg
不是什么	托管云端编辑器、按额度计费的 SaaS，或无类型的 FFmpeg shell 封装

最适合的搜索词： 视频编辑 MCP 服务 · AI Agent 视频编辑 · FFmpeg MCP · Claude Code 视频工具 · Cursor MCP 视频 · Shorts/Reels 自动化 · 本地 AI 视频工作流 · 带护栏的 Agent 媒体处理。

供 Agent 和爬虫读取的机器可读简介：llms.txt · 扩展版 Agent 指南 · 网站：kinocut.dev/llms.txt。

制作流程栈

Kinocut 是一套制作流程栈：检查源素材、选择类型化操作、在本地渲染、获取简洁的溯源回执、运行质量检查，并请求人工批准发布。默认的 MCP 接口让整个流程保持精简；需要时可通过 search_tools 和配置文件扩展功能。

免看屏幕设计原则

每个流程都必须能用文字描述、报告和审批。回执保持为一屏可读的文本卡片，包含产物路径、阶段状态、警告和下一道关卡。错误信息末尾会给出精确的 MCP 和 CLI 重试调用；无需依赖仅通过视觉呈现的交互方式。

查看实际效果

用自然语言告诉 Agent 您想要什么：

“把这段访谈剪成最精彩的 45 秒，加上烧录字幕，改成竖屏，并在导出前进行质量检查。”

Kinocut 会将其转化为带类型和护栏的工具调用——无需猜测 FFmpeg 参数，也不会导出看似成功、实则损坏的视频：

from kinocut import Client
video = Client()

clip = video.trim("interview.mp4", start="00:02:15", duration="00:00:45")
video.ai_transcribe(clip.output_path, output_srt="captions.srt")
captioned = video.subtitles(clip.output_path, subtitle_file="captions.srt")
short = video.resize(captioned.output_path, aspect_ratio="9:16")
video.release_checkpoint(short.output_path)  # thumbnail + quality gate before you publish

主要用途： 将本地访谈或播客制作成带字幕的竖屏片段，并附上视频回执，供 Agent 重复运行并由人工审批。

用户常用的三种方式

• 内容改编——将一段录制内容制作成带字幕的 Shorts、Reels 和 TikTok 套件，并附上清单和审核材料。
• 播客和访谈剪辑——找出最精彩的片段、标准化音频、添加章节并导出。
• CI 中由 Agent 驱动的媒体处理——通过 Claude Code、Cursor、Codex 风格的客户端或脚本执行可重复、可审核的剪辑。

路径： 安装方式对照表 · 标准流程 · 提示词 · 教程 · 对比 · 何时推荐

状态与发布

界面	版本 / 提示	含义
PyPI / npm 检查点	1.16.5（2026-10-27）	最后记录的发布检查点；请查看软件包注册表以获取最新版本。使用 pip install kinocut 安装。
GitHub 最新发布 / MCP Registry	1.16.5	GitHub 发布版 v1.16.5 和官方 MCP Registry（tech.kyanitelabs/kinocut，本地 uvx kinocut stdio 软件包）报告的版本均为 1.16.5（已于 2026-10-27 验证）。最终所有者验收和集群部署仍需单独完成。
此源代码版本	已发布 1.16.5 · 默认 20 个 MCP 工具 / 完整版 205 个 / CLI 177 个	体验优化：精选的默认 20 工具 MCP 列表（KINOCUT_TOOLS=all 可恢复完整的 205 工具目录）、支持重试的错误、一次调用即可生成短视频、延迟启动。遥测、网络和覆盖默认设置保持不变。已发布的 mcp-video==1.6.20 固定使用此运行时；验证记录在 docs/public_claims.json 中。
下一次公开发布	待定	人工处理事项（目录、发布公告）仍受发布门控；后续版本升级需要新的批准。

从 PyPI 安装稳定版软件包，其中包含可选的 object-matte 扩展。若要获取超出已发布软件包范围的本地开发变更，请克隆 master；已发布的 object-matte 工作流请参阅 docs/PRODUCT_MATTE.md。

1.16.5 版本内容

发布于 2026-10-27：精选的默认 20 工具 MCP 注册列表，设置 KINOCUT_TOOLS=all 可恢复完整的 205 个 MCP 工具 / 177 个 CLI 命令；支持重试、无需查看即可读取的错误负载、一次调用的 video_shorts 流程、只读的 video_doctor 预检，以及延迟启动。选择启用的精确探测报告解码帧数和原始有理数帧率。mcp-video==1.6.20 会安装 kinocut==1.16.5。Apache-2.0 §4(a)：许可证文本现已随 npm tarball 和 mcp-video 兼容软件包一同提供。请参阅已发布版本。

1.16.4 版本内容

发布于 2026-10-24：203 个 MCP 工具 / 177 个 CLI 命令；mcp-video==1.6.19 会安装 kinocut==1.16.4。Kinocut 模型调用现在默认关闭，且为可选功能。请使用本地帧和宿主选择的图像模型；独立的旧版适配器需要明确授权，且不会继承 Hermes 路由。本地产品配置无法激活独立的 Anthropic QC Worker。

Revideo 和 Hyperframes 遥测默认关闭。遥测关闭时，Hyperframes 预览要求使用经过验证的 CLI 0.8.104 或 0.8.140；其他预览版本和 Docker 渲染则需要操作员明确同意。这些控制措施并非网络沙箱。现有的覆盖和受保护路径安全措施仍然有效。请参阅视觉与网络政策和已发布版本。

1.16.3 版本内容

发布于 2026-10-23：203 个 MCP 工具 / 177 个 CLI 命令；mcp-video==1.6.18 会安装 kinocut==1.16.3。覆盖现有输出需要显式设置布尔值 overwrite=true（CLI 使用 --overwrite）。现有的非媒体制品还必须由同一持久化作业所有，且 Agent 配置目录仍受保护。没有所有权证据的旧版回执会按安全失败处理。

项目创建会检查已完成的目标位置和符号链接重定向。Python 3.14 MCP 请求上下文仍然可用。该插件会说明可选网络路径，在其固定版本的服务环境中配置可选扩展，并展示 Hermes 工具筛选方式。每个输出请仅使用一个写入器。请参阅已发布版本。

1.16.2 版本内容

发布于 2026-10-21：203 个 MCP 工具 / 177 个 CLI 命令；mcp-video==1.6.17 安装 kinocut==1.16.2。create-from-images 现在可精确到帧，支持 30000/1001 这类有理数帧率，以及 --list / list_file 输入，并在所有入口处强制执行帧率和图像数量限制。官方 MCP Registry 条目已重新发布为本地 uvx kinocut stdio 软件包。感谢 @Beritwu 贡献 #616。请参阅已发布版本。

1.16.1 版本内容

1.16.1 版本修复了 macOS 渲染清理和 faststart 发布、C2PA 与模型缓存暂存、FFmpeg 8.1 滤镜发现，以及着色器/升频重建中的音频保留问题。该版本保留 203 个 MCP 工具 / 177 个 CLI 命令，并与 mcp-video==1.6.16 搭配使用。请参阅维护版本说明，了解验证结果及尚存的平台/模型验收限制。

1.16.0 版本内容

发布于 2026-10-02：203 个 MCP 工具 / 177 个 CLI 命令；mcp-video==1.6.15 安装 kinocut==1.16.0。操作员对等性、有界的质量/资源控制以及规范所有权修复详见版本说明。线上网站显示 1.16.0（已于 2026-10-05 验证）。共享移动端/网页处理、集群部署、MCPB Desktop 验收以及最终的跨界面所有者验收仍是独立的关卡。

1.15.2 版本内容

Kinocut 1.15.2 发布了已验证的声音功能线和经过对抗性加固的引擎。声音母带处理现在通过经测量的母带处理链保留立体声，并采用真实的字幕语音距离配置；sound-qa-asr 在没有真实识别请求时会安全拒绝执行。四项受保护的本地 Revideo 操作加入公开界面，并提供渲染格式验证；release-checkpoint 可从 CLI 通过 MCP 发布关卡。对抗性审计带来的加固包括：MCP 握手会报告真实的 kinocut 版本；中央防护机制会拒绝与某项操作输入别名相同的输出；超大的错误回显会被截断。公开界面扩展至 201 个 MCP 工具 / 173 个 CLI 命令——mcp-video==1.6.13 兼容层会安装 kinocut==1.15.2。

1.15.1 版本内容

Kinocut 1.15.1 是基于 1.15.0 的维护版本：mcp-video 兼容层 1.6.12 携带 Registry 所有权标记；旧版 io.github.KyaniteLabs/mcp-video Registry 条目已重新发布，使目录列表（Glama、PulseMCP）指向有效的元数据（#469）；对象蒙版引擎现在采用流式解码，并限制临时目录大小，在大型输入下可控制内存用量（#414）。公开界面保持 196 个 MCP 工具 / 167 个 CLI 命令——没有新增公开工具名称。

1.15.0 版本内容

Kinocut 1.15.0（2026-08-19）是 Windows／诊断版本：在 1.14.x 的基础上（相同的 360 双摄组装能力和性能表现），正式支持 Windows，并提供真实可靠的诊断；此版本由社区提交的错误报告推动。功能表面仍为 196 MCP / 167 CLI——没有新增公开工具名称。

• 如实报告 MCP 启动失败 — 只有在确实缺少 mcp 时，kino --mcp 才会保留“requires the 'mcp' package”提示；其他所有服务树导入失败现在都会打印实际原因（隐藏文件系统路径，并确保标记语言安全），然后以非零状态码退出。问题报告见 #445。
• doctor 验证 MCP 服务导入 — 新增必需的 mcp-server-import 检查，用于导入 --mcp 使用的同一服务树，因此 kino doctor 不会再在 MCP 模式故障时仍报告 OK。
• 正式支持 Windows — 可移植的 projectstore 文件锁定（#446，已合并并注明贡献者）使 kino --mcp 可在 Windows 上导入；锁定错误遵循仅在争用时报告的约定；kino --help 不再因旧版 cp1252 控制台而崩溃；此外，新增 windows-latest CI 冒烟测试任务（lint、导入检查、kino doctor、公开功能表测试），在每次变更时保障该平台。
• 360 双摄组装 — 任意拼接后的等距柱状 MP4（Insta360、Ricoh Theta、GoPro MAX、DJI Osmo 360 等）→ 可供审核的 360_assembly_plan（desk / table / front_back、split / switch / PiP / single）→ 批准 → FFmpeg v360 渲染。MCP：video_intent 的 goal= + video_review_decide。Python：Client.propose_360_assembly / decide_360_assembly / render_360_assembly。不接受原始 .insv / .360。Director 可插拔（优先本地；可选择启用云端）。不宣称使用了优化 AI。指南：docs/360_ASSEMBLY.md。
• 加速 360 和导入路径 — 单次处理 split/PiP/switch filter_complex（保留源音频）；对采样片段进行质量门控分析；SHA-256 路径／修改时间缓存；提供 infos= 时，合并可跳过重新探测；批量生成 360 分镜静帧；延迟加载 mcp_video / CLI / Client.search_tools；除非 Hyperframes 已在 PATH 中，否则 doctor 会跳过 npx --yes。
• 延迟加载公开导入 — import kinocut 不再急切加载 Client／引擎（PEP 562）。from kinocut import Client 和 kinocut.Client is mcp_video.Client 仍然成立。
• 如实处理交付边界 — CLI／Client 的 repurpose 默认 --min-score 为 80；shorts-package 默认失败即关闭，除非指定 --allow-fail；候选持久化 MCP 工具 video_repurpose 会在任务成功前应用 min_score。
• 兼容窗口 — mcp-video==1.6.11 会安装 kinocut==1.15.0。在 1.14.x 及更高版本系列中，继续支持 mcp_video 导入、MCP_VIDEO_* 环境变量、~/.mcp-video 数据、mcp-video:// 资源和旧版回执键。此前的版本组合为 mcp-video==1.6.10 → kinocut==1.14.1。

以下功能也已在 1.13.x 起的已发布版本中提供：

• 意图动词功能表 — video_intent / intent（约 10 个动词），可试运行计划，避免静默更改媒体
• 观看守护底线 — video_review_run / video_review_decide（blackdetect/LUFS + 检查前 15 秒）
• B-roll 提案、优先支持 ES 的字幕翻译、静帧／底片编辑器、cutfile-render、metric-qc
• Agent 工作流引擎、专用视频修复、分层合成、Hyperframes、Shorts/Reels 再利用
• 1.15.0 版本发布时的数量 — 196 个 MCP 工具和 167 个 CLI 命令

完整说明：CHANGELOG.md · 已在 PyPI 发布的 1.16.5 版本

已发布版本的质量和纯文件音频约定记录在 质量证据、音频混音和 projectstore 生命周期中。有关已发布软件包之外未来的本地变更，请参阅未发布。

1.16.5 之后（草稿 / 受限）

已发布的兼容性安装程序 mcp-video==1.6.20 固定使用 kinocut==1.16.5。舰队升级和运行进程验证说明见 docs/FLEET_UPGRADE.md。

2026-10-27 发布检查点为 1.16.5。在验证发布之前，草稿 / 受限工作不会纳入发布声明。实时目录提交和发布帖子仍属于运营人员 / 人工后续事项（docs/HUMAN_GATES.md），不会声称已完成。

分阶段和受限功能

核心 FFmpeg 编辑、360 拼接、工作流引擎、静帧 / 底板编辑、AI 视频审查 / 挽救及轻量音频拼接已集成到已发布的 1.16.x 版本线，而以下功能仍受限、不完整或尚未发布：

• 桌面 MCPB 打包： 未签名的暂存软件包（mcpb/）标记为用户配置的本地访问。它需要本地 Node/Python/Kinocut/FFmpeg，不是沙箱，且与未来的原生运行时工作不同。请参阅 docs/MCPB.md。
• Sonic World 音频（kinocut_sound）： 已发布的公开接口仍是轻量 S12 拼接；S13 软件包和宿主拼接则作为更深层的内部实现存在。历史上的 7 月 S14 回执记录了两种合成硬件类别，而之后 8 月的重跑记录了 Apple Silicon，并明确标注 x86 仍存在 external_host_unavailable 问题。64 个时长为 0.15 秒的片段只能证明有限的管线连通性，并不能证明完整剧集已完成，也不代表经过人工试听批准。
• 可信执行内核： 受保护时间线的可信执行内核属于项目后续阶段 / 受限功能；若缺少指定的上游契约和人工把关，就不会执行（docs/plans/2026-07-09-kinocut-trusted-execution-layer.md）。
• 生成式计划和本地字幕语音： 生成费用上限和旧版 TTS 候选记录仍是不可执行的计划。已安装的 eSpeak NG 引擎可以通过带哈希的 sound_voice_batch 请求，生成真实的 EN/ES 库存字幕语音，并保留音频用于混音。字幕语音 不会翻译文本，也不保证神经网络语音质量。目前不存在生成适配器；仅有凭据或发现适配器，并不能证明已执行。
• 产品 / 物体遮罩： 使用现有 hyperframes-remove-background 命令处理目录和商店商品抠图（--model birefnet-general，可选额外依赖 kinocut[object-matte]）。默认仍处理人物。这不是新的 MCP/CLI 名称。在已发布的 1.16.5 中可用，首次随 1.15.1 发布（流式解码 + 临时空间上限，#414）；ONNX 额外依赖通过 kinocut[object-matte] 安装。指南：docs/PRODUCT_MATTE.md。

产品检查清单：ROADMAP.md。

Agent 工作流引擎

Agent 可以通过单个 JSON 作业规范，规划、验证、渲染、恢复并证明多步骤本地视频任务——可通过 MCP（video_workflow_*）、CLI（workflow-*）或 Python 客户端（Client.workflow_*）操作——并生成足够可靠的回执，让其他 Agent 或 人工人员在渲染前后都能信任。操作集是一个精简的允许列表 （probe | trim | resize | convert | crop | merge | add_text | composite_layers | burn_in），与各个工具使用的经过审核的引擎函数一一映射；媒体引用采用符号形式并限定在工作区内； 所有操作均采用失败关闭策略。

{
  "schema_version": 1,
  "name": "captioned-vertical-short",
  "sources": { "hero": { "path": "input/hero.mp4" } },
  "steps": [
    { "id": "trim-hero", "op": "trim", "inputs": { "src": "@sources.hero" },
      "params": { "start": 0, "duration": 6 }, "output": "@work/hero_trim.mp4" },
    { "id": "vertical", "op": "resize", "inputs": { "src": "@work/hero_trim.mp4" },
      "params": { "width": 1080, "height": 1920 }, "output": "@work/hero_vertical.mp4" },
    { "id": "caption", "op": "add_text", "inputs": { "src": "@work/hero_vertical.mp4" },
      "params": { "text": "Watch this", "position": "bottom-center" }, "output": "@outputs.master" }
  ],
  "outputs": { "master": { "path": "output/final.mp4" } }
}

kino workflow-validate --spec job.json    # cheap structural gate, no render
kino workflow-plan     --spec job.json --save-plan plan.json     # dry-run op graph + hashes
kino workflow-render   --spec job.json --save-receipt receipt.json   # execute + provenance receipt
kino workflow-inspect  --receipt receipt.json    # read-only integrity re-check

渲染回执会记录每个步骤的输入 / 输出哈希、恢复游标和清理清单，所有路径均相对于工作区：

{
  "receipt_kind": "workflow",
  "versions": { "mcp_video": "1.13.2", "ffmpeg": "8.1" },
  "spec_hash": "sha256:be2f3a9b...",
  "steps": [
    { "id": "trim-hero", "op": "trim", "status": "completed",
      "input_hashes": { "src": "sha256:3b976d49..." },
      "output": "work/be2f3a9b-2effedb3/mcp_video_hero_trim.mp4", "output_hash": "sha256:00727499..." },
    { "id": "caption", "op": "add_text", "status": "completed",
      "output": "output/final.mp4", "output_hash": "sha256:8633ad2a..." }
  ],
  "cleanup_manifest": { "cleaned": true, "policy": "clean-on-success" },
  "resume_cursor": { "last_completed_step": "caption", "next_step": null },
  "status": "completed",
  "render_determinism_scope": "spec/input/output hashes are deterministic; rendered bytes may vary across FFmpeg builds"
}

--all-variants 会根据一项声明生成 N 个不同的输出；--resume 会在保留中间文件的情况下继续失败的作业（如果规范发生更改，则采用失败关闭策略）。完整的架构、@ref 语法、变体、恢复和清理说明见 docs/WORKFLOWS.md；可运行的规范见 examples/workflows/。

受治理的 AI 视频审查

在 Kinocut 中，为必须保持可追溯、可审查的 Agent 编辑媒体提供了一条契约优先的路径：

1. 导入源素材到私有的内容寻址项目（video_ingest / video-ingest）
2. 对存储的素材进行预检 + 时间轴检查（video_preflight、video_inspect_temporal）
3. 使用精确的人类证据进行判定 + 验收（video_verdict、video_acceptance_eval）
4. 仅允许有界衍生内容——保留音频的主体替换或允许列表中的修复方案（video_body_swap、video_salvage），每项都带有谱系信息和一个新的、非已批准的审查槽位

没有强制绕过标志。分析器输出本身不能作为批准依据。过期、别名或受保护的输入会安全失败。操作指南：docs/AI_VIDEO_REVIEW_AND_SALVAGE.md。这些功能已全面集成到已发布的 1.15.x 系列中——请参阅状态与发布。

专用视频修复

对于“修复这个片段”这类必须保持故事和时间线不变的请求，请使用审查优先的修复流程。规划并检查诊断结果，仅批准安全的修复 ID，然后渲染并检查经过验证的包。源素材保持不可变；母版和通用分享副本始终会经过验证；可选字幕以侧车文件形式保留。CLI、MCP、Python、取消、恢复和稳定错误的说明见 docs/RESCUE.md。

分层合成

composite-layers / video_composite_layers 为需要超越双镜头叠加基本功能的 Agent 添加了由规格驱动的有序图层堆栈。它支持图像、视频和纯色图层；常规 alpha 合成；逐图层不透明度；x/y 位置；变换缩放；时间窗口；以及蒙版/遮罩 alpha 源——还支持全画布和定位混合模式（multiply、screen、overlay、darken、lighten）以及带有新 pivot 参考点的旋转。试运行计划和确定性的 layer_plan v2 收据会记录源素材、滤镜图和输出的哈希值。

kino composite-layers --spec layers.json --dry-run --save-layer-plan layer-plan.json
kino composite-layers --spec layers.json -o out.mp4 --save-layer-plan layer-plan.json

当 Agent 需要在渲染前审查经过规划的叠加层、遮罩、字幕条、模糊背景底板或平台变体堆栈时，请使用 composite-layers。非 normal 混合模式支持不透明度以及 start / duration 时间窗口，并支持两种几何布局：不显式指定尺寸时在 {0,0} 处使用全画布，或指定一个同时包含正整数 width 和 height 的定位矩形，并使用画布内的非负整数位置。RGB 混合不会对经过子采样的色度平面应用颜色运算。缩放、旋转/轴心点、蒙版/遮罩、小数位置和超出画布的矩形目前仍不支持，遇到时会以 unsupported_blend_geometry 安全失败。视频图层和蒙版会从声明的图层起始时间开始播放。请将源素材和蒙版放在规格文件目录内，并将规格文件放在其媒体文件的共同父目录中。输出仍仅包含视频。

360 双摄合成

任何拼接好的等距柱状 360 MP4（Insta360、Ricoh Theta、GoPro MAX、DJI 等）都可以转换为双摄 16:9 或 9:16 编辑，无需新增工具名称。请先从相机应用导出——Kinocut 不会拼接 .insv 或 GoPro .360。

from kinocut import Client

video = Client()
plan = video.propose_360_assembly("x4-export.mp4", goal="desk 360 split 9:16")
approved = video.decide_360_assembly(plan, "approve")
video.render_360_assembly(approved, "desk-split.mp4")

Agent：使用 360/桌面/桌面场景目标和 source= 调用 video_intent，然后调用 video_review_decide。完整契约见：docs/360_ASSEMBLY.md。

静帧 / 图像编辑

Kinocut 将多静帧包视为一等媒体——规划 → 收据 → 安全失败门控，其安全原则与视频修复相同。需要运行 pip install "kinocut[image]"；运行 kino doctor 验证图像组件。

**工作流：**建立主视觉底板 → 围绕它编辑节拍 → 匹配共享白平衡/曝光 → 调色（可选信号 LUT）→ 一致性门控。

# Image analysis: extract colors, generate palettes, analyze products
kino image-extract-colors product.jpg -n 8
kino image-generate-palette scene.png --harmony triadic
kino image-analyze-product listing.jpg --use-ai

# Still/plate editing: match package to hero, grade, gate
kino still-match --hero establish.png --inputs beat1.png beat2.png --output-dir out/matched
kino still-grade --inputs out/matched/*.png --hero establish.png --output-dir out/graded
kino still-gate  --inputs out/graded/*.png --output-dir out/gate

# Establish-locked edit with plan/receipt (dry-run first)
kino image-edit --source beat.png --reference establish.png \
  --intent "match establish world and light" --output-dir out/edit --dry-run

# Or run the full pipeline in one shot
kino still-package --establish establish.png --beats beat1.png beat2.png --output-dir out/pkg

from kinocut import Client

c = Client()
c.still_match(hero="establish.png", inputs=["a.png", "b.png"], output_dir="out/m")
c.still_gate(inputs=["out/m/a_matched.png", "out/m/b_matched.png"], output_dir="out/g")

still-gate 会针对亮度差异和阴影绿色/青色指标安全失败；每个工具都会写入带有哈希值和增益的 JSON 收据。默认关闭付费生成式后端（prefer=edit、allow_paid_gen=false）。完整指南：docs/STILL_PLATES.md。

公开发现

Kinocut 的构建旨在让搜索引擎和 AI 答案引擎都能发现并引用：

• 产品规范网址：https://kinocut.dev/
• GitHub README + llms.txt，包含实体事实、安装命令和安全规则
• 在 MCP Registry 中的官方记录：tech.kyanitelabs/kinocut
• 本 README 和 docs/faq.md 中的常见问题解答（答案优先，声明带版本信息）

Kinocut 与原始 FFmpeg（以及云端编辑器）的对比

	Kinocut	Agent shell 中的原始 FFmpeg	常见的云端编辑器 API
接口	类型化 MCP / Python / CLI	自由格式标志	托管的 HTTP API
预检	渲染前设置防护措施	Agent 自行编写标志	因供应商而异
来源凭证	Video Receipts + 哈希	临时日志	供应商控制面板
媒体位置	本地优先	本地	需要上传
核心费用	免费（Apache-2.0）	免费	通常按用量计费

为什么要构建它

AI Agent 可以编写 FFmpeg 命令，但不应该需要猜测标志、解析脆弱的 stderr，或在不提示的情况下发布损坏的媒体。Kinocut 为 Agent 提供类型化操作、可检查的工具元数据、结构化结果、预检防护措施和质量检查点，让视频工作流能够自动化并接受审核，而不必像在 shell 命令中碰运气一样。

当你希望 AI 助手完成以下任务时，可以使用它：

• 剪辑、合并、调整大小、裁剪、旋转、转码或导出视频；
• 添加文本、字幕、水印、叠加层、滤镜、淡入淡出、效果和转场；
• 提取音频、标准化音频、合成音频、添加生成的音频或创建波形；
• 检测场景、制作缩略图、生成分镜脚本、比较质量并创建发布检查点；
• 通过锁定基准画面的色彩一致性来匹配、调色并检查静态素材包，或分析产品图像的颜色和调色板；
• 搭建电影感项目框架、读取 STYLE_/NEG_ 块、解析分镜表格并扩展镜头提示词；
• 创建新的 Hyperframes 项目、检查渲染布局、捕获网站、生成本地语音、移除背景，并使用 FFmpeg 工具对结果进行后期处理；
• 将一个源视频改编为竖屏、横屏和方形的本地交付素材包，并附带清单和审核材料；
• 通过 Claude Code、Cursor、Codex 风格的客户端、脚本或 CI 驱动可重复的媒体工作流。

安装

先决条件：FFmpeg 必须已安装，并且可通过 PATH 使用。

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

无需全局安装即可运行：

uvx --from kinocut kino doctor

或者使用 pip 安装：

pip install kinocut
kino doctor

对于 Claude Desktop 风格的 MCPB 安装，Kinocut 在 mcpb/ 中提供了一个暂存的本地包，以及一个本地构建脚本：

python3 scripts/build-mcpb.py

此未签名的用户配置本地访问包会启动现有 Python 环境，并使用确切的 Kinocut 版本；同时仍需要本地 Node、FFmpeg 和 ffprobe。它不是沙盒。原生独立捆绑包仍是未来的独立工作。请参阅 docs/MCPB.md。

最终 MP4 导出可选择使用 C2PA 签名，但需配置 c2patool 和清单/签名器。签名默认关闭，只有在验证读取成功后才会报告 signed。请参阅 docs/C2PA_PROVENANCE.md。

Hyperframes 工具还需要 Node.js 22+ 和可解析的 Hyperframes CLI。在当前 Node 包布局中安装/固定 Hyperframes 版本，将 hyperframes 添加到 PATH，或设置 MCP_VIDEO_HYPERFRAMES_COMMAND。

我需要安装哪个额外功能？

核心安装包含所有 FFmpeg 编辑工具。可选功能通过额外依赖提供——只安装你会用到的功能：

需求	安装命令	额外空间约
语音转文字字幕（Whisper）	pip install "kinocut[transcribe]"	~1 GB（torch）
图像分析（颜色、布局、对比度）	pip install "kinocut[image]"	~50 MB
人声／乐器音轨分离	pip install "kinocut[stems]"	~2 GB（torch + demucs）
AI 超分辨率	pip install "kinocut[upscale]"	~2 GB（Python ≤3.12）
程序化音频／音乐工具	pip install "kinocut[audio]"	~30 MB（numpy）
所有 AI 功能	pip install "kinocut[ai]"	数 GB

可以自由组合，例如 pip install "kinocut[transcribe,image]"。之后运行 kino doctor，它会准确报告哪些功能可用、哪些尚未安装。

从 mcp-video 升级

在更名过渡期间，Kinocut 保留了原有接口。现有安装可以升级，无需更改代码：

pip install --upgrade 'mcp-video==1.6.20'
pip install --force-reinstall --no-deps 'kinocut==1.16.5'
mcp-video doctor

较旧的 shim 安装程序记录可能会在升级时删除共享可执行文件，即使依赖检查通过也不例外。规范的重新安装会恢复其归属；请使用预期的版本固定值，并在锁定部署中保留已配置的额外依赖。请参阅集群迁移说明，了解固定版本的升级顺序。

已发布的 mcp-video==1.6.20 是仅包含元数据、用于兼容性的安装程序，对应 kinocut==1.16.5。mcp_video 导入、mcp-video 命令、MCP_VIDEO_* 环境变量、~/.mcp-video 数据目录、mcp-video:// 资源 URI，以及现有收据键，在 1.14.x+ 系列中仍受支持。新的集成应使用 kinocut、from kinocut import Client 和 kino 命令。

西班牙语

Kinocut 是一款面向 AI Agent 的视频编辑 MCP 服务。最新发布版本为 1.16.5（pip install kinocut，设置 KINOCUT_TOOLS=all 时提供 205 个 MCP 工具；默认 20 个／CLI 177 个）。它包含从已拼接的等距柱状投影 MP4（非 .insv）进行双摄 360 度组装、PEP 562 延迟导入，以及用于剪辑、拼接、添加字幕、混音、添加特效和复用内容（Shorts、Reels、TikTok）的同一套类型化 FFmpeg 接口；还提供工作流（workflow）引擎及可验证收据、视频抢救、受治理的 AI 视频审查，以及渲染前安全检查。遗留的人工作业（目录、启动）尚未完整实现。

要求：安装 FFmpeg，并确保它可在 PATH 中使用。

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Instalación y diagnóstico
pip install kinocut
kino doctor

对于 Claude Code：

claude mcp add kinocut -- uvx --from kinocut kino --mcp

kino doctor 会报告哪些功能可用，以及还缺少哪些安装项。完整文档为英文；主要错误消息提供双语版本。

快速入门

黄金路径（60 秒）

在配置 Agent 宿主之前，先验证安装是否正常：

pip install -e .          # or: pip install kinocut
kino doctor               # required checks must pass
python scripts/golden_path.py

成功标准和故障恢复方法：docs/GOLDEN_PATH.md。
可分享的数据包（收据 + 质量 + 媒体）：python scripts/generate_golden_pack.py → demo/golden-pack/。

先尝试基于收据的验证流程

在本仓库的克隆目录中，先运行最精简的置信度工作流，再配置 Agent 宿主：

uv run --no-project --with kinocut python workflows/05-confidence-baseline/workflow.py
uv run --no-project --with kinocut python workflows/benchmarks/run_confidence_benchmark.py

该工作流会生成一段极短的源视频片段，创建经过检查的竖屏视频，运行质量／发布检查点步骤，并写入 workflows/05-confidence-baseline/output/video_receipt.json。

验证说明位于 docs/proofs/。公开营销声明（版本、工具数量、URL）位于 docs/public_claims.json，并由 CI 进行检查。

Claude Code

claude mcp add kinocut -- uvx --from kinocut kino --mcp

Claude Desktop

{
  "mcpServers": {
    "kinocut": {
      "command": "uvx",
      "args": ["--from", "kinocut", "kino", "--mcp"]
    }
  }
}

Cursor

{
  "mcpServers": {
    "kinocut": {
      "command": "uvx",
      "args": ["--from", "kinocut", "kino", "--mcp"]
    }
  }
}

然后向你的 Agent 提出要求：

将这段访谈剪辑成 45 秒的竖屏短片，添加烧录字幕，标准化音频，制作缩略图，并在导出前创建发布检查点。

Agent 技能

Kinocut 提供公开的 Agent 技能，位于 skills/kinocut/SKILL.md。在兼容的 Agent 宿主中使用 $kinocut，即可让 Agent 在 MCP 服务、CLI 和 Python 客户端之间进行选择，同时保留检查、编辑、验证和人工审核工作流。

如需使用仅限当前工具的基于路径的短视频内容包（不使用虚构命令，不进行外部发布），请参阅 skills/kinocut-repurpose/SKILL.md。该技能是明确的营销起点；由持久内核支持的内容再利用产品仍在可信执行路线图中。

Python 客户端

from kinocut import Client

editor = Client()

clip = editor.trim("interview.mp4", start="00:02:15", duration="00:00:45")
caption_file = "captions.srt"
editor.ai_transcribe(clip.output_path, output_srt=caption_file)
captioned = editor.subtitles(clip.output_path, subtitle_file=caption_file)
vertical = editor.resize(captioned.output_path, aspect_ratio="9:16")
checkpoint = editor.release_checkpoint(vertical.output_path)

print(checkpoint["thumbnail"])
print(checkpoint["storyboard"])

CLI

kino info interview.mp4
kino trim interview.mp4 -s 00:02:15 -d 45
kino video-ai-transcribe clip.mp4 --output captions.srt
kino subtitles clip.mp4 captions.srt
kino resize clip.mp4 --aspect-ratio 9:16
kino video-quality-check clip.mp4
kino repurpose clip.mp4 --platforms youtube-shorts instagram-reel tiktok
kino image-extract-colors product.jpg
kino still-package --establish hero.png --beats shot1.png shot2.png --output-dir out/stills

Agent 可以做什么

工作流	示例提示词
社交媒体短片	“将这段横向录制视频转换为带字幕的 TikTok 和 YouTube Short。”
播客制作	“找出最精彩的片段，对其进行剪辑、音频标准化、添加章节，然后导出。”
产品演示	“用截图、标题卡和旁白制作一段简短的发布视频。”
电影化规划	“创建风格包和分镜脚本，然后生成用于创作的镜头提示词。”
质量审核	“比较这两个导出文件，制作缩略图，并标记视觉或音频问题。”
批量自动化	“将此文件夹中的短片转换为适用于 Web 的 MP4，并统一响度。”
代码创建视频	“搭建 Hyperframes 合成，检查并渲染，然后添加字幕和水印。”
本地内容再利用	“将这段母片转换为 Shorts、Reels、TikTok 和 YouTube 素材，并附上缩略图和清单。”
视频修复	“诊断这段受损视频，只提出安全的修复方案，渲染获批的视频包，并验证回执。”
受治理审核（开发提示）	“将此导出文件导入项目，运行预检和时间检查，撰写结论，并且只修复损坏的片段。”

MCP 工具

1.16.5 版通过 KINOCUT_TOOLS=all 提供 205 个 MCP 工具 / 177 条命令行命令；默认注册的是精简的 20 个 MCP 核心工具。KINOCUT_TOOLS=profile:editor 可选择编辑器配置。KINOCUT_TOOLS=profile:editor 可选择编辑器配置，而 search_tools 可发现隐藏操作，但不会更改所选工具集。下表总结了完整目录中的分类。

分类	数量	亮点
核心视频编辑	32	修剪、合并、调整大小、裁剪、旋转、转换、叠加、字幕、导出、清理、模板、合并兼容性防护
基于项目的检查	3	内容寻址式导入、统一预检、时序证据包
受治理的 AI 视频	4	精确素材判定、验收评估、保留音频的主体替换、绑定溯源的抢救
Agent 工作流引擎	4	验证、规划、渲染、恢复、检查多步骤作业并生成溯源收据
专用修复	3	诊断、批准、渲染、验证、隔离并恢复本地内容保留型修复
修复后规划	8	语义时间线／查询、EDL、视觉变换、修复、合成、自动驾驶、显式导出
电影化创作	4	项目脚手架、风格包解析、分镜解析、镜头提示词扩展
AI 辅助媒体	11	转录、场景检测、升频、音轨分离、静音移除、调色
Hyperframes	18	初始化、预览、渲染、快照、检查、目录、网站捕获、本地 TTS、转录、背景移除、诊断、基准测试、后期处理
Revideo	4	实例化固定版本的桥接程序、安装锁定的依赖项、渲染项目，或运行完整的本地作业并生成经过验证的收据
内容改编	2	试运行清单、适配平台的变体、缩略图、分镜、发布检查点
程序化音频	7	合成、编曲、预设、效果、序列、生成式音频、空间音频、混音参数防护
视觉效果	8	暗角、辉光、噪声、扫描线、色差、亮度键控、遮罩、形状遮罩、有限范围的滤镜参数
转场	3	故障、变形、像素化
布局与动态效果	6	网格、画中画、分屏、动态文字、计数器、进度条、自动章节、布局不匹配警告
分析	8	场景检测、缩略图、预览、分镜、质量对比、元数据、波形、发布检查点
图像分析	3	提取颜色、生成调色板、分析产品图像
静帧／底板编辑	5	静帧匹配、静帧调色、静帧门控、图像编辑、静帧包——建立锁定的色彩匹配并设置一致性门控
发现	1	search_tools

from kinocut import Client

editor = Client()
matches = editor.search_tools("subtitle")
print(matches["tools"])

完整参考：docs/TOOLS.md

一键 Shorts 配方：video_shorts(input_path, segments, style?) 会修剪选定片段，为提供的片段文本添加字幕，应用 9:16 模板，导出一个成品，并返回一条收据链。它绝不会向外部平台发布内容。

面向 Agent 的安全工作流

对于自主 Agent，建议按以下路径操作：检查、编辑、验证，然后请人工审查发布产物：

from kinocut import Client

client = Client()

print(client.inspect("trim"))

result = client.pipeline(
    [
        {"op": "trim", "input": "source.mp4", "start": "00:01:00", "duration": "00:00:45"},
        {"op": "add_text", "text": "Launch clip", "position": "top-center"},
        {"op": "normalize_audio"},
        {"op": "resize", "aspect_ratio": "9:16"},
        {"op": "export", "quality": "high"},
        {"op": "release_checkpoint"},
    ],
    output_path="final-short.mp4",
)

安全约定：

• 生成媒体的调用会返回包含输出路径的结构化结果。
• 高风险编辑路径现在会在执行 FFmpeg 前运行预检防护：滤镜边界、合并兼容性、音频混音音量／时序、叠加层／水印／色度键的不透明度和相似度、动画文本时序／溢出，以及网格／分屏不匹配警告。
• 分析和发现调用会返回结构化 JSON 报告。
• 可通过 search_tools() 和 Client.inspect() 发现工具。
• 意外的关键字错误会转换为提供可操作指导的 MCPVideoError。
• 未经 video_quality_check、video_release_checkpoint 和人工视觉／音频检查，不要发布 Agent 生成的视频。
• 对受治理的 AI 视频衍生作品，必须要求已存储的身份信息、有效的人工决策证据，并且每次挽救或替换主体后都安排新的审核时段；绝不要将原始 FFmpeg 变通方案标记为受治理流程。

更新日志

尚未发布的易用性改进

• 新增默认注册的 20 个 MCP 工具，支持 KINOCUT_TOOLS=all、配置文件选择、隐藏工具发现、video_shorts、video_doctor、便于无视觉操作的重试消息、延迟启动导入，以及 MCP 进度覆盖。现有遥测、网络和覆盖默认设置保持不变。

致谢

• @Beritwu — 在 #599 中贡献精确探测功能。
• @Mimatovitch — 在 #594 中报告 macOS 清理错误。

1.16.5（2026-10-27）：

• 默认精简注册 20 个 MCP 工具；KINOCUT_TOOLS=all 提供完整目录 — 205 个 MCP 工具 / 177 个 CLI 工具。兼容包 mcp-video==1.6.20 会安装 kinocut==1.16.5。支持重试的错误、一次调用生成短视频、video_doctor 预检、延迟启动、可选的精确探测；所有发行包均附带 Apache-2.0 许可证文本。

1.16.4（2026-10-24）：

• 可选模型调用默认关闭；明确授予本地和远程权限，避免本地产品分析触发云端 QC。
• Revideo 和 Hyperframes 遥测默认关闭，并提供受保护的 Hyperframes 预览和 Docker 渲染。
• 提供与服务提供商无关的宿主图像工作流和准确的网络披露；203 个 MCP 工具 / 177 个 CLI 工具。兼容包 mcp-video==1.6.19 会安装 kinocut==1.16.4。

1.16.3（2026-10-23）：

• 明确取得覆盖许可，为非媒体产物采用同一任务所有权，保护 Agent 主目录，并锚定发布位置。
• 完成项目路径检查、Python 3.14 MCP 上下文、准确的插件网络文档，以及可选的 Hermes 工具筛选。
• 工具集规模仍为 203 个 MCP 工具 / 177 个 CLI 工具；mcp-video==1.6.18 会安装 kinocut==1.16.3。

1.16.2（2026-10-21）：

• create-from-images 支持精确到帧，并支持有理数帧率（30000/1001）以及 --list / list_file 输入；Python、CLI 和 MCP 均设有帧率和图像数量边界（感谢 @Beritwu，#616）。
• 官方 MCP Registry 条目已重新发布为本地 uvx kinocut stdio 包。
• 工具集规模仍为 203 个 MCP 工具 / 177 个 CLI 工具；mcp-video==1.6.17 会安装 kinocut==1.6.2。

1.16.1（2026-10-05）：

• 维护性修复：macOS 渲染清理（实时进程监控器，兼容僵尸进程的静默处理）以及保留描述符锚定输出的 MOV/MP4 faststart。
• C2PA 签名以及 object-matte/FSRCNN 模型下载，现在仅在验证后通过专属暂存文件发布。
• FFmpeg 8.1 滤镜发现；在 GPU 着色器和 Real-ESRGAN 重建中保留源音频；为着色器／放大探测失败提供类型化错误。
• 工具集规模仍为 203 个 MCP 工具 / 177 个 CLI 工具；mcp-video==1.6.16 会安装 kinocut==1.16.1。

1.16.0（2026-10-02）：

• MCP/CLI/Python 的操作路由保持一致（音频混音、ducking/HLS、运动回执、360 意图/审核控件、操作估算）；持久化 MCP 改编质量/检查点策略。
• 加固有界输入（CLI 计划/审核 JSON 大小和嵌套层级上限、显式 JSON 布尔值、拒绝重复键）。
• 新增 Client.record_motion_acceptance、时间维度的 motion_coherence 证据、可选的 Anthropic 关键帧审核、结构化 FFmpeg 依赖项提示，以及 Gemini CLI 设置示例。
• 工具面扩大至 203 MCP / 177 CLI；安装 mcp-video==1.6.15 会同时安装 kinocut==1.16.0。

1.15.3（2026-09-25）：

• 发布版本：已于 2026-09-30 验证 PyPI 和 npm；安装 mcp-video==1.6.14 会同时安装 kinocut==1.15.3。工具面保持 201 MCP / 173 CLI。

1.15.2（2026-09-24）：

• 通过实测母带处理链验证立体声音频母带处理（#523/#525/#526）；对真实字幕语音使用距离配置文件进行处理；没有真实识别请求时，sound-qa-asr 会安全失败（#432）。
• 通过渲染格式验证，在公开工具面上开放受防护的本地 Revideo 操作（#508）；release-checkpoint 可从 CLI 通过 MCP 发布门禁。
• 对抗性加固：MCP 握手报告真实的 kinocut 版本（F1），中央自覆盖防护会拒绝与输入别名相同的输出（F2），错误回显会截断超大值（F4）。
• 保留绝对修剪结束位置语义（#493）；Windows 驱动器路径保留前缀（#496）；空白/空的 ASS 字幕轨会安全失败，而不是渲染空输出。
• 工具面扩大至 201 MCP / 173 CLI；安装 mcp-video==1.6.13 会同时安装 kinocut==1.15.2。

1.15.1（2026-08-31）：

• 注册表所有权：mcp-video shim 1.6.12 + 旧版注册表重新发布（#469）。
• 对象蒙版流式解码，并设有临时空间上限（#414）。
• 安装 mcp-video==1.6.12 会同时安装 kinocut==1.15.1。

1.15.0（2026-08-19）：

• 如实报告 MCP 启动失败——kino --mcp 会报告真实的导入原因；路径已隐藏，并确保标记语言安全（#448，来自 #445）。
• doctor mcp-server-import 检查——必需的核心检查；--mcp 故障时，doctor 不会报告 OK（#449）。
• 一等 Windows 支持——可移植的 projectstore 文件锁定（#446）、仅针对争用的锁定约定、UTF-8 标准输入/输出、windows-latest 冒烟测试任务。
• 社区驱动的发布——在贡献指南和 CHANGELOG 致谢名单中致谢 @gerardoscaglia-creator。
• 安装 mcp-video==1.6.11 会同时安装 kinocut==1.15.0。

1.14.1（2026-08-13）：

• 基于 1.14.0 的补丁：在救援取消处添加 pyright NoReturn，使 GitHub Lint 保持通过。360 和性能工具面不变。
• 安装 mcp-video==1.6.10 会同时安装 kinocut==1.14.1。

1.14.0（2026-08-13）：

• 发布360 双摄组装功能，可处理拼接后的 equirect MP4（与相机无关，不仅限于 X4），通过 video_intent / Client.propose_360_assembly 提供——仍为 196 MCP / 167 CLI。
• 落地性能委员会排名前 10 的优化：单次处理的 360 filter_complex（保留音频）、采样式 QC、延迟导入、SHA 缓存、批量生成故事板静帧。
• 安装 mcp-video==1.6.9 会同时安装 kinocut==1.14.0。

1.13.0（2026-08-07）：

• 新增意图动词工具面（video_intent / intent）、Watching 防护下限（video_review_run / video_review_decide）、B-roll 提案（video_propose_broll）、字幕翻译，优先支持 ES（video_translate_captions），以及**可信执行（TE）**易用性改进。
• 将已发布的工具面扩展至 196 个 MCP 工具和 167 个 CLI 命令（标准、测试和客户端接口完全同步）。
• 加固字幕翻译、品牌套件和 OTIO 导出的路径验证。

1.12.0（2026-08-07）：

• 新增静帧/底片编辑工具面（still-match、still-grade、still-gate、image-edit、still-package），并启用失败关闭式一致性门控。 1.11.x（2026-07-24）：
• 新增轻量型 kinocut_sound S12 公共接入适配器（sound-capabilities、sound-plan-validate、sound-mix-render 等）。
• 主题完成后加强安全性，防止泄露主机绝对路径，并确保所有发现的操作都有失败时默认拒绝的调用路径。

完整的历史版本说明请参阅 CHANGELOG.md，或查看 GitHub Releases 页面。

常见问题

Kinocut 是什么？

Kinocut 是一款免费的开源 MCP 服务、Python 库和 kino CLI，用于 AI Agent 视频编辑。它以带有预检防护、视频凭证和质量检查点的方式封装 FFmpeg（以及可选的 Hyperframes/Whisper 扩展）。它以前名为 mcp-video。

如何安装？

brew install ffmpeg   # or apt install ffmpeg
pip install kinocut
kino doctor
claude mcp add kinocut -- uvx --from kinocut kino --mcp

它免费且以本地运行为先吗？

是。它采用 Apache-2.0 许可，可在你的机器上运行，使用核心功能不需要 Kinocut 账户或 API 密钥，媒体也不会上传到 Kinocut 云端。

本地计算和存储仍会产生费用。可选提供商和宿主 Agent 可能会单独收费，提示词或工具结果也可能发送给宿主的大模型提供商。仅在本地执行并不能保证数据不会外传。

哪些 Agent 可以使用它？

任何可以运行本地 stdio 服务的 MCP 兼容客户端（Claude Code、Cursor、Windsurf、Cline 等）。你也可以在没有 Agent 的情况下使用 Python 客户端或 CLI。

有多少个工具？

已发布的 1.16.5 提供 205 个 MCP 工具 / 177 个 CLI 命令（使用 KINOCUT_TOOLS=all 时，kino --mcp 的 tools/list）；默认注册的是精选的 20 个核心工具。如需准确参数，请查询已安装服务的工具架构。search_tools 可发现隐藏操作。

Kinocut 可以编辑 Insta360 X4 的 360 视频吗？

可以，但素材必须是已拼接的 360 MP4，不能是 .insv。提出 360_assembly_plan，批准后即可渲染分屏、切换、画中画或单画面。其他已拼接的等距柱状全景摄像机素材也适用。请参阅 docs/360_ASSEMBLY.md。

它以前叫 mcp-video 吗？

是。当前发布的 mcp-video==1.6.20 会安装 kinocut==1.16.5；之前的 mcp-video==1.6.19 会安装 kinocut==1.16.4；历史版本 mcp-video==1.6.11 会安装 kinocut==1.15.0。在 1.14.x 及更高版本系列中，仍支持兼容性导入、CLI 名称、环境变量、数据目录、资源 URI 和凭证键。

Kinocut 可以把 Insta360 X4 文件转换成双摄剪辑吗？

可以：导出已拼接的 360 MP4，然后依次提出方案 → 批准 → 渲染。.insv 会被拒绝。此功能在 1.14.1 中发布，并在已发布的 1.16.5 中继续提供。

Kinocut 有何不同？

与原始 FFmpeg 脚本或未设防的 Agent Shell 不同，Kinocut 会验证工具并生成凭证。

Kinocut 是生产级软件吗？

请以 README 状态和发布标签作为成熟度的准确信息来源。在用于生产环境之前，请根据你自己的要求进行验证。

更多解答：docs/faq.md · 网站常见问题：kinocut.dev/#faq

文档

• 文档地图
• 产品网站
• 工具参考
• Python 客户端参考
• CLI 参考
• Agent 工作流引擎
• 视频回执
• 视频恢复
• 360 双摄组装
• 恢复后规划
• AI 视频审核与挽救
• AI 视频合约
• AI 视频检查
• C2PA 来源信息
• MCPB 打包
• 产品路线图
• 可信执行层计划
• 愿望清单 / 1.8 计划并行方案
• 声音计划状态
• AI Agent 发现指南
• 常见问题
• 黄金路径（首次运行验证）
• 公开声明（版本 / 数量）
• 黄金演示包
• 更新日志
• llms.txt

测试

开发验证说明见 docs/TESTING.md。更改工具行为时，请及时更新公共接口、媒体工作流和安全检查。

开发

git clone https://github.com/KyaniteLabs/kinocut.git
cd kinocut
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest tests/ -v -m "not slow and not hyperframes"

社区

• 贡献指南
• 行为准则
• 治理
• 维护者
• 安全
• 支持
• 路线图
• 更新日志
• GitHub 问题

社区部署

希望获得公开 MCP URL、又不想开放家庭路由器端口的运营者，可以参考这个社区 Apache-2.0 方案：通过 Tailscale Funnel、Caddy 和 Google OAuth（mcp-auth-proxy）将 Kinocut + Hyperframes 部署在后方： hyperframes-selfhost （与 KyaniteLabs 无关联；请根据你的威胁模型评估安全性）。

许可证

Apache 2.0。详见 LICENSE。

使用 FFmpeg、Hyperframes 和 Model Context Protocol 构建。

---

KyaniteLabs 旗下项目

了解更多 KyaniteLabs 项目。相关项目：

• Epoch — 面向 AI Agent 的时间估算 MCP 服务（PERT）
• DialectOS — 西班牙语方言本地化 MCP 服务和 CLI
• checkyourself — 面向 AI 生成代码的本地优先生产就绪性检查

→ 更多信息请访问 kyanitelabs.tech

---

如果 Kinocut 对你有帮助，欢迎在 GitHub 上**点星或关注**——这有助于其他 Agent 构建者发现它。 如果它为你节省了实际的剪辑时间：ko-fi.com/kyanitelabs。

由 Simon Gonzalez De Cruz 构建——可通过上方公开个人资料链接联系，承接前沿部署 / 应用 AI 工程和合同项目。

适用人群

• 主要面向：AI Agent 构建者、Claude Code/Cursor 用户和本地媒体运营者
• 适用于：需要使用类型化 FFmpeg 工具编辑、添加字幕、改编和进行质量把关的视频工作
• 不适用于：需要托管云端编辑器或无类型 FFmpeg shell 的场景

状态

• 截至 2026 年，默认分支仍在维护
• 固定依赖版本时，优先使用发布标签
• 请在规范的 GitHub 仓库报告问题

Agent 界面

• 编码 Agent：请先阅读本 README，然后阅读仓库文档中的 AGENTS.md（如果存在）
• 如果仓库提供了机器可读的简介（llms.txt），优先阅读
• 如果适用，MCP 或技能入口点会在仓库内的文档中说明

贡献

欢迎在 GitHub 提交问题和 PR。请勿在公开文档中包含机密信息和仅限本机使用的路径。

贡献者

Kinocut 在公开环境中持续改进，外部贡献也在塑造它——1.15.0 的诊断修复直接源自一份出色的错误报告。提供复现步骤和真实回溯的报告也是贡献，我们会在 CHANGELOG 致谢名单和发布说明中署名致谢贡献者。

• @gerardoscaglia-creator — 他对 Windows MCP 模式的调查（#445）揭示了 1.15.0 修复的两个诊断缺陷；他提交的便携式文件锁定修复（#446）也已合入 1.15.0，并注明了贡献者。感谢。
• @pedropaav-art — 修复 Windows 筛选器选项的路径转义问题（#458），于 2026-08-18 合入，并随 1.15.0 发布。
• @linhaixin45-cmyk — 为 kino doctor 设置 Python 版本下限并提供醒目的安装提示（#459），于 2026-08-18 合入，并随 1.15.0 发布。
• @WohaibHasan — 绝对修剪结束位置处理（#493）、保留 Windows 驱动器（#496），以及便携式 UTF-8 CLI 测试捕获（#498）。
• @betsmayank — 首个合入的外部修复：Hyperframes init 在没有 TTY 的 MCP 环境下不再卡住（#361）。
• @austinwmson 和 @ismailkattakath — 提出了弥补实际缺陷的外部报告：remotion_still 运行时属性（#306），以及可自托管的 Funnel + OAuth 参考技术栈（#432）。
• @Dodothereal 和 @OyaAIProd（账号已不存在）——早期外部 PR（用于竖屏烧录的 ASS PlayRes #378、SafeSkill 徽章）。

跨平台架构和当前支持依据：平台兼容性。本次发布尚未实现 Web／移动端共享处理和原生客户端。