mcpField
M
media-analysis

media-analysis

github.com/postplusai创意与媒体27110 次安装1 天前更新
代码仓库

关于 media-analysis

media-analysis 是指导 Agent 分析视频和图像的技能,优先使用本地帧与可见字幕回答视觉问题,并明确证据范围和音频局限。只有重要语音信息仍无法确认时,才按规定流程使用云端分析。

主要功能

  1. 01生成带时间戳的联系表
  2. 02检查本地视频帧与图像
  3. 03按需细化短镜头取样
  4. 04规定云端分析的使用条件
  5. 05保存结果并说明证据局限

适用场景

  1. 01从视频帧梳理场景顺序
  2. 02核对画面中的文字与产品
  3. 03字幕不足以回答时分析语音
  4. 04根据既有帧和报告回答后续问题

安装

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

$npx skills add https://github.com/postplusai/postplus-skills --skill media-analysis

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

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
ordered-image-evidence.md
single-video-report.md
video-analysis.md
video-frames.md

详细介绍

原文在翻译后有更新,译文可能不是最新。

媒体分析

分析用户的链接、本地文件或可见图片,并给出可读的 发现结果,附上实际的视觉证据。在内部选择必要的工作。

对于多参考对比或要求提供详细的逐镜头证据,请阅读 多源镜头分析。这一分支 在综合之前保持各来源独立;普通分析会跳过它。

选择工作

  • 视频理解: 使用 postplus media analyze video-analysis 处理 动作、声音、对话以及随时间的发展。传入原始来源; 命令行负责获取和传输。阅读执行与恢复。
  • 可读图片: 直接查看它们。对于已经可以在对话中或本地 访问的图片,无需下载、上传或 Gemini 调用。
  • 原生图片帖子: 使用 postplus media prepare --source <url>,然后 检查按顺序排列的原图。阅读图片证据。
  • 截图、文字、颜色或布局: 查看足够的图片或本地 视频帧,而无需购买完整视频分析。阅读视频帧。

由静止图像制作的 MP4 仍是具有真实时间线的视频。准备工作必须 返回实际的本地文件,然后才能将其视为已下载的证据。 将多个来源、失败和输出彼此分开。根据现有报告和证据回答 后续问题,而无需另一次付费分析。

视频命令

postplus media analyze video-analysis \
  --video ./reference.mp4 \
  --output ./result.md

遵循命令行的结构化结果和报告的下一步操作;不要从自由文本消息中推断恢复。 在要求时等待用户明确批准;某项操作并不授权支出、发布或覆盖。 通过其返回的检查点或操作恢复同一操作;切勿重新提交不确定的工作、重复已耗尽的恢复,或切换提供商以绕过失败。

省略 --prompt 以获得视频报告中描述的 默认镜头表和生产说明。针对用户 的具体问题或要求的格式提供它;不要附加无关的完整报告。 video-analysis 是命令行能力键,而不是另一个 Skill。 仅在构建或修复未知的托管媒体请求结构时使用 postplus media schema --json;对于 正常分析路径,保留上面生成的命令。

交付

在对话或 Markdown 中嵌入已检查的图片或真实截图, 并附上来源、原始页面索引或测得的视频时间戳,以及每项所支持的观察。 仅提供路径或文件夹链接不构成视觉交付。切勿用封面、生成图像或猜测的描述 替换缺失的证据。

对于长报告,在聊天中展示代表性帧,并链接完整的 Markdown。 保持返回的模型 Markdown 不变;在单独的证据说明中添加 Agent 查看过的截图和任何 更正。使用相对链接将附件保存在报告旁边,验证这些链接,并在临时清理后保留它们。 切勿删除用户文件或已交付的证据。

说明缺失的页面、无法读取的文字、不可用的音频以及已检查的子集。 少量帧不能证明完整的音频/视频覆盖。区分可见事实、 捕获的措辞、解释以及需要外部验证的说法。

恢复

在等待期间报告观察到的进度。让命令行执行有界恢复; 在断开连接的等待之后,对同一任务、账户和环境使用其输出的轮询或检查点命令。不要重启不确定的付费分析。 内容质量问题或改写请求不授权付费重做。

对于远程工作开始前明确的本地参数拒绝,使用该命令的 --help 和现有用户输入进行一次更正。如果提交可能已经开始,仅遵循其输出的恢复命令。在就绪失败后,使用 postplus doctor --skill media-analysis 进行就绪诊断。如果提交可能已经发生,保留任务身份。 在现有明确成本授权足够时,遵守报价质询;否则请求批准,然后使用提供的确认/重试命令。

对于终端失败,给出其阶段、原因、操作 id(如果存在)、成本状态和具体的下一步。未知结果不代表没有收费。交付有用的部分证据及其限制;绝不要声称分析了未见过的材料。

评论

支持 Markdown