# Dedao Dl

Dedao-dl 命令行工具的全量用法与排障：登录得到账号、搜索/浏览课程·听书·电子书、下载...

- Repository: https://github.com/yann0917/dedao-dl (916 stars)
- Category: Documents
- License: MIT
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add yann0917/dedao-dl --skill dedao-dl -g -a claude-code -y`
Codex: `npx skills add yann0917/dedao-dl --skill dedao-dl -g -a codex -y`
Cursor: `npx skills add yann0917/dedao-dl --skill dedao-dl -g -a cursor -y`
Gemini CLI: `npx skills add yann0917/dedao-dl --skill dedao-dl -g -a gemini-cli -y`

## Description

dedao-dl 命令行工具的全量用法与排障：登录得到账号、搜索/浏览课程·听书·电子书、下载 MP3/PDF/Markdown/EPUB/读书笔记、学习圈、最近学习、多账号切换。凡用户提到 dedao-dl、"得到"下载或导出、贴出 dedao.cn 链接想下载内容、询问某条命令参数写法、或 dedao-dl 命令报错时都应触发, , 即使用户没有明确说"dedao-dl"这个词。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# dedao-dl 使用助手

`dedao-dl` 是得到（dedao.cn）的命令行下载器：下载已购课程（MP3/PDF/Markdown）、每天听本书（MP3/PDF/Markdown）、电子书（HTML/PDF/EPUB/读书笔记）。产物默认写在当前目录 `output/` 下，缓存位于 `.cache/`。

## 前置依赖

- PDF 导出需要 `wkhtmltopdf` 在 PATH 中
- 音频处理需要 `ffmpeg` 可执行
- Docker 容器内不含 `wkhtmltopdf`，PDF 下载不可用

## 核心工作流

```bash
# 1) 登录（二选一）
dedao-dl login -q                 # 扫码登录
dedao-dl login -c "<cookie>"      # cookie 来自 https://www.dedao.cn

# 2) 验证登录
dedao-dl who

# 3) 浏览 / 搜索，拿到 ID
dedao-dl course                   # 已购课程
dedao-dl odob                     # 听书书架
dedao-dl ebook                    # 电子书架
dedao-dl search --query "基层中国的运行逻辑" --type 0
dedao-dl free                     # 免费专区

# 4) 下载
dedao-dl dl  <courseID|courseEnid> -t 1     # 课程
dedao-dl dlo <odobID|topic_id_str> -t 1     # 听书
dedao-dl dle <ebookID|ebookEnid>   -t 1     # 电子书
```

## Agent 使用规则

The rest: https://github.com/yann0917/dedao-dl/blob/HEAD/skills/dedao-dl/SKILL.md