anbeime/skill / skills/native-subtitle-quote-image/native-subtitle-quote-image
native-subtitle-quote-image
Verified将本地视频或用户有权处理的在线视频,经过来源获取、文字稿定位、选题选句、精确取帧、紧凑裁切、拼图和逐张质检,制作成 3:4 或保留画面原比例的视频字幕长图。支持两种明确分开的输出:保留画面内已烧录字幕的原生字幕模式,以及把已审核的时间点与台词绘制到真实视频帧上的脚本字幕模式。用户要求原生字幕截图、字幕帧拼图、YouTube 金句长图、台词截图、不重绘字幕、自定义中文台词,或调整主图比例、字幕区域、台词间隔和美感时使用。
scripts/check_environment.py
View on GitHub#!/usr/bin/env python3
"""检查视频字幕拼图的原生、脚本与 URL 模式所需组件,不执行安装。"""
import argparse
import importlib
import importlib.util
import json
import locale
import shutil
import subprocess
import sys
from pathlib import Path
CJK_FONT_CANDIDATES = [
"/System/Library/Fonts/PingFang.ttc",
"/System/Library/Fonts/STHeiti Medium.ttc",
"/System/Library/Fonts/Hiragino Sans GB.ttc",
"C:/Windows/Fonts/msyh.ttc",
"C:/Windows/Fonts/simhei.ttf",
"/System/Library/Fonts/AppleSDGothicNeo.ttc",
"C:/Windows/Fonts/malgun.ttf",
"/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc",
"/usr/share/fonts/opentype/noto/NotoSansCJKsc-Regular.otf",
"/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc",
]
def command_version(command, args=("--version",)):
path = shutil.which(command)
if not path:
return None, None
try:
proc = subprocess.run(
[path, *args],
capture_output=True,
encoding="utf-8",
errors="replace",
timeout=10,
check=False,
)
except (OSError, subprocess.SubprocessError):
return path, "无法读取版本"
output = (proc.stdout or proc.stderr or "").strip().splitlines()
return path, output[0] if output else "版本未知"
def module_version(name):
if importlib.util.find_spec(name) is None:
return None
module = importlib.import_module(name)
return getattr(module, "__version__", "已安装")
def add(rows, component, status, purpose, detail="", required="core"):
rows.append(
{
"component": component,
"status": status,
"purpose": purpose,
"detail": detail,
"required": required,
}
)
def utf8_default():
if sys.flags.utf8_mode:
return True
return locale.getpreferredencoding(False).lower().replace("-", "") == "utf8"
def inspect_environment():
rows = []
python_ok = sys.version_info >= (3, 10)
add(
rows,
"Python 3.10+",
"ok" if python_ok else "missing",
"运行 Skill 脚本",
sys.version.split()[0],
)
if not utf8_default():
add(
rows,
"UTF-8 encoding",
"optional",
"文本读写:默认编码非 UTF-8 时中文路径与输出可能乱码",
f"当前默认编码 {locale.getpreferredencoding(False)};"
"建议设置 PYTHONUTF8=1(cmd: set PYTHONUTF8=1)",
required="optional",
)
pillow = module_version("PIL")
add(
rows,
"Pillow",
"ok" if pillow else "missing",
"裁图、拼图、导出 JPG",
str(pillow or "未安装"),
)
ffmpeg_detail = ""
imageio = module_version("imageio_ffmpeg")
if imageio:
try:
imageio_module = importlib.import_module("imageio_ffmpeg")
ffmpeg_detail = f"imageio-ffmpeg {imageio}: {imageio_module.get_ffmpeg_exe()}"
except Exception as exc: # pragma: no cover - platform-specific failure
ffmpeg_detail = f"imageio-ffmpeg 已安装但不可用: {exc}"
imageio = None
system_ffmpeg, ffmpeg_version = command_version("ffmpeg", ("-version",))
ffmpeg_ok = bool(imageio or system_ffmpeg)
if system_ffmpeg:
system_detail = f"system: {system_ffmpeg} ({ffmpeg_version})"
ffmpeg_detail = f"{ffmpeg_detail}; {system_detail}" if ffmpeg_detail else system_detail
add(
rows,
"FFmpeg provider",
"ok" if ffmpeg_ok else "missing",
"读取视频并精确取帧",
ffmpeg_detail or "请安装 imageio-ffmpeg 或 FFmpeg 可执行文件",
)
cjk_font = next(
(candidate for candidate in CJK_FONT_CANDIDATES if Path(candidate).is_file()),
None,
)
add(
rows,
"CJK font",
"ok" if cjk_font else "missing",
"脚本字幕模式:绘制中文、日文或韩文台词",
cjk_font or "未找到常见 CJK 字体;可安装 Noto Sans CJK 或用 --font 指定",
required="script",
)
ytdlp_path, ytdlp_version = command_version("yt-dlp")
add(
rows,
"yt-dlp",
"ok" if ytdlp_path else "missing",
"URL 模式:读取元数据、字幕轨和下载视频",
f"{ytdlp_version} ({ytdlp_path})" if ytdlp_path else "本地视频模式不需要",
required="url",
)
runtimes = []
for label, command in (
("Deno", "deno"),
("Node.js", "node"),
("QuickJS", "qjs"),
("Bun (deprecated)", "bun"),
):
path, version = command_version(command)
if path:
runtimes.append((label, command, path, version))
if runtimes:
label, command, path, version = runtimes[0]
if command == "deno":
detail = f"{label} {version} ({path});yt-dlp 默认启用"
elif command == "bun":
detail = (
f"{label} {version} ({path});调用 yt-dlp 时添加 "
"--js-runtimes bun;官方已将 Bun 支持标记为弃用"
)
else:
detail = (
f"{label} {version} ({path});调用 yt-dlp 时添加 "
f"--js-runtimes {command}"
)
add(
rows,
"JavaScript runtime",
"ok",
"URL 模式:完整解析 YouTube",
detail,
required="url",
)
else:
add(
rows,
"JavaScript runtime",
"missing",
"URL 模式:完整解析 YouTube",
"推荐 Deno;也可使用 Node.js 或 QuickJS;Bun 支持已弃用",
required="url",
)
whisper_cli, whisper_version = command_version("whisper")
whisper_module = module_version("faster_whisper") or module_version("whisper")
whisper_ok = bool(whisper_cli or whisper_module)
whisper_detail = "未安装;只有来源没有可用时间轴时才需要"
if whisper_cli:
whisper_detail = f"CLI {whisper_version} ({whisper_cli})"
elif whisper_module:
whisper_detail = f"Python module {whisper_module}"
add(
rows,
"Whisper / speech-to-text",
"optional" if not whisper_ok else "ok",
"可选:没有字幕轨时生成带时间戳文字稿",
whisper_detail,
required="optional",
)
return rows
def is_blocking(row, url_mode, script_mode):
if row["status"] != "missing":
return False
return (
row["required"] == "core"
or (url_mode and row["required"] == "url")
or (script_mode and row["required"] == "script")
)
def print_human(rows, url_mode, script_mode):
labels = {"ok": "可用", "missing": "缺失", "optional": "可选"}
widths = (26, 8, 38)
print(f"{'组件':<{widths[0]}} {'状态':<{widths[1]}} 用途")
print("-" * 92)
for row in rows:
print(
f"{row['component']:<{widths[0]}} "
f"{labels[row['status']]:<{widths[1]}} "
f"{row['purpose']}"
)
if row["detail"]:
print(f" {row['detail']}")
blocking = [row for row in rows if is_blocking(row, url_mode, script_mode)]
source = "URL" if url_mode else "本地视频"
subtitle = "脚本字幕" if script_mode else "原生字幕"
mode = f"{source} + {subtitle}模式"
if blocking:
print(f"\n{mode}尚不可用,缺少: " + ", ".join(row["component"] for row in blocking))
else:
print(f"\n{mode}环境检查通过。")
if url_mode:
print(
"提示:若 YouTube 返回登录或机器人验证,不要退回本地模式;"
"先取得用户授权,再在该 URL 的 yt-dlp 命令中添加 "
"--cookies-from-browser chrome。"
)
def main():
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument(
"--url-mode",
action="store_true",
help="把 yt-dlp 和 JavaScript runtime 也作为必需组件检查",
)
parser.add_argument(
"--script-mode",
action="store_true",
help="把绘制中文台词所需的 CJK 字体也作为必需组件检查",
)
parser.add_argument("--json", action="store_true", help="输出机器可读 JSON")
args = parser.parse_args()
rows = inspect_environment()
blocking = [
row
for row in rows
if is_blocking(row, args.url_mode, args.script_mode)
]
if args.json:
print(
json.dumps(
{
"mode": "url" if args.url_mode else "local",
"script_mode": args.script_mode,
"ok": not blocking,
"components": rows,
},
ensure_ascii=False,
indent=2,
)
)
else:
print_human(rows, args.url_mode, args.script_mode)
raise SystemExit(1 if blocking else 0)
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |