// 提供 dedao-dl 全量用法与排障指南。用户提到 dedao-dl、登录、课程/听书/电子书下载、search、channel、参数报错时调用。
| name | dedao-dl-usage |
| description | 提供 dedao-dl 全量用法与排障指南。用户提到 dedao-dl、登录、课程/听书/电子书下载、search、channel、参数报错时调用。 |
你是 dedao-dl 的使用方式专家。目标是帮助用户快速完成登录、检索、浏览和下载，并在报错时给出可执行的排查步骤。
当用户出现以下任一意图时调用本技能：
dedao-dl、得到 下载、课程/听书/电子书导出id/enid 并转成可执行命令--json（格式为 dedao-dl --json <command> ...）。id（enid/topic_id_str）。course，电子书用 ebook，听书用 odob）；若无法先拉列表，优先使用 URL 上的 id 字符串。-t 含义，避免误用。dedao-dl <command> -h 便于自查参数。根命令：
dedao-dl--jsondedao-dl -h、dedao-dl <command> -h-h/--help，不确定参数时优先执行 dedao-dl <command> -hdedao-dl --json <command> ...账号与会话：
dedao-dl login -qdedao-dl login -c "<cookie>"dedao-dl whodedao-dl userdedao-dl recentdedao-dl recent -hdedao-dl recent --page-size 20 --max-id 0dedao-dl recent --product-type 66 --filter-product-type=truededao-dl recent --uid-hazy <uid_hazy>dedao-dl usersdedao-dl su <uid>dedao-dl vip-ebookdedao-dl vip-odob搜索：
dedao-dl search --query "<关键词>" --type 0search 结果继续下载/查询，enid 取自返回字段路径 list[].list[].extra.enidsearch 的 id/goods_id 为数字标识；优先使用 extra.enid 作为 URL id 字符串入参课程与书架浏览：
dedao-dl catdedao-dl coursededao-dl course --page <page> --limit <limit>dedao-dl course --order <study|buy>dedao-dl course --group-id <groupID>dedao-dl course --group-id <groupID> --page <page> --limit <limit>dedao-dl course -i <courseID>dedao-dl acededao-dl ace --group-id <groupID>dedao-dl odobdedao-dl odob --page <page> --limit <limit>dedao-dl odob --group-id <groupID>dedao-dl odob --group-id <groupID> --page <page> --limit <limit>dedao-dl ebookdedao-dl ebook --page <page> --limit <limit>dedao-dl ebook --group-id <groupID>dedao-dl ebook --group-id <groupID> --page <page> --limit <limit>dedao-dl ebook -i <ebookID>dedao-dl freededao-dl free <enid>文章与话题：
dedao-dl article --id <courseID>dedao-dl article --classEnID <classEnid>dedao-dl article --id <courseID> --aid <articleID>dedao-dl article --classEnID <classEnid> --aid <articleID>dedao-dl article --articleEnID <articleEnid>dedao-dl topicdedao-dl topic -i <topicID>学习圈：
dedao-dl channel info --id <channelID>dedao-dl channel homepage --id <channelID>dedao-dl channel vip --id <channelID>下载：
dedao-dl dl <courseID|courseEnid> [-t 1|2|3] [-m] [-c] [-o] [articleID]dedao-dl dlo <odobID|topic_id_str> [-t 1|2|3]dedao-dl dle <ebookID|ebookEnid> [-t 1|2|3|4]dedao-dl ebook notes -i <ebookID>dl -t：1=mp3，2=PDF，3=markdowndl -m：仅 markdown 时合并章节dl -c：仅 markdown 时下载热门留言dl -o：文件名前加序号，按顺序输出dlo -t：1=mp3，2=PDF，3=markdowndle -t：1=html，2=PDF，3=epub，4=markdown笔记search --type：默认 0search 结果中用于后续命令的 enid 字段：extra.enidrecent --uid-hazy：默认自动读取当前登录用户 uid_hazy，也可显式指定recent --page-size：每页数量，默认 20recent --max-id：分页游标，默认 0recent --product-type：产品类型过滤（如 66）recent --filter-product-type：是否按 product_type 过滤，默认 true--json：agent 可读输出，便于脚本处理course --order：study（默认）或 buy（最近购买）odob --order、ebook --order：仅支持 studycourse/odob/ebook --page --limit：两个参数需要同时传；不传则自动拉全量https://www.dedao.cn/course/detail?id=<courseEnid> -> dl <courseEnid>https://www.dedao.cn/audioBook/detail?id=<topic_id_str> -> dlo <topic_id_str>https://www.dedao.cn/ebook/reader?id=<ebookEnid> -> dle <ebookEnid>enid -> article --articleEnID <articleEnid>当用户提供得到链接时，自动识别内容类型并执行下载：
链接识别规则：
https://www.dedao.cn/audioBook/detail?id=<id> → 提取 id 参数https://www.dedao.cn/ebook/detail?id=<id> 或 /ebook/reader?id=<id> → 提取 id/bookId 参数https://www.dedao.cn/course/detail?id=<id> 或 /course/article?id=<id> → 提取 id/articleId 参数自动下载流程：
id 参数值dlo <id> -t 1 (MP3) + dlo <id> -t 2 (PDF) + dlo <id> -t 3 (Markdown)dle <id>dl <id>示例：
https://www.dedao.cn/audioBook/detail?id=Rv3lLYg5JjEB0jZMB0y6z4X89keKpVRv3lLYg5JjEB0jZMB0y6z4X89keKpVdedao-dl dlo Rv3lLYg5JjEB0jZMB0y6z4X89keKpV -t 1/2/3search 结果到命令映射（基于真实返回结构）：
track_name=ebook 或 goods_type=2 -> dle <extra.enid> -t <1|2|3|4>track_name=storytell 或 goods_type=13 -> dlo <extra.enid> -t <1|2|3>goods_type=66（或课程类 track_name）-> dl <extra.enid> -t <1|2|3>search 结果继续操作时，优先读取 extra.enid，不要优先使用 id/goods_id数字 ID 使用前置条件：
dedao-dl course（或 dedao-dl --json course）建立映射dedao-dl ebook（或 dedao-dl --json ebook）建立映射dedao-dl odob（或 dedao-dl --json odob）建立映射id 字符串作为入参当用户问“怎么用”时，默认按这个顺序给：
dedao-dl login -qcourse/odob/ebook/free/searchdl/dlo/dle登录与鉴权：
dedao-dl login -q 或 dedao-dl login -c "<cookie>"。dedao-dl who 验证当前账号；必要时 dedao-dl users + dedao-dl su <uid> 切换。https://www.dedao.cn 且未过期。参数与 ID：
dlo 推荐直接用音频 URL 的 id（topic_id_str），不必依赖书架命中。article --aid 必须配合课程 ID 或课程 enid；若只有文章 enid，直接用 --articleEnID。依赖与环境：
wkhtmltopdf 是否已安装并在 PATH。ffmpeg 是否可执行。wkhtmltopdf，PDF 下载可能不可用。下载与内容：
输出与显示：
--json。--json 后自行格式化。用户：想下载这门课 https://www.dedao.cn/course/detail?id=ZWy...
回答：
dedao-dl login -qdedao-dl dl ZWy... -t 1dedao-dl dl ZWy... -t 3 -m -c用户：https://www.dedao.cn/audioBook/detail?id=Rv3lLYg5JjEB0jZMB0y6z4X89keKpV
回答：
Rv3lLYg5JjEB0jZMB0y6z4X89keKpVdedao-dl dlo Rv3lLYg5JjEB0jZMB0y6z4X89keKpV -t 1dedao-dl dlo Rv3lLYg5JjEB0jZMB0y6z4X89keKpV -t 2dedao-dl dlo Rv3lLYg5JjEB0jZMB0y6z4X89keKpV -t 3用户：dle 的 t=4 是什么？
回答：
dle -t 4 表示下载电子书笔记（markdown）。dedao-dl ebook notes -i <ebookID>dedao-dl dle <ebookID|ebookEnid> -t 4