本文へ移動
cccskills
無料GitHub で公開

subtitles-and-text-effects

字幕与花字:为带货短视频生成 ASS/SRT 字幕与花字(大标题弹出、关键词高亮、贴纸标签、行动号召按钮),自动避开平台底部/右侧 UI 安全区,并用 ffmpeg/libass 烧录。

Use when the user wants subtitles, captions, 字幕, 花字, 大字报, keyword highlight, burned-in captions, SRT/ASS files, or text overlays that don't get covered by TikTok/抖音 UI.

インストール方法を見る

含まれるファイル(2)

  • SKILL.md3.8 KB
  • scripts/make_subs.py5.6 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

字幕与花字 · Subtitles & Text Effects

一份 ASS 同时放四种样式:Sub(底部字幕)· Hook(弹出式大花字)· Tag(左上角贴纸)· CTA(行动号召按钮)。脚本:scripts/make_subs.py。

Part of ecommerce-video-skills

输入 Inputs

  • 时间轴 JSON(ffmpeg-auto-assemble 自动生成 build/timing.json),或自己写:
{"size": [1080, 1920], "cues": [
  {"start": 0.10, "end": 2.70, "text": "冰水撑不到中午?", "style": "Hook"},
  {"start": 0.15, "end": 2.60, "text": "冰水不到中午就**变温**了?", "style": "Sub"},
  {"start": 0.00, "end": 17.0, "text": "AURA 保温杯", "style": "Tag"},
  {"start": 14.2, "end": 17.0, "text": "点击下方链接 ›", "style": "CTA"}]}

标记语法 Markup

写法效果
**关键词**关键词换成高亮色(默认暖黄)
`早上装满冰块到晚上冰块还在`

步骤 Steps

  1. 每条字幕 ≤ 14 个汉字(1080 宽 ≈ 一行),超过用 | 拆。
  2. 每条只高亮 1 个关键词;花字 ≤ 10 字,只在钩子和关键卖点用。
  3. 生成:python scripts/make_subs.py build/timing.json -o build/subs.ass --srt build/subs.srt
  4. 烧录:ffmpeg -i in.mp4 -vf "ass=build/subs.ass" -c:a copy out.mp4
  5. 平台若支持上传字幕文件(如 YouTube / 部分广告平台),同时交付 .srt。

安全区 Safe zones(经验值,以真机为准)

  • 底部约 20%:标题文案、商品卡、购物车 → 字幕 MarginV 默认 26% 高度
  • 右侧约 15%:点赞/评论/分享按钮 → 左右边距 70px,重要信息别贴右边
  • 顶部约 8%:状态栏/搜索 → Hook 放在 13% 高度处
  • 用 python skills/platform-spec-export/scripts/export_platform.py video.mp4 --safe-preview safe.png(在仓库根目录运行) 叠加检查

样式定制

编辑 make_subs.py 里的 header():字号按画面高度比例计算(9:16 / 1:1 / 16:9 都适用),颜色为 ASS &HAABBGGRR。字体自动探测(Noto Sans CJK SC / 思源黑体 / 苹方 / 微软雅黑),也可 --font "思源黑体 CN"。

提示词模板 Prompt template

把这段口播稿拆成短视频字幕:每条 ≤14 字,超过用 | 分段;每条最多 1 个关键词用 **加粗**;
另外为钩子镜头和最强卖点各写 1 条 ≤10 字的花字。输出 JSON cues(start/end 先留空)。口播稿:{…}

检查清单 Checklist

  • 字幕不压商品主体、不进底部 20% / 右侧按钮区
  • 每屏最多 2 行;关键词高亮 ≤ 1 个
  • 错别字/品牌拼写检查;数字与配音一致
  • 中文字体已安装(否则会出现方框)

常见问题与修复 Failure fixes

问题修复
中文显示成方框安装 CJK 字体(apt install fonts-noto-cjk)或 --font 指定已安装字体
No such filter: 'ass'ffmpeg 未编译 libass,换官方/发行版完整版 ffmpeg
路径含冒号报错(Windows)用相对路径或把 C: 写成 C\:;脚本已自动转义
字幕和声音不同步用真实配音时长生成 timing(assemble.py 已自动处理)
字幕太小调 header() 中 sub = round(h * 0.037) 的系数

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

AI 口播配音:用免费的 edge-tts(微软 Edge 在线语音)为带货短视频逐句生成配音,自动去首尾静音、统计每句时长、缓存复用,可选音色/语速/音调,并给出口播稿改写规则。Use when the user needs a voice-over, 配音, 口播, 旁白, TTS, text-to-speech, AI 主播声音, or wants to turn a script into audio for 抖音 / TikTok / 视频号 videos.

日本語の概要は準備中です。原文の説明を表示しています。

xianyu110/ecommerce-video-skills662026年10月5日 更新

封面与标题 A/B:为带货短视频生成多套封面(自动挑选清晰帧或用干净素材图 + 不同标题与版式)和多组标题/文案,导出 3:4 / 9:16 封面文件和对比图,并给出 A/B 测试方法与记录表。Use when the user wants a video cover, 封面, 首图, thumbnail, 标题, 文案, title variants, A/B test covers for 抖音 / 视频号 / 小红书 / TikTok, or wants to improve click-through rate.

日本語の概要は準備中です。原文の説明を表示しています。

xianyu110/ecommerce-video-skills662026年10月5日 更新

ffmpeg 自动拼接成片:一条命令把 storyboard.json(商品图/视频片段 + 口播稿)渲染成带配音、字幕花字、转场、BGM 自动闪避、响度标准化的 9:16 MP4,纯本地运行。Use when the user wants to assemble/edit/render a product video, 自动剪辑, 一键成片, 拼接视频, 图片转视频, Ken Burns, add BGM/subtitles/voice-over with ffmpeg, or batch-produce short videos without an editor.

日本語の概要は準備中です。原文の説明を表示しています。

xianyu110/ecommerce-video-skills662026年10月5日 更新

3 秒钩子脚本:为电商短视频写前 3 秒开场(台词 + 画面 + 花字),按痛点/反差/结果先行/提问/数字/场景代入等钩子类型一次给出多版,并做合规自检。Use when the user asks for a hook, 开头, 黄金 3 秒, 前三秒, opening line, scroll-stopper, 完播率, or wants to rewrite a weak opening for 抖音 / TikTok Shop / 视频号 / Reels.

日本語の概要は準備中です。原文の説明を表示しています。

xianyu110/ecommerce-video-skills662026年10月5日 更新

主图转视频:把一张或几张商品主图/白底图/场景图,写成可直接喂给图生视频模型的镜头提示词(运镜、主体动作、光线、时长、负面约束),并保证商品不变形。Use when the user has product images and wants a product video, 主图视频, 图生视频, image-to-video, animate a product photo, or 让主图动起来 — with any image-to-video model (Seedance / 可灵 Kling / Veo / Runway / Hailuo / Wan …) or a local Ken Burns fallback.

日本語の概要は準備中です。原文の説明を表示しています。

xianyu110/ecommerce-video-skills662026年10月5日 更新

直播切片:从电商直播录屏中找出高光片段(按时间戳 / 按字幕关键词 / 按停顿自动提议),批量导出 9:16 竖屏切片,自动模糊填充横屏画面、烧录标题与字幕、响度标准化,并给切片写标题与开头钩子。Use when the user has a livestream recording and wants 直播切片, 切片, highlights, clips, 高光片段, repurpose a live stream into short videos for 抖音 / 视频号 / TikTok.

日本語の概要は準備中です。原文の説明を表示しています。

xianyu110/ecommerce-video-skills662026年10月5日 更新

xianyu110 のスキルをすべて見る

このスキルの問題を報告する