对于完整资源包（视频 + 音频 + 字幕 + 文本转录）：

/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py "URL" --full

对于完整资源包 + AI 摘要准备：

/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py "URL" --summary

--full 标志会创建一个文件夹 ~/Downloads/<视频标题>/，其中包含：

• video.mp4 — 原始视频
• audio.mp3 — 提取的音频
• subtitle.vtt — WebVTT 字幕（通过 3 层策略获取）
• transcript.txt — 纯文本转录

--summary 标志隐含了 --full，并额外保存 .meta.json 用于 AI 摘要生成。

步骤 4：字幕获取（自动 — 3 层策略）

脚本按顺序自动尝试以下策略：

1. 手动字幕 — yt-dlp --write-subs --sub-lang zh,en,zh-Hans,zh-CN
2. 自动生成字幕 — yt-dlp --write-auto-subs
3. Whisper 本地转录 — 回退到使用 faster-whisper 的 parallel_transcribe.py

步骤 5：生成文本转录（自动）

脚本自动从 VTT 文件中去除时间戳，生成 transcript.txt。

步骤 6：AI 摘要（Claude 生成 summary.md）

如果用户请求摘要（通过 --summary 标志或要求“总结”）：

1. 读取转录文件：

   ~/Downloads/<视频标题>/transcript.txt

2. 读取元数据文件：

   ~/Downloads/<视频标题>/.meta.json

3. 读取摘要提示模板：

   reference/summary-prompt.md

4. 用实际值替换模板占位符：

   • {{TITLE}} — 来自 .meta.json
   • {{URL}} — 来自 .meta.json
   • {{DURATION}} — 来自 .meta.json
   • {{PLATFORM}} — "Xiaohongshu (小红书)"
   • {{TRANSCRIPT}} — transcript.txt 的内容

5. 按照模板结构生成摘要。

6. 将结果保存到：

   ~/Downloads/<视频标题>/summary.md

选项参考

输出结构

基本模式（默认）

~/Downloads/
└── <标题> [<id>].mp4

完整资源包模式 (--full 或 --summary)

~/Downloads/<视频标题>/
├── video.mp4          # 原始视频
├── audio.mp3          # 提取的音频
├── subtitle.vtt       # WebVTT 字幕
├── transcript.txt     # 纯文本转录
├── .meta.json         # 视频元数据（仅 --summary 模式）
└── summary.md         # AI 生成的摘要（仅 --summary 模式，由 Claude 写入）

支持的 URL 格式

故障排除

重要说明

• 为获得最佳效果，请始终使用完整的分享 URL（包含 xsec_token）
• 下载前请先在浏览器中登录 xiaohongshu.com
• 最高视频质量通常为 1080p（平台限制）
• Whisper 转录需要 uv 进行自动依赖管理，或手动安装 faster-whisper
• 请尊重版权和小红书的服务条款

每周安装量

58

代码仓库

smile7up/xiaoho…wnloader

GitHub 星标数

11

首次出现

2026年3月2日

安全审计

Gen Agent Trust HubPassSocketWarnSnykFail

已安装于

kimi-cli57

gemini-cli57

github-copilot57

amp57

cline57

codex57