mcpField
K
kinetograph-studio

kinetograph-studio

github.com/0xs4n4tg创意与媒体51615 次安装今天更新
代码仓库

关于 kinetograph-studio

用于操作 Kinetograph Studio 的技能；Studio 是面向动画项目的本地浏览器工作区，集成预览、时间线、属性、标注、导出和编码 Agent 对话。Studio 开启时，可通过 MCP 工具调整预览属性并用面板征求决策。

主要功能

  1. 01通过可拖动时间线预览项目
  2. 02编辑基于 schema 的属性并保存预设
  3. 03为帧添加标记和评论
  4. 04将选定范围的导出加入队列
  5. 05通过 MCP 工具打开决策面板

适用场景

  1. 01查看效果时调整合成属性
  2. 02收集针对特定帧的视觉反馈
  3. 03按简报、分镜和评审流程推进视频制作
  4. 04导出指定动画范围

MCP 相关

Studio 开启时，MCP 工具可读取或更改预览属性，并打开面板征求人类决策。Studio 对话 Agent 也可使用 Kinetograph 命令和项目插件工具。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/0xs4n4tg/kinetograph --skill kinetograph-studio

安装后在 Claude Code 中输入/kinetograph-studio确认已加载。

附带文件references/panels.md

详细介绍

在 Studio 中工作

npx kinetograph studio <entry> 会启动本地 Studio（一个可播放声音的预览、可拖动时间范围的时间轴、属性和预设、插件卡片、场景树、导出对话框、渲染队列，以及与用户的编码 Agent 聊天的界面），地址为 http://127.0.0.1:3000，并打开浏览器。入口可以是项目文件、.json 场景或 HyperFrames 页面。文件变更时会重新构建，并持续运行，直到停止。它供屏幕前的用户使用，不是 MCP 工具。

选项：--port N（0 表示选择一个空闲端口）、--host、--no-open（自行启动 Studio 时使用）、--agent <command>（聊天所用的编码 Agent；默认为 Claude Code、Codex 或 Gemini CLI，以已安装的为准）、--allow-remote-agent、--props <json>、--offline。设置 --host 以便其他计算机访问 Studio 时，除非传入 --allow-remote-agent，否则 Agent 会关闭。

用户可以使用的功能

  • 预览和时间轴。 点击图层即可选中。拖动时间轴标尺或片段，即可选择一段时间。你收到的每条消息都包含所选内容：项目文件、合成、帧或时间范围，以及每个图层的名称、类型、源文件和行号、位置、尺寸、外观和插件。选择时间范围时，还会提供与之重叠的 Sequences，以及最多八帧的联系表。
  • Props 选项卡。 根据合成的 zod schema 绘制表单；编辑后会重新渲染预览。预设会将属性保存为入口旁边的 presets/<composition id>/<name>.json，而 --props 可从命令行渲染预设。
  • 标注模式（M）：用户可以固定一个点、框选区域、绘图或标记范围，并为每项添加评论。
  • 导出（顶栏）：选择一个范围、.mp4 或 .mov 路径以及草稿；随后会加入渲染队列。

工具

通过 MCP 使用时，需要打开 Studio（kinetograph mcp --studio <address>，令牌位于 KINETOGRAPH_STUDIO_TOKEN 中；Studio 自带的聊天 Agent 已经可以使用这些工具）：

  • studio_get_props 可读取预览中显示的属性；studio_set_props 可修改这些属性，用户会看到预览随之变化。可以先用这种方式尝试不同的值，再将选定的值写入代码或预设。
  • studio_open_panel 和 studio_panel_result 可在面板中请求用户做出决定（见下文）。

聊天 Agent 还可以使用所有 kinetograph 命令以及项目插件中的工具（<plugin>_<tool>）。

标注说明

以 Markup notes on <comp> 开头的消息是用户在预览上绘制的标注：按时间顺序排列的编号列表（帧、时间、合成像素坐标中的标记、标记下方的图层及其评论），每个不同的帧都附有一张绘有标记的图片（public/refs/markup-<stamp>-<n>.png，路径在消息中）。按顺序修复这些标注，最后用编号列表说明你处理了哪些、跳过了哪些以及原因。超过上限的帧不会附图：请根据帧编号和坐标处理。用户附加的图片也存储在 public/refs/ 中；请使用 staticFile('refs/name.png')。

新视频的面板

开始制作动画前，按顺序确定各项决策，使用 studio_open_panel：先填写简报（根据聊天内容预填已知信息），然后是脚本或音轨，再是分镜，最后确定视觉风格（styleframes）。制作动态分镜，并在动画制作前请求一次审核；先制作开场钩子和揭晓部分的动画，然后再次请求审核。跳过不适用于当前工作的阶段（修正字幕无需简报）。如果要在分镜尚未获批时制作动画，务必明确说明。

  • studio_open_panel({ panel, data, message?, placement? }) 会打开 brief、script、storyboard、styleframes、review 或 custom，并立即返回 { id, status: 'open' }。data 是面板的初始内容：部分 Brief；Storyboard（包含 comp 和 shots）；ReviewRequest（包含 comp、range?、ask?）。message 是显示在顶部的一行文字。 打开同类型的第二个面板会替换第一个。
  • studio_panel_result({ id }) 会返回 { status: 'open' | 'submitted' | 'dismissed', answer? }。仅当对方在终端中告知你已回答时才使用。

打开面板后，以一句话说明你正在等待什么，并结束当前回合。不要开始下一阶段，也不要再次调用工具检查。收到的答复会以 [panel <kind> <id> submitted] 开头；如果对方关闭了面板，则会收到 dismissed。开始制作前，请先阅读 plan/<panel>.json。

如果是一次性问题，内置面板不适用，请使用 panel: 'custom'；区块类型和答复格式见 references/panels.md。

评论

支持 Markdown