CLI、MCP 和快捷指令

安装命令

在设置 › 通用 › 命令行与 AI 智能体中，点安装 zumcast 命令…并输入你的 Mac 密码。然后在“终端”中运行：

zumcast list --json

命令

zumcast record start [--window <app>] [--camera] [--mic]
zumcast record stop | pause | resume | discard
zumcast list [--json]
zumcast info <project>
zumcast export <project> [--format mp4|mov|gif] [--codec h264|hevc]
               [--height 1080] [--fps 60] [--aspect 16:9|9:16|1:1|4:5|4:3]
               [--version <name>|--all] [--brand <kit|default>] [--out <path>]
zumcast guide <project> [--format markdown|html|pdf|interactive]
zumcast captions <project> [--vtt]
zumcast zoom regenerate <project>
zumcast zumi <project|shot> "cut the pauses" [--apply] [--json]
zumcast polish <project> [--apply]
zumcast brand list
zumcast shot take [--mode area|window|display|scrolling]
zumcast shot export <shot> [--format png|jpeg|pdf] [--scale 1|2]
zumcast shot web <url> [--width mobile|tablet|desktop|1440] [--dark] [--full]
zumcast search "pricing page" [--kind shot|recording] [--limit 10]
zumcast run <script.json>

加上 --json 即可输出脚本能读取的格式。免费版的限制在命令行中同样适用。

连接 AI 助手（MCP）

ZumCast 内置 MCP 服务器，让 Claude 等助手可以录制、用 Zumi 编辑、截图和导出，全部在你的 Mac 上完成。

1. 在设置 › 通用中，点拷贝 MCP 配置。
2. 把它粘贴到助手的 MCP 设置中（例如 Claude Desktop 的配置文件）。内容如下：

{
  "mcpServers": {
    "zumcast": {
      "command": "/Applications/Zumcast.app/Contents/SharedSupport/zumcast",
      "args": ["mcp"]
    }
  }
}

这些工具涵盖项目和录制（list_projects、search、start_recording、stop_recording）、Zumi（zumi_plan、zumi_apply）、导出（export_video、export_all、polish、export_captions）、指南和转录文本、缩放、截图（shot_take、shot_web、shot_render）以及预设。

一切由你掌控

• 每当命令行、助手、快捷指令或链接截图或开始录制时，屏幕上都会显示一条提示，例如“Claude (MCP) 截取了屏幕”。提示绝不会出现在截取的内容中。可以在设置 › 通用中关闭。
• 未签名的 zumcast:// 链接会先询问“允许此请求吗？”。
• 只有在你于设置 › 整理中允许后，助手才能搜索你的资料库。

录制脚本

录制脚本是一个由步骤（open、wait、click、hover、type、key、scroll）组成的 JSON 文件，ZumCast 会在录制时自动执行这些步骤，让每次演示都一模一样。可以通过文件 › 运行脚本…、zumcast run 或 MCP 工具 run_script 运行。

Siri 与快捷指令

ZumCast 为“快捷指令”应用添加了以下操作：截图（区域、窗口或显示器）、捕获文本、开始录制、停止录制和打开 Hub。你也可以对 Siri 说“用 ZumCast 截图”或“用 ZumCast 开始录制”。