抖音无水印视频下载与逐字稿提取

这是什么

ah-douyin-clean-downloader 是一个专为 Codex 设计的 AI Agent Skill。你只需把抖音的分享口令或官方链接发给 Codex，它就能自动下载平台提供的无抖音角标原视频，并按博主昵称自动归档到本地文件夹。此外，它还支持提取逐字稿：在本地用 Whisper 识别语音，生成校对后的 Markdown 逐字稿和逐段时间码 SRT 字幕文件。

这个 Skill 不依赖任何付费解析服务或语音识别 API，不调用视觉模型，也不保存 Cookie、账号或密钥，所有处理都在本地完成。

适合谁

内容创作者：需要整理自己或已授权视频素材，快速获取无水印原片。
自媒体运营者：希望把抖音视频转成文字稿，用于二次创作或文案参考。
视频研究者：需要批量下载视频并生成字幕，便于分析。
Codex 用户：熟悉 AI Agent 工作流，希望用自然语言指令完成视频处理。

能做什么

下载无水印视频：解析抖音分享口令或链接，获取平台提供的原始播放源，去除抖音分发阶段添加的角标。
自动归档：按博主昵称创建文件夹，视频自动归类，方便管理。
提取逐字稿：使用本地 Whisper 模型识别语音，生成 Markdown 格式的逐字稿和 SRT 字幕。
输出元数据：脚本成功时输出 JSON，包含媒体库路径、博主文件夹、视频绝对路径、大小、时长、编码和音视频流数量。

使用前准备

安装 Python 3.9 或更高版本。
安装 curl，用于访问分享页、元数据和视频源。
可选：安装 ffprobe 以验证视频时长、编码和音视频流。
如需逐字稿功能，还需安装 ffmpeg、mlx_whisper 和本地 Whisper 模型。
支持 macOS、Linux 或带 Python 和 curl 的 Windows 环境。

安装方法

你可以直接把以下安装指令原样发给 Codex：

安装这个 Skill：https://github.com/ahang008/ah-douyin-clean-downloader

或者使用标准安装命令：

python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
  --repo ahang008/ah-douyin-clean-downloader \
  --path . \
  --name ah-douyin-clean-downloader

如果不使用 skill-installer，也可以直接克隆到 Codex Skills 目录：

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
git clone --depth 1 https://github.com/ahang008/ah-douyin-clean-downloader.git \
  "${CODEX_HOME:-$HOME/.codex}/skills/ah-douyin-clean-downloader"

安装完成后，新开一轮 Codex 对话即可使用。建议先运行环境自检：

SKILL_DIR="${CODEX_HOME:-$HOME/.codex}/skills/ah-douyin-clean-downloader"
python3 "$SKILL_DIR/scripts/doctor.py" --format text

使用示例

安装完成后，直接把抖音分享口令发给 Codex，例如：

8.88 复制打开抖音，看看这个视频 https://v.douyin.com/xxxxx/

Codex 会自动下载视频并保存到默认目录：

~/Desktop/抖音无水印视频/<博主昵称>/抖音-<视频标题>-<作品ID>.mp4

如果需要逐字稿，在口令后说明“提取逐字稿”。最终目录只保留校对后的 .md 和 .srt 文件，不保留视频、音频、JSON 或机器识别稿。

你也可以在命令行直接使用脚本：

python3 scripts/download_douyin.py "<完整抖音分享口令或链接>"

指定媒体库根目录：

python3 scripts/download_douyin.py "<分享口令>" --output-dir "/absolute/path"

如果网络需要代理：

export AH_DOUYIN_PROXY="http://127.0.0.1:7890"
python3 scripts/download_douyin.py "<分享口令>"

只生成逐字稿：

python3 scripts/transcribe_douyin.py "<完整抖音分享口令或链接>"

风险与注意事项

版权与授权：仅用于你自有或已获授权的视频。使用者需自行遵守平台规则、著作权规则和所在地法律。
角标去除限制：只去除抖音分发阶段的平台角标，不能去除作者上传前已烧录的 Logo、字幕或贴片。
本地处理：逐字稿使用本地 Whisper 识别，过程视频和机器稿在成品验收后清理，保护隐私。
非开源许可：本项目为源码可见软件，允许个人学习、研究和非商业使用，未经书面授权不得用于商业用途。该许可证不属于 OSI 认可的开源许可证。
数据安全：不保存 Cookie、账号或密钥，降低泄露风险。