Communitygithub.com

0xsline/openchatcut

À utiliser pour acquérir ou importer des médias dans la bibliothèque d'actifs d'un projet OpenChatCut pour le montage vidéo ou la création, y compris les vidéos locales/attachées, les chemins fournis par l'utilisateur, les URL de médias publics, les actifs vidéo/audio/image web, les décisions de repli de téléchargement, et le choix entre import_media, download_media ou une action manuelle de l'utilisateur.

Qu'est-ce que openchatcut ?

Cette compétence gère l'importation de médias dans un projet OpenChatCut. Elle prend en charge trois méthodes principales : le glisser-déposer de fichiers locaux par l'utilisateur, le téléchargement à partir d'URL publiques via `download_media`, et le transfert depuis des hôtes externes via `import_media` avec création de session. Le pipeline local gère automatiquement le transcodage, l'extraction audio et la transcription. Les actifs importés sont stockés localement et peuvent être mis en miroir sur Cloudflare R2 pour un accès multiplateforme. L'agent ne peut pas lire le système de fichiers de l'utilisateur ni effectuer de transferts depuis localhost. Pour les montages multi-sources, elle impose d'importer les originaux et de réaliser toute la composition dans le timeline, sans pré-assemblage ni pré-trim.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0xsline/openchatcut/tree/HEAD/src/agent/skills/asset-import

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Importation d'actifs

Cette build exécute l'éditeur et son serveur multimédia localement. Il n'y a pas d'API d'importation hébergée, pas de CLI ni d'OAuth : les médias entrent dans le projet via l'interface utilisateur de l'éditeur ou via les outils agent ci-dessous. Choisissez le chemin en fonction de l'emplacement des octets.

Chemin 1 — fichiers locaux de l'utilisateur (principal)

Demandez à l'utilisateur de faire glisser les fichiers dans l'éditeur (zone de prévisualisation ou panneau 我的素材) ou d'utiliser le bouton de téléchargement. Le pipeline local s'exécute ensuite automatiquement : écriture en streaming vers /media/uploads/, transcodage conditionnel (≤1920 bord long, codec compatible navigateur, ~8Mbps), extraction audio et transcription automatique (la RAP démarre au téléchargement). Ne demandez pas à l'utilisateur de pré-convertir, pré-recadrer ou transcoder quoi que ce soit lui-même — le pipeline s'en charge.

L'agent ne peut pas lire le système de fichiers de l'utilisateur. Si l'utilisateur vous donne un chemin /Users/... ou C:\..., dites-lui de déposer ce fichier dans l'éditeur à la place ; vous ne pouvez pas le récupérer.

Chemin 2 — URL publiques (piloté par l'agent)

Utilisez download_media avec une seule URL ou un tableau de lots. Le serveur récupère, stocke sous /media/uploads/ et enregistre les actifs du pool. Préférez cette méthode pour les médias stock/web pointés par l'utilisateur. Après le téléchargement, l'actif se comporte comme n'importe quel autre actif du pool multimédia.

Chemin 3 — transfert depuis un hôte externe

Appelez import_media avec {"action":"create_session", "assetType":..., "filename":..., "contentType":..., "size":...}. Cela renvoie un emplacement de téléchargement à courte durée de vie lié au projet actuel, à la session, à l'identité de l'actif, au nom de base, POST, au type MIME et au nombre exact d'octets. Un script côté hôte peut télécharger vers cette URL exacte avec les en-têtes déclarés. Le bac à sable de l'agent ne peut pas atteindre le localhost de l'utilisateur, donc n'essayez pas le transfert depuis run_code.

La réponse de téléchargement réussie renvoie un reçu opaque, un assetType renvoyé et un chemin téléchargé. Sondez le chemin téléchargé lorsque la durée exacte, les dimensions, les fps ou la présence audio sont nécessaires, puis appelez finalize_uploaded_asset avec le reçu, le assetType renvoyé, les métadonnées mesurées du média et durationInSeconds pour audio/vidéo/gif. Le serveur résout le hachage, le chemin, la taille, le nom de fichier et l'ID de l'actif faisant autorité. Finalize valide l'actif mais ne démarre jamais la RAP ; après avoir placé un actif audio/vidéo sur une piste, invoquez transcribe_track séparément si une transcription est souhaitée. L'actif n'est pas présent ni utilisable avant la réussite de finalize. Pour le remplacement d'un média manquant, transmettez l'assetId existant à import_media ; omettez-le pour un nouvel actif. Ne construisez jamais vous-même /media/uploads/... et ne prétendez jamais que les octets sont prêts avant la réponse de téléchargement.

Discipline de montage

Pour les montages multi-sources, construisez un travail révisable à partir des actifs sources originaux dans le timeline d'OpenChatCut. Ne concaténez pas localement, ne pré-recadrez pas, ne pré-composez pas, ne brûlez pas de sous-titres et n'aplatissez pas les médias avant l'importation — importez les originaux et effectuez toute la composition sur le timeline afin que chaque étape reste révisable et annulable.

Pour les actifs de code tels que les graphiques animés créés à la main, utilisez la compétence create-motion-graphics (create_motion_graphic_from_code pour les nouveaux actifs, mises à jour du code des actifs pour les modifications) — le code MG n'est pas un fichier importé.

Notes de stockage

  • Les octets résident sur le disque local (/media/uploads/), servis directement avec prise en charge de Range. Si Cloudflare R2 est configuré, les téléchargements sont mis en miroir vers R2 et d'autres appareils peuvent y puiser ; sans R2, le projet est uniquement local.
  • Local uniquement est un état final valide : la prévisualisation, le montage et l'exportation lisent tous à partir du disque. La mise en miroir dans le cloud n'est nécessaire que pour l'accès multi-appareils.

Individual skills in this repo

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

0xsline/openchatcut

Connect an MCP-capable coding agent to OpenChatCut and edit local video projects. Use when the user asks to install, connect, or set up OpenChatCut; inspect or edit an OpenChatCut project; work with its timeline, transcript, captions, media, generation, motion graphics, audio, color, or export tools; or recover from an OpenChatCut MCP error.

0xsline/openchatcut

Use when a OpenChatCut video editing or creation workflow needs export, render, download, share, final delivery, subtitle-file export, render choice, local-only asset handling, or export fallback explanation.

0xsline/openchatcut

AI image generation via Fal.ai, gpt-image-2, nano-banana, MiniMax image-01, and xAI Grok Imagine. Use when the user wants to generate or create an image / picture / still.

0xsline/openchatcut

Use when a OpenChatCut tool call fails or returns an unexpected shape.

0xsline/openchatcut

Music generation via Mureka, MiniMax, Atlas Cloud, and Sonilo. Use for instrumentals, songs, soundtracks, track/stem generation, covers, or video-conditioned scoring of the finished cut through `submit_music`.

0xsline/openchatcut

OpenChatCut product knowledge — UI layout, editor features, and how generation providers are configured. Use when the user asks about the product interface, how to use a feature, where to find something, or needs GUI guidance for something the agent cannot do directly. Also use as fallback when a task fails and the user needs to complete it manually in the UI. NOT for live project-state queries ("where are my folders?", "what's on my timeline?", "where is clip X?") — those are answered by `read_project`, not by this skill.

0xsline/openchatcut

AI shader generator for WebGL video effects, transitions, masks, and color grading (LUT / 调色 / 电影感 / film look). Use when the user wants a video effect (滤镜 / 特效), a transition (转场 / crossfade / wipe / cube / 3d), a mask (蒙版 / 遮罩 / reveal), a zoom / push-in (推近 / 推镜头), or a color grade — try the built-in effects (zoom, builtin LUTs) before generating a new shader.

0xsline/openchatcut

Use when checking whether agent edits are reflected in the OpenChatCut project and editor.

0xsline/openchatcut

AI video generation via Fal.ai, Seedance 2.0, Kling, MiniMax Hailuo, xAI Grok Imagine, and OFox. Use when the user wants to generate a video clip — text-to-video, image-to-video, first/last-frame transitions, reference-guided generation, multi-shot, or generatively editing / extending an existing clip.

0xsline/openchatcut

Text-to-Speech (TTS), voiceover, narration placement/sync, and custom sound effects (SFX) generator. Use when the user wants generated speech from text, wants to add/replace/align narration or voiceover for an existing video/timeline, wants to keep existing voiceover synced after visual retiming edits, needs voice audition/selection, or explicitly wants a newly generated/custom sound effect that is not available in the Sound Effects library.

0xsline/openchatcut

Use when the agent should ask the user for structured input with an in-chat form, including single-select, multi-select, text fields, style pickers, or voice audition choices.

Skills associés