dedao-dl命令行完全手册:20+命令参数详解与实战示例
dedao-dl命令行完全手册:20+命令参数详解与实战示例
dedao-dl 是一个功能强大的得到 APP 课程下载工具,专为终端用户设计,支持多种内容格式导出。这个终极指南将为您详细解析 dedao-dl 的 20 多个命令参数,帮助您快速掌握这个高效的命令行工具,轻松下载和管理您的得到课程内容。
📋 快速入门:dedao-dl 基础命令概览
dedao-dl 提供了丰富的命令行接口,支持扫码登录、课程查看、内容下载等多种功能。以下是主要命令的分类概览:
🔐 登录与账号管理命令
登录是使用 dedao-dl 的第一步,支持两种登录方式:
# 扫码登录(推荐)
dedao-dl login -q
# Cookie 登录
dedao-dl login -c "您的Cookie字符串"
# 查看当前登录用户
dedao-dl who
# 查看所有登录过的用户
dedao-dl users
# 切换用户
dedao-dl su <用户UID>
小贴士:扫码登录是最方便的方式,系统会自动打开二维码供您扫描。如果您已经登录过,可以使用 dedao-dl who 查看当前账户信息。
📚 内容查看与搜索命令
在下载前,您需要先查看可用的内容。dedao-dl 提供了多种查看方式:
# 查看所有分类
dedao-dl cat
# 查看已购课程(支持分页和排序)
dedao-dl course
dedao-dl course --page 1 --limit 20
dedao-dl course --order buy
# 查看听书书架
dedao-dl odob
dedao-dl odob --page 1 --limit 15
# 查看电子书架
dedao-dl ebook
dedao-dl ebook --group-id 12345
# 查看我的锦囊
dedao-dl ace
# 搜索内容
dedao-dl search --query "关键词" --type 0
参数详解:
--page和--limit:分页参数,需要同时使用--order:排序方式,course 支持study(学习进度)和buy(购买时间)--group-id:按分组查看内容
🎯 核心下载功能:三种内容类型详解
dedao-dl 支持三种主要内容的下载,每种都有特定的命令和参数。
1. 课程下载(dl 命令)
课程下载是最常用的功能,支持多种格式:
# 下载课程音频(MP3格式)
dedao-dl dl 123 -t 1
# 下载课程PDF文档
dedao-dl dl 123 -t 2
# 下载课程Markdown文档
dedao-dl dl 123 -t 3 -m -c
# 使用ENID下载(从URL中获取)
dedao-dl dl ZWyMAOLnR4xJ1vqse8X65QaE8YG29k -t 1
# 下载单篇文章
dedao-dl dl 123 456 -t 1
参数说明:
-t:下载格式(1=MP3,2=PDF,3=Markdown)-m:合并Markdown文档(仅-t 3时有效)-c:下载热门留言(仅-t 3时有效)-o:文件名添加序号前缀
2. 听书下载(dlo 命令)
每天听本书的下载同样支持多种格式:
# 下载听书音频
dedao-dl dlo 456 -t 1
# 下载听书PDF文稿
dedao-dl dlo 456 -t 2
# 下载听书Markdown文稿
dedao-dl dlo 456 -t 3
# 使用topic_id_str下载
dedao-dl dlo ZV1po7jlgBdObqZXy0GNR4wLzxya5v -t 1
3. 电子书下载(dle 命令)
电子书下载支持最丰富的格式选项:
# 下载电子书HTML格式
dedao-dl dle 789 -t 1
# 下载电子书PDF格式
dedao-dl dle 789 -t 2
# 下载电子书EPUB格式
dedao-dl dle 789 -t 3
# 下载电子书读书笔记(Markdown)
dedao-dl dle 789 -t 4
# 查看电子书笔记
dedao-dl ebook notes -i 789
🔍 高级查询与内容管理
详细内容查看
要查看具体内容的详细信息,可以使用以下命令:
# 查看课程详细信息
dedao-dl course -i 123
# 查看课程文章列表
dedao-dl article --id 123
# 查看单篇文章详情
dedao-dl article --id 123 --aid 456
# 查看电子书详情
dedao-dl ebook -i 789
# 查看推荐话题
dedao-dl topic
dedao-dl topic -i "话题ID"
最近学习记录查询
追踪您的学习进度:
# 查看最近学习记录
dedao-dl recent
# 分页查看学习记录
dedao-dl recent --page-size 20 --max-id 0
# 按产品类型过滤
dedao-dl recent --product-type 66 --filter-product-type=true
# 指定用户查看
dedao-dl recent --uid-hazy <用户UID>
免费专区内容
探索免费内容资源:
# 查看免费课程列表
dedao-dl free
# 查看特定免费课程
dedao-dl free <ENID>
🌐 Web UI 与 API 服务
dedao-dl 还提供了现代化的 Web 界面:
# 启动Web服务(默认端口17878)
dedao-dl web
# 指定监听地址和端口
dedao-dl web --host 0.0.0.0 --port 8080
# 仅启动服务,不自动打开浏览器
dedao-dl web --open=false
Web 服务提供图形化界面,支持扫码登录、内容浏览、一键下载等功能,适合不熟悉命令行的用户使用。
🛠️ 实用技巧与最佳实践
1. 获取内容ID的两种方式
dedao-dl 支持两种ID格式:
- 数字ID:通过
dedao-dl course、dedao-dl odob、dedao-dl ebook命令查看 - ENID字符串:从URL中提取,格式如
ZWyMAOLnR4xJ1vqse8X65QaE8YG29k
2. 批量下载策略
对于大型课程,建议:
# 先查看课程章节
dedao-dl course -i <课程ID>
# 然后分批下载
dedao-dl dl <课程ID> -t 1 -o
3. 格式选择指南
- MP3格式(-t 1):适合音频学习,文件较小
- PDF格式(-t 2):适合阅读和打印,保留格式
- Markdown格式(-t 3):适合编辑和整理,纯文本
- HTML/EPUB格式(-t 1/3):电子书专用,支持多种阅读器
4. 依赖安装提示
根据下载需求安装相应依赖:
- PDF生成:需要 wkhtmltopdf
- 音频处理:需要 ffmpeg
- Markdown下载:无需额外依赖
⚠️ 注意事项与常见问题
1. 登录问题
- 确保网络连接正常
- 扫码登录时,请使用得到APP最新版本
- Cookie 登录时,确保 Cookie 有效且未过期
2. 下载限制
- 生成 PDF 时,操作过于频繁可能触发验证
- 系统会自动添加 0-5 秒的延迟以避免频繁请求
- 建议分批下载大型课程
3. 文件保存
- 下载的文件默认保存在
output目录 - 不同内容类型会有不同的子目录结构
- 支持自定义输出目录(通过环境变量或参数)
4. 多账号管理
- 支持多个账号切换
- 使用
dedao-dl users查看所有账号 - 使用
dedao-dl su <UID>切换账号
📊 命令参数速查表
| 命令 | 主要参数 | 功能描述 | 示例 |
|---|---|---|---|
login |
-q, -c |
登录得到账号 | dedao-dl login -q |
course |
-i, --page, --limit |
查看已购课程 | dedao-dl course -i 123 |
dl |
-t, -m, -c, -o |
下载课程 | dedao-dl dl 123 -t 1 |
dlo |
-t |
下载听书 | dedao-dl dlo 456 -t 1 |
dle |
-t |
下载电子书 | dedao-dl dle 789 -t 2 |
odob |
--page, --limit |
查看听书书架 | dedao-dl odob |
ebook |
-i, --page |
查看电子书架 | dedao-dl ebook -i 789 |
recent |
--page-size, --max-id |
最近学习记录 | dedao-dl recent |
search |
--query, --type |
搜索内容 | dedao-dl search --query "投资" |
🚀 高级用法:结合其他工具
dedao-dl 可以与其他工具结合使用,实现更强大的功能:
1. Docker 容器运行
# 构建镜像
docker build https://gitcode.com/gh_mirrors/de/dedao-dl.git#main -t dedao
# 运行命令
docker run -v $(pwd)/config.json:/app/config.json -it --rm dedao login -q
2. 自动化脚本
您可以编写 Shell 脚本或 Python 脚本,结合 dedao-dl 实现自动化下载和管理。
3. 定期备份
设置定时任务,定期备份您的学习内容:
# 每周备份一次课程
0 2 * * 0 dedao-dl dl <课程ID> -t 3 -m -c
💡 总结与建议
dedao-dl 是一个功能全面、使用灵活的命令行工具,通过掌握本文介绍的 20 多个命令参数,您可以:
- 高效管理您的得到课程、听书和电子书
- 灵活导出多种格式的学习资料
- 自动化处理批量下载任务
- 跨平台使用支持 Windows、macOS 和 Linux
最佳实践建议:
- 首次使用时,先运行
dedao-dl -h查看帮助 - 不确定参数时,使用
dedao-dl <命令> -h查看详细说明 - 对于大型下载任务,建议分批进行
- 定期更新 dedao-dl 以获取最新功能
通过本文的详细指南,您已经掌握了 dedao-dl 命令行工具的完整使用方法。现在就开始使用 dedao-dl,高效管理您的得到学习资源吧!
更多推荐





所有评论(0)