原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。原型 · 每 30 分钟更新
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚 登录

download-anything Skill

代码仓库 ↗

作者:nengong★ 2581 个 skill

安装

能做什么

面向 AI Agent 与终端的全能下载与归档工具 / All-in-one CLI & Skill to download anything: videos, docs, cloud drives, music, papers & books

作者提供的原文

  • 连接方式 供 AI 读取的指令文件
  • 账号或密钥 README 和 SKILL.md 中未发现密钥
  • 分类 写代码
给作者:在 README 中加徽章

如果你是作者,可把这段代码贴到 README。徽章会链接回本页。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/nengong-download-anything.svg)](https://mcp.popnx.com/en/skills/nengong-download-anything)

可搭配使用

在同一工作中把 AI 连到服务的 MCP

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

作者:morluto广泛使用↓ 38.9万/周★ 46.9万8天前更新

MCP · 连接服务在你的电脑上运行

Fallow

Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.

作者:fallow-rs广泛使用↓ 244.1万/周★ 5385昨天更新

MCP · 连接服务在你的电脑上运行

相似的 Skill

同类工作,排序与 Skill 列表相同

与相似项目对比
本项
download-anything
reaandrej-karpathy-skillsgraphifyMoneyPrinterTurbo
作者nengongmorlutomultica-aiGraphify-Labsharry0703
Skill 数11111
GitHub 星标258468,733234,332150,287144,566
最近代码更新2026年11月8日2026年11月19日2026年4月20日2026年11月18日2026年11月18日
许可证–MIT–Apache-2.0MIT

nengong 提供的 1 个 Skill(指令集),AI 读取后照做 · 不是 MCP server

Skill 和 MCP 有什么不同

MCP = 手

把 AI 连到外部服务或数据,例如读取 Notion 或开发票。需要有程序或服务器在运行。

Skill = 手册

教 AI 怎么做某项工作的文本文件,不连接任何服务。

有些会重叠:少数 Skill 带有调用工具的脚本,少数 MCP 只提供知识。请从你想完成的工作出发。

适用的应用

Claude CodeCodex

依据开发者 README 和 repo 中的文件夹

安装

安全吗?

  • 作者

    GitHub 账号 nengong(个人)才创建 4 个月,请格外小心

  • 使用与维护

    ★ 258 星,目前用户较少 · 代码最近更新 2026年11月8日

  • 有脚本吗?

    有 1 个可以在电脑上运行的脚本:scripts/install.py

  • 会联网吗?

    会联网的脚本:scripts/install.py

  • 会修改整台电脑的设置吗?

    没有发现 hook 或写入电脑设置的操作

根据仓库 commit f3db928 中的文件自动检查(只读取文件,没有运行任何内容)。这不是安全保证,请自己阅读后再决定

第一步:你用哪个 AI?

选择你用的应用,本页只显示该应用的安装方法

方式 1上传到 claude.ai(网页和应用)

  1. 从 GitHub 下载

    这个 Skill 没有说明许可证,所以我们不在网站上提供 ZIP。请从 GitHub 下载并自己整理文件夹,或者用上面的"让 AI 帮你安装",更简单

    从 GitHub 下载(整个仓库)↗

    解压后,只把 skills/download-anything 文件夹重新压缩。ZIP 的最上层必须是包含 SKILL.md 的 download-anything 文件夹,不能直接放散乱的文件

  2. 打开 claude.ai 的 Skills 页面并上传

    +Create skillUpload a skill选择文件 download-anything.zip

    打开 claude.ai/customize/skills ↗

  3. 看不到 Upload 按钮?请先开启创建文件的权限

    SettingsCapabilitiesCode execution and file creation

    Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free

Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)

Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)

Checked against official docs 2026年11月12日 · Source: support.claude.com, support.claude.com, code.claude.com

方式 1让 Claude Code 帮你安装

复制这句话,粘贴到 Claude Code 的对话中

安装到哪里

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

如果只用于一个项目,请粘贴到在该项目文件夹中打开的对话里 · AI 在安装前一定会先告诉你路径

AI 会先说明要做什么,每一步都会征求你的同意

重新打开 Claude Code,输入 /download-anything,或直接提出相关任务,Claude 会自动选用

Checked against official docs 2026年11月12日 · Source: code.claude.com

适合使用 Terminal 的人

Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。

开发者推荐的方式

安装 Node.js(如果还没有)

已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

node -v
  • 显示版本号(例如 v26.13.1)= 已安装,可跳过这一步
  • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
怎么打开终端

Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

还没安装: 打开官方下载页,选择 LTS 版本和点选式安装程序:Mac 用 .pkg · Windows 用 .msi。双击后一路下一步即可,不需要 curl 命令

打开 Node.js 下载页 ↗

装好后关掉终端再打开,重新运行同一条命令,应显示版本号: node -v

安装一次,所有需要 Node.js 的工具都能用

正在检查命令 · 通过后才会显示复制按钮

摘自开发者 README,会下载并运行开发者的代码

  1. 打开终端

    Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”

  2. 把 skill 文件夹复制到 ~/.claude/skills

    这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹

    正在检查命令 · 通过后才会显示复制按钮

  3. 重新打开 Claude Code,输入 /download-anything,或直接提出相关任务,Claude 会自动选用

自己安装的 Skill 可用于 ChatGPT 桌面应用、Codex CLI 和 IDE 中的 Codex 扩展 · 网页版和手机版 ChatGPT 不能使用自己安装的 Skill,只能使用目录中插件自带的 Skill

ChatGPT 桌面应用

ChatGPT 桌面应用内置 Codex,Codex 从 ~/.agents/skills 文件夹读取 Skill

方式 1让 ChatGPT 帮你安装

在 ChatGPT 桌面应用中打开 Codex,把这句话粘贴到对话中

安装到哪里

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

AI 在安装前一定会先告诉你路径

AI 会先说明要做什么,每一步都会征求你的同意

方式 2自己放入文件夹

把 download-anything 文件夹放到 ~/.agents/skills/download-anything

~ 是你的主文件夹($HOME)

适合使用 Terminal 的人

Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。

  1. 打开终端

    Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”

  2. 把 skill 文件夹复制到 ~/.agents/skills

    这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹

    正在检查命令 · 通过后才会显示复制按钮

安装之后

  • ChatGPT 桌面应用:打开侧边栏中的 Skills,确认 Skill 已出现
  • 使用方法:在 ChatGPT 中输入 @ 并选择 Skill · 在 Codex CLI 或 IDE 扩展中运行 /skills,或输入 $ 加 Skill 名称
  • Codex 会自动发现新安装的 Skill;如果没有出现,请重启 Codex

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

网页版和手机版 ChatGPT

不能使用你自己安装的 Skill,只能使用目录中插件自带的 Skill

想在 ChatGPT 中使用这个 Skill,请按上面的方法使用 ChatGPT 桌面应用

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

方式 1让 Codex 帮你安装

复制这句话,粘贴到 Codex 的对话中 · 适用于 ChatGPT 桌面应用中的 Codex、Codex CLI 和 IDE 扩展

安装到哪里

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

如果只用于一个项目,请粘贴到在该项目文件夹中打开的对话里 · AI 在安装前一定会先告诉你路径

AI 会先说明要做什么,每一步都会征求你的同意

Codex 会自动发现新安装的 Skill;如果没有出现,请重启 Codex · 使用方法:在 ChatGPT 中输入 @ 并选择 Skill · 在 Codex CLI 或 IDE 扩展中运行 /skills,或输入 $ 加 Skill 名称

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

适合使用 Terminal 的人

Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。

  1. 打开终端

    Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”

  2. 把 skill 文件夹复制到 ~/.agents/skills

    这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹

    正在检查命令 · 通过后才会显示复制按钮

  3. 重新打开 Codex 并提出相关任务,Codex 会列出这个 skill

方式 1让 Cursor 帮你安装

复制这句话,粘贴到 Cursor 的对话中

安装到哪里

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

如果只用于一个项目,请粘贴到在该项目文件夹中打开的对话里 · AI 在安装前一定会先告诉你路径

AI 会先说明要做什么,每一步都会征求你的同意

在 Cursor 的 Agent 聊天中输入 / 并选择 download-anything

Checked against official docs 2026年11月12日 · Source: cursor.com

适合使用 Terminal 的人

Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。

  1. 打开终端

    Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”

  2. 把 skill 文件夹复制到 ~/.cursor/skills

    这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹

    正在检查命令 · 通过后才会显示复制按钮

  3. 在 Cursor 的 Agent 聊天中输入 / 并选择 download-anything

方式 1让 AI 帮你安装

适用于其他能读取 Skill 的应用。这句话列出了 Claude Code、Codex 和 Cursor 的路径,AI 会按你的应用选择 · 复制这句话,粘贴到应用的对话中

安装到哪里

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

如果只用于一个项目,请粘贴到在该项目文件夹中打开的对话里 · AI 在安装前一定会先告诉你路径

AI 会先说明要做什么,每一步都会征求你的同意

Checked against official docs 2026年11月12日 · Source: code.claude.com, learn.chatgpt.com, cursor.com

适合使用 Terminal 的人

其他支持 Agent Skills 的应用(如 Gemini CLI、GitHub Copilot)使用不同文件夹,请查看该应用的指南,再把含 SKILL.md 的文件夹复制过去。

在 GitHub 上查看 ↗

已于 2026年11月11日 对照 Claude Code、Codex 和 Cursor 官方指南核实 skill 文件夹

查看原始 SKILL.md

以下文字来自开发者的 repo,不是 PopNx MCP 的指令

显示前 8,000 个字符 · 在 GitHub 打开完整文件

---
name: download-anything
description: 面向个人与 AI Agent 的全能下载与结构化归档工具。当用户要求下载、提取、转换或归档社交视频与图文(B站及分P合集、抖音、小红书、YouTube、X、微博、Instagram、TikTok、m3u8)、播客与音频(小宇宙、Apple Podcasts、网易云音乐、Spotify、Apple Music、本地 NCM 解密与 FLAC 转 MP3)、文章与知识库(微信公众号、知乎/掘金/CSDN/Medium 等技术社区、Obsidian 同步)、学术论文与公开课课件(arXiv、DOI 论文、MIT OCW 开放讲义 PDF、ISBN/MD5 电子书)、开源商用字体(霞鹜文楷、思源黑体/宋体、阿里普惠体、JetBrains Mono、Inter 等)、百度/夸克网盘分享、GitHub 单文件与发行包或微软商店/安卓 APK 安装包时触发;也可在用户要求总结视频、公开课、播客或文章链接时调用,以提取本地字幕(.srt)、Shownotes 或 Markdown 正文供 Agent 分析。
---

# Download Anything (DA)

调用 `da`(或 `dl`)将分享口令文本、链接、DOI、ISBN、MD5、包名或本地音频文件下载并结构化归档到本地。全量核心下载、解密、格式转换与完整性校验均 **开箱即用、免配置本地运行**。各平台详细输入输出规范见 [references/platforms.md](references/platforms.md),开源字体实测梯队与直链见 [references/fonts.md](references/fonts.md),公开课归档与 `not_for` 边界见 [references/education.md](references/education.md),完整 CLI 参数与 JSON 字段定义见 [references/cli.md](references/cli.md)。

## 1. 支持的能力与产物速查(按平台合并,单入口自动识别)

- **视频、图文与社交**(B站 / 抖音 / 小红书 / YouTube / X / 微博 / Instagram / TikTok / `.m3u8`):自动识别视频(输出 `.mp4`,抖音支持免水印最高 4K;加 `-a` 提取纯音轨 `.m4a`/`.mp3`)或多图(`image_01.jpg` + `companion_files`);自动生成 `cover.jpg` 原画封面、`content.md`、`content.info.json`;**B站支持 `?p=N` 分 P 精准选集与 `.srt` 字幕提取**,**抖音提取 `audio.mp3` 原声**,**小红书实况图提取配套 `.mov`**。
- **播客、音乐与音频**(小宇宙 / Apple Podcasts / 网易云音乐 / Spotify / Apple Music / 本地 `.ncm` 与 `.flac`):输出 `.m4a` 或 `.mp3`(本地转换统一输出 `320kbps .mp3`);配套生成播客 `content.md`(完整 Shownotes 与时间轴)、音乐 `.lrc` 歌词、高清专辑封面。
- **文章与知识库**(微信公众号 / 知乎 / 掘金 / CSDN / 博客园 / Medium / Substack / 少数派 / 简书 / SegmentFault / 开源中国 / V2EX):输出干净 Markdown `article.md`,防盗链配图全部本地化(`img_01.png`...)并重写相对路径;加 `--vault` 自动注入 YAML frontmatter 同步至 Obsidian。
- **学术论文、公开课课件与电子书**(arXiv 链接或编号 / DOI / MIT OCW `ocw.mit.edu` 课程讲义与 `.edu` 开放课件 PDF / 10或13位 ISBN / 32位 MD5):输出经 `pypdf` 页数校验的论文/讲义 `.pdf` 或电子书 `.epub` / `.pdf`;论文与公开课讲义自动生成标准 `citation.bib` 引用文件与包含作者/摘要的 `content.md`(商业付费/DRM 网课边界见 [references/education.md](references/education.md))。
- **网盘分享**(百度网盘 / 夸克网盘):自动识别内嵌提取码,支持子目录递归查找与云端临时目录自动清理;ZIP/TAR 默认安全解压并记录于 `extracted_files`。
- **代码、开源字体与安装包**(GitHub `blob` 单文件与 `releases` 发行包 / 开源商用字体 `.ttf`/`.otf`/`.woff2`/`.zip` / 微软商店链接或 12 位 Product ID / Android APK 包名或链接):输出原代码文件、经 `font-magic` 魔数校验的字体文件(ZIP 字体包自动安全解压,实测梯队见 [references/fonts.md](references/fonts.md))、`.msixbundle`(限免费 MSIX/Appx 应用)或 `.apk`(基于 F-Droid/Aptoide 镜像),配套 `content.md` 提供安装说明。

## 2. AI Agent 执行工作流(重要)

### 第一步:环境检查与安装确认(首次调用必检)
在执行下载前,**先确认本机是否已安装 `da` 及其运行依赖,未安装时必须先询问用户确认,不要静默修改系统环境**:

1. **定位可执行文件**:优先查找 `PATH` 中的 `da`(或 `dl`),若无则检查默认独立虚拟环境 `~/.download-anything/venv/bin/da`(Windows 为 `%USERPROFILE%\.download-anything\venv\Scripts\da.exe`)。
2. **未安装 `da` 或缺少 Python 3.10+ 时(先询问用户)**:
   - 若上述路径均不存在,先检查本机是否有 `python3`(需 `3.10` 及以上版本;注意 macOS 系统自带 `python3` 常为 `3.9`)。
   - **主动向用户询问确认**:告知用户本机尚未初始化 `da` 运行环境(或缺少 Python 3.10+),询问是否允许运行本 Skill 目录下的安装脚本 `python3 <Skill目录>/scripts/install.py`(若无 Python 3.10+,脚本可通过 `uv` 下载独立的 Python 3.12 并创建 `~/.download-anything/venv` 隔离环境,不污染系统 Python)。**待用户同意后**,再执行 `python3 <Skill目录>/scripts/install.py --yes`。
3. **运行环境自检(`da doctor --json`)**:
   - 首次安装后或遇到环境报错时,运行 `da doctor --json` 检查 `all_required_ok` 与 `media_ready`。
   - **缺少 Python 依赖包**:若 `all_required_ok` 为 `false`,询问用户后运行 `da doctor --fix --json` 自动补齐(官方 PyPI 超时会自动切换清华/阿里云镜像)。
   - **音视频任务缺少 `ffmpeg` / `ffprobe`**:若当前任务涉及视频或音频,而 `media_ready` 为 `false`(未安装 FFmpeg),请明确告知用户“文档、图片、论文、电子书与网盘功能不受影响,但音视频合并、转码与双轨校验需要 FFmpeg”,并**询问用户是否需要代为执行安装命令**(macOS:`brew install ffmpeg`;Windows:`winget install -e --id Gyan.FFmpeg`;Linux:`sudo apt install ffmpeg`)。
4. **无头环境(Headless)登录态配置**:
   - 在远程服务器、CI/CD 或 Docker 容器等无桌面/无浏览器环境中,交互式 `da login <平台>` 无法调用本地桌面浏览器或系统钥匙串。
   - **环境变量注入(推荐容器/CI)**:通过安全方式配置 `DA_<PLATFORM>_COOKIE` 或 `<PLATFORM>_COOKIE`(如 `DA_BAIDU_COOKIE`、`QUARK_COOKIE`)。Instagram 多图使用 `DA_INSTAGRAM_COOKIE_FILE` 指向授权 Cookie 文件,不使用上述 Cookie 字符串变量。
   - **挂载或预置 credentials.yaml**:在用户目录配置 `~/.download-anything/credentials.yaml`(权限设为 `0600`,如 `chmod 600 ~/.download-anything/credentials.yaml`),按平台填入 Cookie。
   - **安全红线**:严禁在 Agent 的终端输出或聊天对话中打印明文登录凭据、会话 Cookie 或密码。

### 第二步:前置转换与工具边界判断
当用户只提供名称而非直接链接/ID 时,**Agent 应先自行检索出精确标识符,再传给 `da`**:
- **电子书**:若用户只给书名(如“帮我下《傲慢与偏见》英文原版”),不要直接传书名模糊搜索;请先查出该书目标版本的 **10/13 位 ISBN**(如 `9780141439518`)或 **32 位 MD5**,再执行 `da "<ISBN或MD5>" --json`。
- **学术论文**:若用户只给论文标题,先查出对应的 **arXiv 编号**(如 `2310.06825`)或 **开放获取 DOI**,再执行 `da "<arXiv编号或DOI>" --json`。
- **开源商用字体**:若用户只给字体名称(如“帮我下载霞鹜文楷”、“思源黑体”、“阿里巴巴普惠体”或“JetBrains Mono”),请先查阅 [references/fonts.md](references/fonts.md) 中的实测梯队速查表,优先匹配 **Tier 1 首选源直链**(注意:`> 20 MB` 的全量中文字体严禁走 jsDelivr,必须使用 GitHub Releases 或 `gh-proxy.com`;猫啃网/`100font` 详情页非直链),再调用 `da "<字体直链>" --json` 下载并自动解压。
- **公开课课件与教学视频(含 `not_for` 边界)**:详见 [references/education.md](references/education.md)。B站体系课支持直接传入带 `?p=N` 的分 P 链接精准提取单集视频、`-a` 纯音轨与 `.srt` 字幕;MIT OCW(`ocw.mit.edu`)与高校 `.edu` 开放课件支持提取讲义 `.pdf` 并自动生成 `citation.bib`。**严守 `not_for` 边界**:严禁向用户承诺或尝试抓取 Coursera、edX、Udemy、中国大学MOOC(`icourse163.org`)、学堂在线及 B站付费课堂(`bilibili.com/cheese`)等受登录墙或 DRM 加密保护的商业网课。
- **应用安装包**:若用户只给应用名称,先查出对应的 **Android 包名**(如 `org.videolan.vlc`)或 **Microsoft Store 12 位 Product ID**(如 `9N0DX20HK701`),再交给 `da`。
- **GitHub 仓库与目录**:若用户需要克隆整个仓库或拉取多文件目录,优先使用环境中已有的 `gh` CLI、`git` 或 GitHub MCP;仅单文件(`github.com/.../blob/...`)或 Release 发行包直链(`github.com/.../releases/download/...`)使用 `da`。

### 第三步:大文件预检与 Agent 命令超时保护(防卡死必读)
长视频(如 4K 视频)、网盘大合集、安装包体积可能达到数百 MB 至数 GB,下载传输耗时极易超过 Agent 终端命令的默认等待超时(如 60s 或 120s)导致进程被强杀:
1. **优先使用 `--check` 预检**:面对网盘分享、高清视频或未知大小的资源,先执行 `da "<目标>" --check --json` 探测元数据与 `expected_size`(百度/夸克预检不触发云端转存)。
2. **动态调整超时与单文件上限**:
   - 若预检体积(`expected_size`)或实际文件超过默认 500 MB,主动追加 `--max-mb <容量>`(如 `--max-mb 2048`)。
   - 面对大文件下载时,Agent 调用终端工具应将超时阈值(如 `timeout` 或 `WaitMsBeforeAsync`)调大至充足时间,避免过早超时中断。
3. **异步/后台执行模式**:在支持后台任务(Daemon / Background Task)的 Agent 框架中,GB 级大文件任务建议置于后台执行,稍后轮询退出状态与交付结果。

### 第四步:执行下载命令
**自动化调用始终附加 `--json`**,从 `stdout` 解析结构化 JSON:

```bash
# 通用下载(直接传入分享口令、URL、DOI、ISBN、MD5、包名/Product ID 或本地音频路径)
da "<目标输入>" --json

# 仅提取纯音轨(.m4a / .mp3)
da "<视频或播客链接>" -a --json

# 归档至本地 Obsidian 知识库
da "<公众号或文章链接>" --vault "/path/to/vault" --json

# 仅预检目标标题、大小与元数据(网盘预检不会触发云端转存或创建目录)
da "<目标链接>" --check --json

# 捕获或导入本机浏览器/客户端的目标平台登录 Cookie
da login <平台名称> --json
```

可选参数:`-o <目录>` 指定输出目录,`-p <密码>` 指定提取码或解压密码,`-f` 忽略缓存强制重下,`--max-mb N` 调整单文件大小上限(默认 500 MB),`--no-unzip` 保留原压缩包不自动解压,`--no-sidecar` 不生成额外配套文件。

### 第五步:消费结构化归档产物(赋能下游分析)
下载完成后,**不要直接读取 `.mp4` / `.m4a` 等二进制媒体文件**,应直接利用 JSON 返回的结构化文本文件完成用户的总结、提炼或问答需求:
- **总结视频 / 播客**:直接读取 JSON 中 `sidecars.subtitle`(`.srt` 字幕)或 `sidecars.markdown`(节目 Shownotes、视频简介、时间戳与互动数据)。
- **精读公众号 / 技术文章**:直接读取 `primary_asset`(`article.md`),正文内插图已转为同目录下的本地图片文件。
- **整理学术文献**:读取 `primary_asset`(`.pdf`)的同时,可直接读取 `companion_files` 中的 `citation.bib` 获取标准 BibTeX 引用,以及 `sidecars.markdown` 获取摘要与作者元数据。

## 3. 状态判定与异常自愈 SOP

解析 `--json` 输出的 `status` 与退出码,如实反馈并按规则自愈:

- **`status: "success"`(退出码 `0`)**:主文件已通过格式/媒体结构校验(见 `verification.details.level`),所有配套文件与同步步骤均已完成。
- **`status: "cached"`(退出码 `0`)**:命中本地 SQLite 缓存(`~/.download-anything/index.db`)且本地文件完整,直接使用返回的 `primary_asset` 与 `sidecars` 路径,无需重复下载(除非用户要求强制刷新才加 `-f`)。
- **`status: "partial"`(退出码 `2`)**:**主文件已成功下载并通过校验**,仅部分附属文件(如某张配图、字幕 429)或后处理步骤(如 Obsidian 同步、临时目录清理)未完成。
  - **处理准则**:**切勿将 `partial` 当作失败去盲目重下主文件!** 直接使用已落盘的 `primary_asset`,并读取 `warnings` 与 `operations` 字段向用户说明哪项附属步骤未完成及其原因。
- **`status: "dry_run"`(退出码 `0`)**:仅完成 `--check` 预检,未实际落盘文件。
- **`status: "error"`(退出码 `1`)**:根据 `error_type` 执行有限自愈,严禁把失败或预检汇报为下载成功:
  - `AuthenticationRequiredError`:目标平台(如百度网盘、夸克网盘、小红书视频、Instagram 多图)需要登录凭据。
    - **本地桌面环境**:运行 `da login <平台> --json` 自动提取本机浏览器已登录会话,或提示用户在浏览器中先登录该站点。
    - **无头(Headless)环境 / 容器 / 远程服务器**:百度和夸克可注入 `DA_<平台>_COOKIE` 或 `<平台>_COOKIE`,或配置权限为 `0600` 的 `~/.download-anything/credentials.yaml`;Instagram 多图需使用 `DA_INSTAGRAM_COOKIE_FILE` 指向授权 Cookie 文件。
    - **安全红线**:严禁在输出或对话中打印会话 Cookie、登录凭据或密码明文。
  - `FileTooLargeError`:超过默认 500 MB 上限。若用户明确需要下载该大文件,调高 `--max-mb N` 重试一次。
  - `ExtractionError`(含压缩包格式限制):自动解压仅支持受限的 `ZIP` / `TAR`;若因 `7z`、`RA

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子,欢迎第一个提问或分享。

此处内容由用户撰写,不代表 PopNx 团队。

登录后发帖

来自 GitHub

GitHub 星标
258
开发者
nengong
许可证
未注明许可证 此 repo 未注明许可证,默认作者保留所有权利;转发或商用前请先询问作者。
最近代码更新
2026年11月8日
repo 中的 SKILL.md 文件(含译本和模板)
1
主题
ai-agent, claude-code, cli, downloader, media-crawler, obsidian, python, skill, video-downloader