Skip to content

anbeime/skill / skills/native-subtitle-quote-image/native-subtitle-quote-image

native-subtitle-quote-image

Verified

将本地视频或用户有权处理的在线视频,经过来源获取、文字稿定位、选题选句、精确取帧、紧凑裁切、拼图和逐张质检,制作成 3:4 或保留画面原比例的视频字幕长图。支持两种明确分开的输出:保留画面内已烧录字幕的原生字幕模式,以及把已审核的时间点与台词绘制到真实视频帧上的脚本字幕模式。用户要求原生字幕截图、字幕帧拼图、YouTube 金句长图、台词截图、不重绘字幕、自定义中文台词,或调整主图比例、字幕区域、台词间隔和美感时使用。

FileKindSize
.codex-plugin/plugin.jsonconfig1.5 KB
.github/ISSUE_TEMPLATE/bug_report.ymlconfig1.2 KB
.github/ISSUE_TEMPLATE/config.ymlconfig275 B
.github/ISSUE_TEMPLATE/feature_request.ymlconfig827 B
.github/agent/implement.mdmarkdown1.7 KB
.github/agent/review.mdmarkdown1.1 KB
.github/agent/triage.mdmarkdown2.7 KB
.github/labels.jsonconfig2.5 KB
.github/pull_request_template.mdmarkdown432 B
.github/release.ymlconfig345 B
.github/scripts/apply_triage.pyscript6.6 KB
.github/scripts/dump_issue.shscript509 B
.github/scripts/intake_feedback.pyscript4.0 KB
.github/scripts/open_agent_pr.shscript3.7 KB
.github/workflows/agent-implement.ymlconfig4.4 KB
.github/workflows/agent-review.ymlconfig2.8 KB
.github/workflows/agent-triage.ymlconfig4.6 KB
.github/workflows/claude.ymlconfig2.9 KB
.github/workflows/feedback-intake.ymlconfig2.0 KB
.github/workflows/release-label.ymlconfig1.2 KB
.github/workflows/release.ymlconfig3.5 KB
.github/workflows/sync-labels.ymlconfig798 B
.github/workflows/validate.ymlconfig1.3 KB
.gitignoreother169 B
CLAUDE.mdmarkdown1.6 KB
LICENSEother1.0 KB
README.mdmarkdown31.5 KB
README_EN.mdmarkdown33.9 KB
README_KO.mdmarkdown37.0 KB
SKILL.mdskill md22.4 KB
VERSIONother7 B
agents/openai.yamlconfig467 B
assets/banner-en.jpgbinary417.7 KB
assets/banner-ko.jpgbinary417.9 KB
assets/banner-zh.jpgbinary434.0 KB
assets/native-subtitle-quote-image-icon.pngbinary275.1 KB
docs/agent-workflow.mdmarkdown8.2 KB
examples/README.mdmarkdown6.0 KB
examples/gallery-manifest.jsonconfig7.6 KB
examples/gallery/en/darby-saxbe-shared-care.jpgbinary313.5 KB
examples/gallery/en/mikayla-johnson-define-outcome.jpgbinary294.4 KB
examples/gallery/en/rick-rubin-be-yourself.jpgbinary355.4 KB
examples/gallery/ko/codie-sanchez-321-speaking.jpgbinary331.9 KB
examples/gallery/ko/inaya-mcmillan-money-program.jpgbinary391.2 KB
examples/gallery/ko/masud-husain-starting-hill.jpgbinary266.2 KB
examples/gallery/zh/chen-shu-simple-life.jpgbinary328.2 KB
examples/gallery/zh/girls-on-the-bus-native.jpgbinary163.5 KB
examples/gallery/zh/rick-rubin-creative-clouds.jpgbinary339.9 KB
examples/scripts/en/darby-saxbe-shared-care.jsonconfig436 B
examples/scripts/en/mikayla-johnson-define-outcome.jsonconfig419 B
examples/scripts/en/rick-rubin-be-yourself.jsonconfig426 B
examples/scripts/ko/codie-sanchez-321-speaking.jsonconfig462 B
examples/scripts/ko/inaya-mcmillan-money-program.jsonconfig491 B
examples/scripts/ko/masud-husain-starting-hill.jsonconfig496 B
examples/scripts/zh/chen-shu-simple-life.jsonconfig747 B
examples/scripts/zh/girls-on-the-bus-native.jsonconfig1.0 KB
examples/scripts/zh/rick-rubin-creative-clouds.jsonconfig404 B
references/end-to-end-workflow.mdmarkdown17.2 KB
references/troubleshooting.mdmarkdown5.7 KB
references/visual-style.mdmarkdown10.2 KB
references/yt-dlp-and-transcripts.mdmarkdown14.0 KB
requirements.txtmanifest33 B
scripts/bump_version.pyscript2.7 KB
scripts/check_environment.pyscript8.9 KB
scripts/check_update.pyscript8.0 KB
scripts/native_subtitle_stitch.pyscript59.1 KB
scripts/render_banners.pyscript7.4 KB
scripts/submit_feedback.pyscript2.6 KB
scripts/validate_repo.pyscript9.0 KB
tests/test_agent_workflow.pyscript8.9 KB
tests/test_check_update.pyscript5.0 KB
tests/test_native_subtitle_stitch.pyscript63.2 KB
tests/test_render_banners.pyscript2.6 KB
tests/test_text_encoding.pyscript3.2 KB

scripts/check_update.py

View on GitHub
#!/usr/bin/env python3
"""Check GitHub Releases for a newer Skill version without auto-updating."""

import argparse
import json
import os
import platform
import re
import subprocess
import urllib.error
import urllib.request
from datetime import datetime, timedelta, timezone
from pathlib import Path


REPOSITORY = "chengyi-ai/native-subtitle-quote-image"
LATEST_API = f"https://api.github.com/repos/{REPOSITORY}/releases/latest"
RELEASES_URL = f"https://github.com/{REPOSITORY}/releases"
CACHE_TTL = timedelta(hours=24)
VERSION_FILE = Path(__file__).resolve().parents[1] / "VERSION"


def parse_version(value):
    match = re.fullmatch(r"\s*v?(\d+)\.(\d+)\.(\d+)(?:[-+][0-9A-Za-z.-]+)?\s*", value)
    if not match:
        raise ValueError(f"无法识别版本号: {value!r}")
    return tuple(int(part) for part in match.groups())


def normalize_version(value):
    return ".".join(str(part) for part in parse_version(value))


def read_current_version():
    return normalize_version(VERSION_FILE.read_text(encoding="utf-8"))


def default_cache_path():
    override = os.environ.get("NATIVE_SUBTITLE_UPDATE_CACHE")
    if override:
        return Path(override).expanduser()

    system = platform.system()
    if system == "Darwin":
        root = Path.home() / "Library" / "Caches"
    elif system == "Windows":
        root = Path(os.environ.get("LOCALAPPDATA", Path.home() / "AppData" / "Local"))
    else:
        root = Path(os.environ.get("XDG_CACHE_HOME", Path.home() / ".cache"))
    return root / "native-subtitle-quote-image" / "update-check.json"


def utc_now():
    return datetime.now(timezone.utc)


def format_timestamp(value):
    return value.astimezone(timezone.utc).isoformat().replace("+00:00", "Z")


def parse_timestamp(value):
    return datetime.fromisoformat(value.replace("Z", "+00:00")).astimezone(timezone.utc)


def read_cache(path):
    try:
        payload = json.loads(path.read_text(encoding="utf-8"))
        latest_version = normalize_version(payload["latest_version"])
        checked_at = parse_timestamp(payload["checked_at"])
        release_url = payload.get("release_url") or RELEASES_URL
    except (OSError, KeyError, TypeError, ValueError, json.JSONDecodeError):
        return None
    return {
        "latest_version": latest_version,
        "release_url": release_url,
        "checked_at": checked_at,
    }


def cache_is_fresh(cache, now):
    if not cache:
        return False
    age = now - cache["checked_at"]
    return timedelta(0) <= age < CACHE_TTL


def write_cache(path, payload):
    path.parent.mkdir(parents=True, exist_ok=True)
    temporary = path.with_name(f".{path.name}.tmp")
    temporary.write_text(
        json.dumps(payload, ensure_ascii=False, indent=2) + "\n",
        encoding="utf-8",
    )
    temporary.replace(path)


def release_from_payload(payload):
    latest_version = normalize_version(payload["tag_name"])
    return {
        "latest_version": latest_version,
        "release_url": payload.get("html_url") or RELEASES_URL,
    }


def fetch_latest_release(timeout=4):
    request = urllib.request.Request(
        LATEST_API,
        headers={
            "Accept": "application/vnd.github+json",
            "User-Agent": "native-subtitle-quote-image-update-check",
        },
    )
    try:
        with urllib.request.urlopen(request, timeout=timeout) as response:
            return release_from_payload(json.load(response))
    except (OSError, urllib.error.URLError) as urllib_error:
        # Python.org builds on macOS can lack a configured CA bundle. Use the
        # operating system's curl as a verified-HTTPS fallback; never disable TLS.
        try:
            proc = subprocess.run(
                [
                    "curl",
                    "-fsSL",
                    "--connect-timeout",
                    str(timeout),
                    "--max-time",
                    str(timeout),
                    "-H",
                    "Accept: application/vnd.github+json",
                    "-A",
                    "native-subtitle-quote-image-update-check",
                    LATEST_API,
                ],
                capture_output=True,
                encoding="utf-8",
                errors="replace",
                check=False,
                timeout=timeout + 1,
            )
        except (OSError, subprocess.SubprocessError) as curl_error:
            raise OSError(
                f"Python HTTPS 失败: {urllib_error}; curl 回退失败: {curl_error}"
            ) from curl_error
        if proc.returncode != 0:
            detail = proc.stderr.strip() or f"退出码 {proc.returncode}"
            raise OSError(
                f"Python HTTPS 失败: {urllib_error}; curl 回退失败: {detail}"
            )
        return release_from_payload(json.loads(proc.stdout))


def check_for_update(force=False, now=None, cache_path=None, fetcher=None):
    now = now or utc_now()
    cache_path = cache_path or default_cache_path()
    fetcher = fetcher or fetch_latest_release
    current_version = read_current_version()
    cache = read_cache(cache_path)
    error = None

    if cache_is_fresh(cache, now) and not force:
        release = cache
        from_cache = True
    else:
        try:
            release = fetcher()
            release = {
                "latest_version": normalize_version(release["latest_version"]),
                "release_url": release.get("release_url") or RELEASES_URL,
                "checked_at": now,
            }
            from_cache = False
            try:
                write_cache(
                    cache_path,
                    {
                        "checked_at": format_timestamp(now),
                        "latest_version": release["latest_version"],
                        "release_url": release["release_url"],
                    },
                )
            except OSError as exc:
                error = f"无法写入更新缓存: {exc}"
        except (OSError, KeyError, TypeError, ValueError, json.JSONDecodeError, urllib.error.URLError) as exc:
            error = f"无法检查更新: {exc}"
            if cache:
                release = cache
                from_cache = True
            else:
                return {
                    "status": "unavailable",
                    "current_version": current_version,
                    "latest_version": None,
                    "release_url": RELEASES_URL,
                    "checked_at": None,
                    "from_cache": False,
                    "error": error,
                }

    latest_version = release["latest_version"]
    status = (
        "update_available"
        if parse_version(latest_version) > parse_version(current_version)
        else "up_to_date"
    )
    return {
        "status": status,
        "current_version": current_version,
        "latest_version": latest_version,
        "release_url": release.get("release_url") or RELEASES_URL,
        "checked_at": format_timestamp(release["checked_at"]),
        "from_cache": from_cache,
        "error": error,
    }


def main():
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("--force", action="store_true", help="忽略 24 小时缓存并立即检查")
    parser.add_argument("--json", action="store_true", help="输出机器可读 JSON")
    parser.add_argument("--verbose", action="store_true", help="没有更新或检查失败时也显示状态")
    args = parser.parse_args()

    result = check_for_update(force=args.force)
    if args.json:
        print(json.dumps(result, ensure_ascii=False, indent=2))
    elif result["status"] == "update_available":
        print(
            f"发现 Skill 新版本 v{result['latest_version']} "
            f"(当前 v{result['current_version']}):{result['release_url']}"
        )
    elif args.verbose and result["status"] == "up_to_date":
        print(f"当前已是最新版 v{result['current_version']}。")
    elif args.verbose:
        print(result["error"] or "暂时无法检查更新。")

    # 更新检查永远不阻断主要任务。
    return 0


if __name__ == "__main__":
    raise SystemExit(main())
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall