Skip to content
Back to search

video-transcript

视频与播客文字提取:下载音视频后调用夸克网盘 Skill 云端取稿,再由模型轻校对。 支持单条和批次、已上传网盘文件、持久对应关系与中断恢复。用于“逐字稿、转文字、提取文案” 或附音视频链接的提取请求。默认不运行本地 ASR;不承诺说话人分离、句级时间轴或 SRT。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/backtthefuture--video-transcript/badge.svg)](/listings/backtthefuture--video-transcript)

HTML

<a href="/listings/backtthefuture--video-transcript"><img src="/api/listings/backtthefuture--video-transcript/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

支持 Python 3.9+ 的 macOS。需要 Node.js、ffmpeg/ffprobe、配套 video-download Skill,以及**另行安装并授权的夸克网盘官方 Skill(quarkclouddrive)**。本仓库不包含夸克 CLI、账号凭据或媒体文件。请从你使用的 Agent/Skill 平台安装 quarkclouddrive,并按其 SKILL.md 完成安装和登录。

将本 Skill 装进全局 skills 目录。例如 Codex:

VIDEO_TRANSCRIPT_TARGET="$HOME/.codex/skills/video-transcript" \ bash <(curl -fsSL https://raw.githubusercontent.com/Backtthefuture/video-transcript/main/bootstrap.sh)

默认目标是 ~/.claude/skills/video-transcript。bootstrap 只同步本仓库文件并执行本地依赖检查;已有 .env、outputs 和个人词表会保留。若需要下载依赖,在安装目录运行:

bash ~/.codex/skills/video-transcript/install.sh python3 ~/.codex/skills/video-transcript/scripts/transcript.py --doctor

install.sh 可安装 video-download、yt-dlp 和 Playwright/Chromium;需要预先准备 Python、Node.js、ffmpeg/ffprobe。夸克 Skill 仍需单独安装与授权。--doctor 只检查工具和依赖位置,**不代表云端授权或取稿链路成功**。

如果已有其他安装根,可分别设置 VT_PY、VIDEO_DOWNLOAD_HOME、QUARK_SKILL_HOME;运行时始终以当前 SKILL.md 所在目录为 VT_HOME。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 97 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ---
  2. name: video-transcript
  3. description: >
  4. 视频与播客文字提取:下载音视频后调用夸克网盘 Skill 云端取稿,再由模型轻校对。
  5. 支持单条和批次、已上传网盘文件、持久对应关系与中断恢复。用于“逐字稿、转文字、提取文案”
  6. 或附音视频链接的提取请求。默认不运行本地 ASR;不承诺说话人分离、句级时间轴或 SRT。
  7. metadata:
  8. display-name: 视频文案提取
  9. ---
  10. # 视频文案提取:夸克云端版
  11. 链接 / 本地媒体 / 已指定的网盘文件 → 登记 → 下载或匹配 → 上传并核对 → 单文件问答取正文 → 质量检查 → 模型 patch 轻校对。
  12. ## 入口与依赖
  13. 使用**本次读取的这份 SKILL.md 所在目录**作为 `VT_HOME`。不要按 WorkBuddy/Codex 等优先级另找一份 video-transcript;不能把其他副本当成这份的运行目录。
  14. `VT_PY` 使用可运行脚本的 Python 3.9+,不必寻找装有 FunASR 的解释器。
  15. 首次执行先读已安装 `quarkclouddrive/SKILL.md` 及本次涉及的 `references/file-upload.md`、`references/file-search.md`、`references/assistant.md`。
  16. 下载沿用 video-download;平台解析所需登录态仍按该 Skill 处理。夸克 CLI 是外部依赖,不复制其源码或凭据。本脚本会在每次调用夸克命令前运行官方环境检查,并使用同一批次会话 ID。
  17. ```bash
  18. python3 "$VT_HOME/scripts/transcript.py" --doctor
  19. ```
  20. 该体检只检查本地工具与依赖位置,不代表授权或云端链路成功。缺少夸克 Skill 时按其安装说明安装;不要运行旧版 ASR 安装步骤。需要安装下载依赖才运行本 Skill 的 install.sh;已有 .env、outputs 和模型缓存保留。
  21. ## 单条与批次
  22. 用户明确选择此 Skill 的云端工作流,即按任务范围上传指定媒体。用户要求只下载时转交 video-download。
  23. 保存用户本轮原始请求为临时 UTF-8 文件,通过 `--session-input-file` 传入;这是夸克要求的服务质量追踪参数,不应塞入额外对话或凭据。
  24. ```bash
  25. python3 "$VT_HOME/scripts/transcript.py" "<链接或本地路径>" --session-input-file "<原始请求文件>" --wait 1800
  26. python3 "$VT_HOME/scripts/transcript.py" --batch "<inputs.json>" --session-input-file "<原始请求文件>" --wait 1800
  27. ```
  28. 等待值是本次进程的复查预算,不是预计完成时间;单次网络请求可能在预算结束后才返回。
  29. 批次 JSON 是输入字符串数组,或包含 `input`、可选 `title` 的对象数组。
  30. 截图 PDF 保留 `--keep-video` 兼容参数;新版媒体默认持久保存,不自动删本地文件或云端文件。
  31. 已上传网盘文件的选定、参数、缓存与错误恢复见 [references/quark-workflow.md](references/quark-workflow.md)。
  32. ## 状态和中断恢复
  33. 每条文件有固定 asset_id;所有批次复用同一 output-dir 内的条目记录。通过来源链接或本地内容 SHA256 识别任务,不靠标题和完成顺序关联。
  34. 上传原始 ID 与搜索返回 FID 分开存。读取完整 Artifact,并按唯一文件名、大小及上传时间(时长返回时另核对)绑定;匹配不唯一就停该条。
  35. 一条问答只传一个文件,原始响应与每次请求单独留档。上传结果未知不盲目重传。
  36. - `text_received`:取回了可供审阅的正文,**不是逐字准确或全文已验证**。
  37. - `waiting_analysis`:保持 FID,按 next_poll_at 复查,初期 60 秒,随后 120/300 秒。
  38. - `response_needs_review`:疑似摘要、缺来源、过短或不完整。读 raw.md,不直接润色成“完整稿”。
  39. - `mapping_needs_review` / `upload_outcome_unknown`:核对对应关系,不猜、不重新上传。
  40. - `auth_required`:按夸克 Skill 引导 login,完成后用原批次明确重试。
  41. - `qa_failed` / `failed`:说明原因,修复后恢复,不自动无限重试。
  42. ```bash
  43. python3 "$VT_HOME/scripts/transcript.py" --resume "<batch_manifest>" --status
  44. python3 "$VT_HOME/scripts/transcript.py" --resume "<batch_manifest>" --session-input-file "<原始请求文件>" --wait 1800
  45. ```
  46. 退出码 0=本次各条已取回正文;2=仍有等待;1=需要处理错误或人工核对。退出码不代表质量验收。
  47. 任务终止后没有自动唤醒;只在用户请求后台监测时另接调度。不能用“已保存等待状态”冒充会自动继续。
  48. ## 取稿后:模型必须检查并轻校对
  49. 输出包含 batch_manifest、各条状态,以及可用的 transcript_path、preorganized_path、polish_brief_path。
  50. 先读**完整原始返回与预整理稿**,核对来源是否对应、是否摘要/拒绝/明显截断,条件允许时抽查首中尾字幕或听校。字数和首尾覆盖只能作为抽查,不能证明逐句完整。
  51. 普通视频:读 polish_brief,写一份 patch.json,再调用:
  52. ```bash
  53. python3 "$VT_HOME/scripts/make_optimized.py" --from-md "<preorganized_path>" --patch "<patch.json>" --filename "<asset_id>_整理稿" --output-dir "<该条产物目录>"
  54. ```
  55. patch 使用 title、headings、fixes(from/to/confidence/basis)和必要的 paragraph_edits。保留顺序、数字、观点;高确信且有依据才替换,低确信只列待核。不要补写缺段、推测说话人或编造时间轴。渲染器支持无时间标记的章节,并保留补丁记录。
  56. 修改后回读,核对没有整段丢失。保留夸克原始返回,润色稿独立交付。单条用户要求全文时在对话输出全文;批次优先交付汇总表与每条稿件链接,避免四份长稿互相混杂。
  57. 微信视频号:读 [skills/weixin-layout.md](skills/weixin-layout.md),保留默认口语稿、文字 PDF、截图 PDF 的分流。无时间轴时截图与正文需实际核对,不得按虚构时间自动配图。
  58. 播客:同样先取纯文字,再轻校对。旧 --speakers/--host/--guest 明确报不支持,不转本地模型、不伪造人物归属。
  59. ## 交付边界
  60. 分别报告:文件对应、正文取回、抽查或听校程度、润色完成。历史专名、古文和无字幕材料要保留待核点。
  61. --force 只重新请求正文,复用原上传;--reformat 只从已保存原文重建预整理。不自动读取旧 FunASR 缓存,旧文件不删除。
  62. ## 上游 Skill 的稳定接入
  63. 供 deep-search、视频博主拆解使用的适配器为 `scripts/caller_client.py`,不复制夸克运行时。先通过 `--batch ... --status` 本地登记,再持久保存 asset_id/manifest 后开始云端请求;适配器按完整 stdout JSON 和条目 state.json 读取结果,`schema_version=1`。
  64. 同一调用方工作目录保存 session.json;`--session-id` 可在新批次登记时指定 `{timestamp}-{6位随机字符}`,已有批次继续使用原值。所有实际云端调用仍传原始请求文件。
  65. 适配器保留 waiting_analysis、response_needs_review、mapping_needs_review、upload_outcome_unknown、auth_required 等状态。无音轨标 no_audio,媒体保留且不上传/问答;缺衍生稿可本地重建。取帧只接受记录中且 SHA256 相符的媒体,未核对的目录文件不能作为替代。
  66. 调用方显式使用 `--repair-media` 时,适配器仅补下载缺失媒体,要求与原哈希一致;不重新上传或问答。字节不同保留候选并停下核对。没有可核对的原链接或哈希时不能自动修复。
README.md · README · 56 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # video-transcript|视频文案提取
  2. 给视频、播客链接或本地媒体,获取可审阅的文字稿。本版使用夸克网盘官方 Skill 的文件问答能力取稿,再由 Agent 检查原文并做有依据的轻校对。
  3. **准确性边界:**云端返回正文不等于逐字准确或全文完整。没有逐句听校时,应标明完整性与准确率未验证。本版不运行本地 FunASR,不提供自动说话人分离、句级时间轴或 SRT。
  4. ## 工作流程
  5. 1. 登记单条或批次输入,为每个文件建立固定 asset_id。
  6. 2. 链接由 [video-download](https://github.com/Backtthefuture/video-download) 下载;本地文件按 SHA256 核对;已在夸克的文件可凭完整 FID 直接选定。
  7. 3. 新媒体上传夸克后,通过完整搜索结果核对文件名、大小和上传时间,唯一匹配才继续。
  8. 4. 每个 FID 单独请求正文。原始回答、尝试记录和状态都持久保存;分析未完成时按记录时间恢复。
  9. 5. 检查正文是否过短、缺来源或只是摘要。合格后生成预整理稿;Agent 再用 patch 轻校对,保留原文。
  10. 完整的 Agent 操作约定见 [SKILL.md](SKILL.md),批次、状态和恢复说明见 [quark-workflow.md](references/quark-workflow.md)。
  11. ## 安装
  12. 支持 Python 3.9+ 的 macOS。需要 Node.js、ffmpeg/ffprobe、配套 video-download Skill,以及**另行安装并授权的夸克网盘官方 Skill(quarkclouddrive)**。本仓库不包含夸克 CLI、账号凭据或媒体文件。请从你使用的 Agent/Skill 平台安装 quarkclouddrive,并按其 SKILL.md 完成安装和登录。
  13. 将本 Skill 装进全局 skills 目录。例如 Codex:
  14. VIDEO_TRANSCRIPT_TARGET="$HOME/.codex/skills/video-transcript" \
  15. bash <(curl -fsSL https://raw.githubusercontent.com/Backtthefuture/video-transcript/main/bootstrap.sh)
  16. 默认目标是 ~/.claude/skills/video-transcript。bootstrap 只同步本仓库文件并执行本地依赖检查;已有 .env、outputs 和个人词表会保留。若需要下载依赖,在安装目录运行:
  17. bash ~/.codex/skills/video-transcript/install.sh
  18. python3 ~/.codex/skills/video-transcript/scripts/transcript.py --doctor
  19. install.sh 可安装 video-download、yt-dlp 和 Playwright/Chromium;需要预先准备 Python、Node.js、ffmpeg/ffprobe。夸克 Skill 仍需单独安装与授权。--doctor 只检查工具和依赖位置,**不代表云端授权或取稿链路成功**。
  20. 如果已有其他安装根,可分别设置 VT_PY、VIDEO_DOWNLOAD_HOME、QUARK_SKILL_HOME;运行时始终以当前 SKILL.md 所在目录为 VT_HOME。
  21. ## 使用与恢复
  22. Agent 应将用户本轮原始请求写成临时 UTF-8 文件,并传入 --session-input-file。单条示例:
  23. python3 ~/.codex/skills/video-transcript/scripts/transcript.py \
  24. "/path/to/video.mp4" --session-input-file "/path/to/request.txt" --wait 1800
  25. 批次使用 --batch inputs.json。程序返回 batch_manifest 后,可以查看状态或续跑:
  26. python3 ~/.codex/skills/video-transcript/scripts/transcript.py \
  27. --resume "/path/to/manifest.json" --status
  28. python3 ~/.codex/skills/video-transcript/scripts/transcript.py \
  29. --resume "/path/to/manifest.json" \
  30. --session-input-file "/path/to/request.txt" --wait 1800
  31. --wait 是本次进程的复查预算,不是云端预计完成时间。程序结束后不会自动唤醒。text_received 仅表示正文取回;response_needs_review、mapping_needs_review、upload_outcome_unknown 和 auth_required 都需要按 [恢复说明](references/quark-workflow.md) 处理。
  32. ## 隐私与旧版
  33. 所选媒体会上传至用户授权的夸克网盘;原始回答和状态保存在本机 outputs。程序不自动删除本地或云端文件。本仓库忽略 .env 和 outputs,不应把账号配置、Cookie、私人媒体或逐字稿提交到 GitHub。
  34. 此前的本地 FunASR 版说明保留在 [历史 README](docs/legacy-README.md)。旧脚本留在 Git 历史与仓库中供已有用户参考,不是当前 SKILL.md 的运行入口。
bootstrap.sh · Bundled script · 135 lines · 1 finding marked
  1. #!/usr/bin/env bash
  2. # video-transcript skill 一行命令安装入口
  3. #
  4. # 用法:
  5. # bash <(curl -fsSL https://raw.githubusercontent.com/Backtthefuture/video-transcript/main/bootstrap.sh)
    • Note: Runs a downloaded script through process substitution (bash <(curl …))
    • Line 5 on GitHub
  6. #
  7. # 流程: 拉取云端版 Skill → 检查本地依赖;夸克网盘 Skill 与授权单独安装
  8. #
  9. # 拉取顺序: git clone 暂存 → GitHub tarball;更新时保留本机配置和产物
  10. set -euo pipefail
  11. REPO="Backtthefuture/video-transcript"
  12. SKILL="video-transcript"
  13. TARGET="${VIDEO_TRANSCRIPT_TARGET:-$HOME/.claude/skills/$SKILL}"
  14. C_BOLD='\033[1m'; C_GREEN='\033[32m'; C_YELLOW='\033[33m'; C_RED='\033[31m'; C_BLUE='\033[34m'; C_GRAY='\033[90m'; C_RESET='\033[0m'
  15. say() { printf "${C_BLUE}▸${C_RESET} %s\n" "$1"; }
  16. ok() { printf " ${C_GREEN}✓${C_RESET} %s\n" "$1"; }
  17. warn() { printf " ${C_YELLOW}⚠${C_RESET} %s\n" "$1"; }
  18. err() { printf " ${C_RED}✗${C_RESET} %s\n" "$1"; }
  19. bar() { printf "${C_GRAY}═══════════════════════════════════════════════════════${C_RESET}\n"; }
  20. # ── Codex 集成:检测到 ~/.codex/ 就注册 /video-transcript ──
  21. register_codex() {
  22. local codex_home="${CODEX_HOME:-$HOME/.codex}"
  23. if [ ! -d "$codex_home" ]; then
  24. printf " ${C_GRAY}ℹ${C_RESET} 未检测到 ~/.codex/,跳过 Codex 集成(只 Claude Code 可用)\n"
  25. return 0
  26. fi
  27. mkdir -p "$codex_home/prompts"
  28. cat > "$codex_home/prompts/video-transcript.md" <<PROMPT_EOF
  29. Use the video-transcript skill at:
  30. $TARGET/SKILL.md
  31. Read that SKILL.md before acting and follow its current platform routing,
  32. privacy boundaries, error handling, and output contract. Do not reproduce an
  33. older workflow from this prompt. The user's request is:
  34. \$ARGUMENTS
  35. PROMPT_EOF
  36. ok "已注册 Codex 命令 → $codex_home/prompts/video-transcript.md"
  37. printf " ${C_GRAY} 在 Codex 里可用 /video-transcript <URL> 触发${C_RESET}\n"
  38. }
  39. bar
  40. printf "${C_BOLD} 🎬 video-transcript skill 安装引导${C_RESET}\n"
  41. bar
  42. echo ""
  43. case "$TARGET" in
  44. ""|/|"$HOME"|"$HOME/")
  45. err "拒绝使用过宽的安装目标: $TARGET"
  46. exit 1
  47. ;;
  48. /*/video-transcript)
  49. ;;
  50. *)
  51. err "安装目标必须是以 /video-transcript 结尾的绝对路径: $TARGET"
  52. exit 1
  53. ;;
  54. esac
  55. TARGET_PARENT=$(dirname "$TARGET")
  56. mkdir -p "$TARGET_PARENT"
  57. STAGE_ROOT=$(mktemp -d)
  58. STAGE_TARGET="$STAGE_ROOT/video-transcript"
  59. cleanup_stage(){ rm -rf "$STAGE_ROOT"; }
  60. trap cleanup_stage EXIT
  61. fetched=""
  62. if command -v git >/dev/null 2>&1; then
  63. say "暂存拉取 GitHub main..."
  64. if git clone --depth=1 "https://github.com/$REPO.git" "$STAGE_TARGET" 2>&1; then
  65. fetched="git"
  66. fi
  67. fi
  68. if [ -z "$fetched" ]; then
  69. say "git 不可用或拉取失败,改用 GitHub tarball..."
  70. if curl -fsSL "https://github.com/$REPO/archive/refs/heads/main.tar.gz" | tar xz -C "$STAGE_ROOT" 2>&1; then
  71. SKILL_FILE=$(find "$STAGE_ROOT" -maxdepth 2 -type f -name SKILL.md -print -quit)
  72. SUBDIR="${SKILL_FILE:+$(dirname "$SKILL_FILE")}"
  73. if [ -n "$SUBDIR" ] && [ -d "$SUBDIR" ]; then
  74. STAGE_TARGET="$SUBDIR"
  75. fetched="tarball"
  76. fi
  77. fi
  78. fi
  79. if [ -z "$fetched" ] || [ ! -f "$STAGE_TARGET/SKILL.md" ]; then
  80. err "GitHub main 拉取失败!"
  81. err "请手动 git clone 后跑: bash <skill-dir>/install.sh"
  82. err " git clone https://github.com/$REPO ~/Downloads/video-transcript"
  83. err " bash ~/Downloads/video-transcript/install.sh"
  84. exit 1
  85. fi
  86. if ! command -v rsync >/dev/null 2>&1; then
  87. err "缺少 rsync,无法安全保留已有 .env 与 outputs/"
  88. exit 1
  89. fi
  90. if [ -d "$TARGET" ]; then
  91. say "检测到已有安装,更新程序文件并保留 .env、outputs 和本地词表..."
  92. else
  93. say "安装到 $TARGET ..."
  94. mkdir -p "$TARGET"
  95. fi
  96. rsync -a \
  97. --exclude='.git/' \
  98. --exclude='.env' \
  99. --exclude='.env.local' \
  100. --exclude='outputs/' \
  101. --exclude='__pycache__/' \
  102. --exclude='.podcast_glossary.json' \
  103. "$STAGE_TARGET/" "$TARGET/"
  104. ok "程序文件已同步到 $TARGET"
  105. echo ""
  106. say "检查云端版 Skill 的本地依赖..."
  107. echo ""
  108. if command -v python3 >/dev/null 2>&1; then
  109. if ! python3 "$TARGET/scripts/transcript.py" --doctor; then
  110. warn "仍有依赖未就绪。请阅读 $TARGET/README.md 并按需运行 bash $TARGET/install.sh"
  111. fi
  112. else
  113. warn "未找到 Python 3.9+。请先安装,再运行 Skill 的 --doctor。"
  114. fi
  115. echo ""
  116. register_codex
  117. ok "Skill 文件已安装。云端授权与实际取稿需在目标机器上另行验证。"

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.