videodb

videodb 技能概览

videodb 是用来做什么的

videodb 技能帮助你把视频和音频当作可搜索、可编辑、面向 AI 的媒体来处理，而不是一堆难以直接利用的文件。它最适合需要先导入媒体、再精准定位片段，并进一步对这些片段进行剪辑、叠加字幕、转写或实时告警的人。

最适合的用户和任务

如果你的工作流同时覆盖 视频导入、桌面采集、带时间戳搜索 和 时间线编辑，就适合用 videodb 技能。它尤其适合编辑人员、工程师和 AI 构建者，想要的是有证据支撑的结果，特别是用于 VideoDB for Video Editing 和直播流分析的场景。

主要差异点

和那种泛泛而谈“视频工具”的提示词不同，videodb 技能是围绕可落地的产物来设计的：可播放的流链接、带时间戳的可搜索索引、自动生成剪辑，以及服务端时间线合成。它在你需要从 RTSP/RTMP 流或桌面会话获取实时上下文，而不只是离线文件处理时，也特别有用。

如何使用 videodb 技能

安装并明确任务范围

使用 npx skills add affaan-m/everything-claude-code --skill videodb 进行安装。只有当你的任务足够具体，能明确说明来源、目标转换和输出格式时，才应该用它。好的输入会写清媒体类型、来源位置，以及“完成”具体意味着什么。

给模型正确的输入形状

使用 videodb 时，不要笼统地说“帮我剪视频”。要说明要导入什么、要找什么、要产出什么。高质量提示词通常会包含来源类型、时间范围、期望编辑内容和约束条件。比如：“索引这段 Zoom 录制，找出所有提到价格异议的地方，返回时间戳，然后生成一个 45 秒的高光剪辑并附上字幕。”

先读这些文件

先从 SKILL.md 开始，然后查看 reference/api-reference.md、reference/capture.md、reference/rtstream.md、reference/search.md、reference/editor.md 和 reference/generative.md。如果你需要处理事件，打开 scripts/ws_listener.py 和 reference/capture-reference.md，先把实时流转过程搞清楚。

会影响结果的工作流建议

在决定是否安装 videodb 时，关键问题是你的工作流是否依赖时间戳和证据。只有当你需要的是已索引的片段，而不只是最终渲染好的文件时，才应该使用它。为了获得更好的输出质量，最好先明确你要的是搜索、导出、编辑还是告警；这个技能支持不同路径，提示词也应该先选定其中一条。

videodb 技能常见问题

videodb 只是做编辑吗？

不是。VideoDB for Video Editing 只是这个技能的一部分。videodb 还覆盖采集、索引、搜索、直播流导入和告警，因此它比传统的编辑提示词范围更广。

什么时候不该用 videodb？

如果你只需要简单的一次性裁剪、基础转写，或者不需要播放链接、时间戳和媒体操作的通用摘要，就可以跳过它。这种情况下，普通提示词通常更快。

videodb 适合新手吗？

适合，只要你能清楚描述来源和目标结果。只要你知道自己需要的是采集、搜索还是编辑，它就会更容易上手。如果你指望模型只靠一句话就自行推断完整媒体工作流，那它就不太合适。

它适合直播流和桌面采集吗？

适合。这正是使用 videodb 技能最有力的理由之一。它支持直播流、桌面会话、实时事件和可搜索回放，而这些通常是普通视频提示词处理不好的部分。

如何改进 videodb 技能

明确你要返回的证据

质量提升最大的一步，是要求输出必须对应具体片段，而不是观点。告诉模型你要的是时间戳、剪辑链接、可搜索时间线，还是编辑指令。比如：“返回最相关的三个片段，附上时间戳，并说明每个片段为什么被选中。”

给出更严格的来源约束

高质量的 videodb 指导提示词会明确来源格式、时长、语言，以及媒体是本地、远程还是直播。如果你要用 VideoDB for Video Editing，还应明确画幅比例、字幕样式、品牌元素或音频叠加需求。输入含糊时，通常只会得到泛化或过宽的结果。

从搜索迭代到动作

一个很好的模式是：先导入或建立索引，再检查结果，然后再要求编辑或导出。如果第一次结果太宽泛，就按短语、场景类型、说话人或时间范围继续收窄。如果结果太窄，就扩大查询范围，但保持输出格式不变，这样下一轮结果仍然可用。