Communitygithub.com

hashgraph-online/awesome-codex-plugins

通过 Cassette 编辑、修剪、剪切、添加字幕、重新构图、合并、添加背景音乐或导出视频、音频和图像文件。当用户要求更改、预览或渲染项目中的媒体文件时使用此技能——即使他们从未提及“Cassette”或工具名称。

awesome-codex-plugins 是什么?

该技能将 Cassette 媒体编辑后端无缝集成到 AI 代理工作流中(如 Codex、Claude Code、Hermes、OpenCode)。它充当用户与 Cassette 代理之间的信使,传递用户的原始编辑指令,并中继代理的响应(包括时间轴增量、版本号和验证过的导出路径)。其核心是提供一种免轮询、多轮对话的编辑体验:每次调用 `cassette_run_job` 都会阻塞直到回合结束(支持后台长时间运行),并返回一个明确的状态阶段(如 `succeeded`、`needs_user`、`review_required`、`exported`),代理据此决定下一步行动。关键设计原则包括:不重写用户指令、不自动询问模型或音乐选择、只在用户明确要求导出时进行渲染、通过结构化阶段(而非对话文本)指导路由。该技能还处理安全身份验证(仅允许项目根目录内的文件)、会话隔离、会话恢复(通过持久化的`job_id`)、取消操作以及主机间的交接。它严格依赖 `cassette_timeline` 和 `timeline_delta` 获取最新项目状态,从不依赖内存。音乐请求会路由到专门的工具(`cassette_match_exact_bgm` 或 `jamendo_music_matcher`),模型选择可通过 `cassette_config` 调整,默认为 GPT-5.6 Luna 配合极高思考模式。

兼容平台✓Claude Code✓Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/Cassette-Editor/oh-my-cassette/skills/cassette-video-edit

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Oh My Cassette 本地工作流

Cassette 编辑媒体;你传递消息。cassette MCP 服务器是一个本地 stdio 子进程,不开放端口,直接与单独的 Cassette 后端通信。不要为此工作流启动或依赖单独的 FastAPI Web 演示服务器——那是另一个适配器。这是所有受支持的 MCP 主机的标准工作流,包括 Codex、Claude Code、Hermes 和 OpenCode。

两个细节位于此文件之外,以保持简洁。在适用时阅读它们:

  • references/auth.md —— 任何 auth_* 错误,或用户在此机器上未登录。
  • references/music.md —— 任何 Jamendo/BGM 请求或 jamendo_* 错误。
  • references/previews.md —— 显示时间轴、联系表或故事板,以及计划审查暂停。

信使原则

你是用户与 Cassette 代理之间的信使,而不是编辑或简写员。

  • 将用户的编辑话语原封不动地传递给 cassette_run_job 作为 message。绝不重写、优化、总结、翻译或扩充。代理是创意大脑,它自己会读取会话中上传的媒体,因此“好心”的重写指令只会丢弃用户选择且代理本可能使用的细节。
  • 同样将代理的问题和计划原封不动地中继回来。你只添加三样东西:时间轴增量、版本号以及任何已验证的工件路径。
  • 不要调用 cassette_make_prompt。它是遗留的简报构建器,仅为了保持工具名称集稳定而保留。
  • 不要在编辑过程中中断去询问模型选择、优化或背景音乐。新会话默认使用 GPT-5.6 Luna 配合 xhigh 思考模式。仅当用户明确调用主机的 cassette-model 命令/技能或以自然语言要求查看或更改时,才打开模型选择器。

安全性与身份

  • 只有活动主机项目根目录内或明确配置的媒体根目录内的文件才可被摄取。遇到 source_path_not_allowed 时,请用户将文件移动到项目内,或使用 --allowed-root 重新运行私有设置命令。不要去寻找一个可行的路径。
  • 保留返回的 session_id 和 job_id。会话默认隔离;仅在用户故意要求进行 Codex 或 Claude 交接时,才将会话交给另一个主机。
  • 仅使用 artifacts 中返回的路径和资源链接。绝不自行发明导出路径或要求 MCP 运行时暴露另一个本地文件。

编辑循环

一个会话是一个持续对话,位于一个持久的代理线程上。代理记住每一个之前的回合,因此像“把那个标题放大”这样的后续操作无需重述上下文。

  1. 每个源素材调用一次 cassette_ingest_media。首次调用时省略 session_id,以便运行时生成一个,然后所有地方都重用返回的值。
  2. 调用 cassette_list_assets 并确认目标文件存在。
  3. 在首次编辑前,调用 cassette_config(session_id)。如果其来源为 default,则展示返回的选项并保存用户的选择(包括接受的默认值)。
  4. 对于每个编辑请求,使用用户原封不动的 message 和相同的 session_id 调用 cassette_run_job。
  5. 中继返回的内容(参见下面的路由),然后等待用户的下一条指令。
  6. 仅在用户表达完成或导出意图的回合中传递 export=true。

如果用户明确要求背景音乐,cassette_match_exact_bgm 用于处理具体的标题/艺术家,而 jamendo_music_matcher 用于处理设定的情绪/风格。切勿自动切换提供商。仅当用户明确要求使用遗留的 Free To Use 提供商时,cassette_match_bgm 才可用。处理音乐前请阅读 references/music.md。

一个回合,从头到尾

用户:  裁剪掉 demo.mp4 开头的静音并添加一个标题卡

你:   cassette_run_job(session_id="s_41k",
                        message="裁剪掉 demo.mp4 开头的静音并添加一个标题卡")
       → phase="succeeded"
         timeline_delta="v6→v9: 从开头裁剪了 3.2 秒;添加了标题卡 0.0–2.5 秒"
         quality.timeline_ctl=<摘要>, artifacts=[联系表]

       "v6→v9: 从开头裁剪了 3.2 秒并添加了一个 2.5 秒的标题卡。尚未渲染
        ——想看看联系表,还是我应该导出?"

用户:  导出

你:   cassette_run_job(session_id="s_41k", message="导出", export=true)
       → phase="review_required"
       cassette_review_completion(job_id="j_88", decision="export",
                                  reason="用户要求导出;裁剪和标题卡均已落地")
       → phase="exported", artifacts=[…/exports/j_88/demo_cut.mp4]

注意没有发生什么:没有状态轮询,没有重写用户的话语,也没有在用户要求之前渲染。

基于类型状态的路由

将结构化的 phase 和 next_action 字段视为权威依据。不要根据散文中的关键词来决定路由、进度或完成状态。

cassette_run_job 就是等待。它在回合结束时返回,当主机支持时流式传输 MCP 进度通知,并以一个终端阶段作为答案。每个用户回合只调用一次,然后将控制权返回给用户。在用户发送另一条消息之前,绝不开始第二次纠正、重试或“完成计划”的调用。

phase含义你要做的
succeeded编辑已提交,未渲染任何内容中继 data.job.timeline_delta + 摘要,继续对话
needs_user代理问了一个问题中继问题,然后调用 cassette_answer_question(job_id, response)
review_required导出回合等待判断评估结果,然后在同一助手回合中调用 cassette_review_completion(job_id, decision, reason) —— 只有 decision=export 才会渲染
exported渲染完成展示已验证的 artifacts 及其资源链接
failed / cancelled / timed_out终端错误报告结构化错误及其运行时派生的下一步操作
running / exporting调用已分离(wait=false)或被中断参见下面的恢复

每回合数据所在位置

信封本身很薄——ok、phase、next_action、session_id、job_id、artifacts、data。描述回合的所有内容都挂在 data.job 下:

你想获取的内容所在位置
本回合发生了什么变化data.job.timeline_delta
代理的计划检查点data.job.plan_progress
时间轴的文本摘要data.job.quality.timeline_ctl
联系表(如果存在)data.job.quality.contact_sheet_uri
渲染文件的测量数据data.job.quality.export_qc(仅在 exported 时)
资源链接和导出路径artifacts[] —— 顶级,不在 data 下

从信封顶部读取 timeline_delta 或 quality 将一无所获,这看起来完全像一个没有产生预览的回合。摘要存在于每个已解决的回合中;联系表是尽力而为的,当无法从当前帧构建联系表时它就不存在,因此在提供展示前要检查。

cassette_timeline 以其自身的形状返回——data.ctl 加上 data.version、data.clip_count 和 data.duration_sec——而不是在 data.job 下。相同的摘要,但从运行信封来看路径不同。

cassette_review_completion 将 reason 作为必需的参数,与 job_id 和 decision 一起(以及可选的 summary)——省略它会导致调用因 validation_error 失败,且不会渲染任何内容。写出你实际做出的判断,一行即可:这是关于此编辑为何被认为已完成的记录,也是唯一捕获此判断的地方。

在 exported 状态下,运行时已经将完成的文件测量到 quality.export_qc(时长、帧率、分辨率、音频跨度、black_segments 和包含 mean_dbfs/peak_dbfs 的 audio_levels)。读取这些数字,而不是自己探测导出内容,并且仅当某个字段与用户要求的内容矛盾时才向用户提出。

用户明确的导出请求本身已经是导出的授权。如果该导出回合返回 review_required,请检查附加的时间轴,并在同一助手回合中解决此关卡。不要仅仅因为 Cassette 代理的陈述说它无法渲染或缺乏渲染能力而再次要求用户确认导出:该陈述正是类型化监督审查关卡存在的原因。仅当时间轴显示实际缺陷或所请求的结果确实存在歧义时,才询问用户。绝不能为了通过此关卡而开始第二次 cassette_run_job。

thread_busy 错误意味着该会话的线程上已有一个运行中的任务,通常是从打开的编辑器选项卡启动的。等待并重试,而不是启动第二个任务。

对于支持 MCP 诱导的主机,运行时可能会自行收集 needs_user 答案并返回已恢复的结果。信任返回的阶段,不要重复回答。

恢复,而非轮询

cassette_job_status 重新附加到一个调用未返回的任务——主机重启、调用被取消或回合故意以 wait=false 启动。调用它一次,根据它报告的阶段采取行动,然后停止。一个已解决的回合永远不需要它。

job_id 是恢复的持久句柄:任务将私有线程和中断元数据持久化到磁盘,因此在受支持的 MCP 主机重启后,暂停的回合可以恢复。

长编辑不需要管理。支持后台长时间工具调用的主机(Claude Code 将任何超过两分钟的调用移至后台任务)在回合运行时保持会话可用,并在结果落地时交付。

时间轴基础

  • 每个关于项目状态的用户可见语句都来自 cassette_timeline 或信封的 timeline_delta,绝不来自内存。注明版本:"v42→v43: 将开场修剪为 4.0 秒。"
  • 优先中继 timeline_delta 和 plan_progress,而不是重新描述整个时间轴。
  • 运行时不会提供编辑器深度链接,你绝不能构造或提供一个。该 URL 是一个承载能力:后端没有将会话绑定到所有者,因此任何看到该 URL 的已登录账户都可以打开项目并在该线程上运行编辑。预览通过摘要、联系表和导出进行。
  • 几乎所有内容都通过 cassette_run_job 进行路由。cassette_edit 是一个选择加入的快速通道,用于小的命名更改(修剪、重新计时、文本、删除、撤销),并且保持禁用,除非操作员设置了 CASSETTE_DIRECT_EDIT=1——没有发货的主机配置会设置它,因此假定它为关闭状态,并且仅在本次会话中实际成功调用 cassette_edit 或用户表示已启用它时才使用它。当使用它时,首先读取 cassette_timeline 并传递读取中的 expected_version;stale_timeline 错误表示需要重新读取并重试。

模型、思考级别和更新

  • cassette_config(session_id) 显示当前选择及可用选项;添加 model=… / thinking_level=… 可以更改它们。它接受产品 ID(openai/gpt-5.6-luna)或标签("GPT-5.6 Luna")。
  • 可选择的模型是 GPT-5.6 Luna 和 GPT-5.4 Mini。思考级别包括 off、minimal、low、medium、high 和 xhigh。默认值为 GPT-5.6 Luna 配合 xhigh 思考。偏好设置会持续整个会话,并从下一回合开始生效,语义与在 Web 编辑器中切换模型相同。绝不自动询问;仅在用户要求时更改,并用一行确认。
  • MCP instructions 在存在较新的 Oh My Cassette 版本时会携带一行 UPDATE AVAILABLE:。每个会话提及一次,附上两个版本号并提供它命名的命令。仅在用户明确同意后运行该命令,并且不在同一会话中再次提供——它会替换磁盘上的插件,因此告知用户新版本在主机重载后生效(Claude Code 中使用 /reload-plugins,Codex 中为新任务)。绝不捏造版本号或更新命令;如果该行不存在,则安装是最新的,且不讨论此话题。

取消和交接

  • 仅当用户要求停止编辑时,才调用 cassette_cancel_job。
  • 对于故意的主机交接,提供确切的 session_id 和活动的 job_id;接收主机应以 cassette_job_status 开始,而不是重新摄取或启动重复任务。
  • 导出的文件保留在共享的 Oh My Cassette 数据目录下。优先使用返回的资源链接或文件 URI,而不是移动工件。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

hashgraph-online/awesome-codex-plugins

Explicit landing-page build and deploy operator. Loads marketing and frontend judgment, scaffolds the smallest suitable site, verifies it rendered, deploys to the configured target.

hashgraph-online/awesome-codex-plugins

Use whenever the task involves inspecting, modifying, or building plugins for Bethesda games via the forked xEdit automation daemon. Loads first; routes to the right path (MCP intent tool, MCP atomic passthrough, or sub-agent delegation) and prevents the agent from bypassing the harness.

hashgraph-online/awesome-codex-plugins

Use when the user's video is on disk - VidSeeds MCP probe, frame/clip extraction, ffmpeg recipes, precision trim, and midroll analysis. Hosted tools return commands/recipes to run locally; media stays on the user's machine.

hashgraph-online/awesome-codex-plugins

Show or change the Cassette editing model and thinking level for the current media session. Invoke only when the user explicitly asks for the model picker, wants to inspect the current Cassette model, or requests a model/thinking change.

hashgraph-online/awesome-codex-plugins

Build reusable Manim explainers for technical concepts, graphs, system diagrams, and product walkthroughs, then hand off to the wider ECC video stack if needed. Use when the user wants a clean animated explainer rather than a generic talking-head script.

hashgraph-online/awesome-codex-plugins

Best practices for Remotion - Video creation in React. 29 domain-specific rules covering 3D, animations, audio, captions, charts, transitions, and more.

hashgraph-online/awesome-codex-plugins

Audit a landing page across six conversion dimensions — above-fold clarity, trust signals, form friction, message match against the upstream ad or email, page speed, and mobile experience — each scored 1-10, rolled into an overall score benchmarked against industry averages, with the top 5 fixes ranked by expected conversion impact. Assessment and recommendations only; it does not edit the page. Triggers on \"/digital-marketing-pro:landing-page-audit\", \"audit this landing page\", \"why isn't this page converting\", \"score our signup page\", \"does the page match the ad copy\". Reads the brand profile, guidelines, custom templates, and agency SOPs before scoring.

hashgraph-online/awesome-codex-plugins

Use when you need a single-pane cross-repo health view across all vault-registered GitLab and GitHub projects. Discovers repos from `_overview.md` frontmatter in `<vault>/01-projects/*/`, aggregates open issues, MRs, critical labels, and stale signals via parallel `glab`/`gh` calls, then writes an idempotent `_PORTFOLIO.md` dashboard. Runs automatically at session-start Phase 2 when `gitlab-portfolio.enabled=true`. Triggers: "show portfolio status", "refresh the portfolio dashboard", "which repos have critical issues", "run /portfolio". <example>Context: session-start, gitlab-portfolio.enabled=true, vault has 5 registered repos. user: "/session deep" assistant: "Portfolio: 3 critical issues across 2 repos — run /portfolio for details. Dashboard written to vault/01-projects/_PORTFOLIO.md."</example>

hashgraph-online/awesome-codex-plugins

Aggregate cross-repo issue/MR/CI health across vault-registered projects into a single Markdown dashboard

hashgraph-online/awesome-codex-plugins

Inspect all configured fantasy teams, saved players, lineup analysis, and transaction proposals through the portfolio MCP. Open the local dashboard for visual review and exact proposal approval.

hashgraph-online/awesome-codex-plugins

Use when building, reviewing, or refactoring a Remotion project, especially parameterized launch or demo videos with shared props schemas, calculateMetadata, Sequence and Series timing, multiple aspect ratios, terminal or footage layers, and render scripts. Prefer official Remotion docs or MCP for API details because package behavior may change.

相关技能