← 返回 Skills 市场
angjustinl

得到 Skill

作者 ANGJustinl · GitHub ↗ · v0.1.1 · MIT-0
cross-platform ⚠ suspicious
329
总下载
1
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install dedao-dl-skill
功能描述
Handles interactions with the dedao-dl CLI tool for downloading and managing content from the Dedao (得到) App. Use when the user wants to list bought courses,...
使用说明 (SKILL.md)

dedao-dl

This skill guides the agent in using the dedao-dl CLI tool to interact with the Dedao (得到) app content.

Initialization

MANDATORY FIRST STEP: Before using any dedao-dl commands for the first time, you MUST run the installation script and verify the CLI is available.

Run the script to download the latest binary for the current OS:

python scripts/install_dedao_dl.py

After installation, you should ALWAYS use the helper script scripts/run_dedao.py to execute commands instead of running the raw dedao-dl executable. The helper script cleans up the CLI's terminal formatting, making the output directly readable by you without needing to redirect it to text files. Example: Use python scripts/run_dedao.py -h instead of ./dedao-dl -h.

Prerequisites & Login

Before downloading any content, ensure the user is logged in:

  • Command: python scripts/run_dedao.py login -q (QR code login) or python scripts/run_dedao.py login -c "\x3Ccookie_string>"
  • Verify current user: python scripts/run_dedao.py who
  • List logged-in users: python scripts/run_dedao.py users
  • Switch user: python scripts/run_dedao.py su

Dependencies for specific formats (inform the user if they are missing):

  • PDF generation requires wkhtmltopdf
  • Audio generation requires ffmpeg
  • Markdown requires no additional dependencies

General Workflow

For any content download, the typical two-step workflow is:

  1. List the specific type of content to find its ID.
  2. Use the corresponding download command with the ID and format flag (-t).

Key Workflows & Commands

1. Courses (专栏/课程) & Free Content (免费专区)

  • List purchased courses: python scripts/run_dedao.py course
  • List free courses: python scripts/run_dedao.py free (Returns EnID strings instead of integer IDs)
  • List articles in a course:
    • For purchased courses (using integer ID): python scripts/run_dedao.py course -i \x3Ccourse_ID>
    • For free courses (using EnID): python scripts/run_dedao.py article -c \x3Ccourse_EnID>
  • Download a single article (RECOMMENDED): python scripts/run_dedao.py dl \x3Ccourse_ID_or_EnID> \x3Carticle_ID> -t \x3Cformat>
  • Download a full course: python scripts/run_dedao.py dl \x3Ccourse_ID_or_EnID> -t \x3Cformat> [options]
    • WARNING: NEVER download a full course (only 1 parameter) without explicit user permission. Full downloads can take hours, consume massive disk space, and trigger anti-bot bans.
    • Formats (-t): 1 (MP3), 2 (PDF), 3 (Markdown, DEFAULT FOR THE AGENT)
    • Options for Markdown (-t 3): -m (merge into one file), -c (include hot comments)
    • Prefix ordering: -o (adds index prefix like 00x.) Note: When downloading as PDF, be aware of rate limits ("496 NoCertificate"). Add sleep intervals if scripting.

2. E-Books (电子书)

  • List e-books: python scripts/run_dedao.py ebook
  • Download an e-book: python scripts/run_dedao.py dle \x3Cebook_ID> -t \x3Cformat>
    • Formats (-t): 1 (HTML, default), 2 (PDF), 3 (EPUB), 4 (Markdown Notes)
  • View e-book notes: python scripts/run_dedao.py ebook notes -i \x3Cebook_ID>
  • Export e-book notes: python scripts/run_dedao.py dle \x3Cebook_ID> -t 4 (Downloads notes as Markdown)

3. Audiobooks (每天听本书)

  • List audiobooks: python scripts/run_dedao.py odob
  • Download audiobook audio/text: python scripts/run_dedao.py dlo \x3Caudiobook_ID> -t \x3Cformat>
    • Formats (-t): 1 (MP3), 2 (PDF), 3 (Markdown, DEFAULT FOR THE AGENT)

4. Other Content

  • List all categories & stats: python scripts/run_dedao.py cat
  • List 'JinNang' (锦囊): python scripts/run_dedao.py ace
  • List recommended topics (知识城邦): python scripts/run_dedao.py topic

Execution Guidelines

  • Always check python scripts/run_dedao.py -h or python scripts/run_dedao.py \x3Ccommand> -h if unsure of the exact arguments.
  • Always retrieve the correct ID first before executing a download command. Make sure you use the list command corresponding to the content type you want to download (e.g., course ID for dl, ebook ID for dle, odob ID for dlo). Do not mix up IDs across categories.
  • NEVER download an entire course (e.g. python scripts/run_dedao.py dl \x3Ccourse_ID_or_EnID>) unless the user explicitly asks you to. Many courses have hundreds of articles which can lead to account bans.
  • ALWAYS favor downloading a single article: First list the course articles using course -i \x3Ccourse_ID> or article -c \x3Ccourse_EnID>, find the specific article ID, and use python scripts/run_dedao.py dl \x3Ccourse_ID_or_EnID> \x3Carticle_ID>.
  • DEFAULT FORMAT: Whenever you download content using dl or dlo, default to using -t 3 (Markdown) unless the user explicitly asks for MP3 or PDF. Markdown is safer, faster, and easier to read.
  • When generating markdown for a whole course (if permitted by the user), consider using -m to consolidate files unless the user explicitly asks for individual files.
安全使用建议
This skill is a coherent wrapper for the dedao-dl CLI, but you should: (1) verify you trust the upstream GitHub repository (yann0917/dedao-dl) before running the install script; (2) inspect the release asset and, if possible, download and verify checksums manually rather than relying on the script; (3) be cautious when supplying cookie strings or other credentials — prefer QR login or run commands interactively so secrets are not saved into logs; (4) run the installer and binary in a sandbox or isolated environment if you are unsure; and (5) remember downloading full courses may violate terms of service or copyright and can consume large disk space and bandwidth.
功能分析
Type: OpenClaw Skill Name: dedao-dl-skill Version: 0.1.1 The skill bundle includes an installation script (scripts/install_dedao_dl.py) that automatically downloads and executes a remote binary from a GitHub repository (yann0917/dedao-dl). While this behavior is aligned with the stated purpose of providing the 'dedao-dl' CLI tool, the practice of fetching and running opaque binaries from the internet is a high-risk pattern that could facilitate supply chain attacks or arbitrary code execution if the remote repository is compromised.
能力评估
Purpose & Capability
Name/description match the included scripts and instructions. The skill only requires downloading and running the dedao-dl binary and provides a helper wrapper to clean CLI output; nothing requested is outside that scope.
Instruction Scope
SKILL.md is focused on using the dedao-dl tool: installation, listing content, login, and download workflows. It does not instruct the agent to read unrelated files or exfiltrate data. It does instruct the user/agent to pass login cookies or use QR login, which is expected for this use case.
Install Mechanism
The provided install script fetches the latest release via the GitHub API for repo yann0917/dedao-dl and writes the release asset directly to a local executable name. Using GitHub releases is reasonable, but the script does not verify checksums or signatures and may pick an archive asset as a fallback (the code prefers direct binaries but can fall back to any asset). This increases risk if the upstream repo or its releases are compromised.
Credentials
The skill declares no required environment variables or credentials, which aligns with its purpose. However SKILL.md instructs providing authentication via QR or an explicit cookie string (login -c "<cookie_string>") — the agent or user will handle secrets at runtime. The skill itself does not request unrelated credentials.
Persistence & Privilege
The skill does not request always-on presence, does not modify other skills or system-wide configs, and only places files in the current directory (the downloaded binary). It runs binaries provided by the upstream project but does not persist credentials or alter agent configuration.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install dedao-dl-skill
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /dedao-dl-skill 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.1
No user-visible changes in this version (0.1.1); documentation and implementation remain the same.
v0.1.0
Initial release of dedao-dl-skill. - Provides clear workflows for downloading and managing Dedao App content via the dedao-dl CLI, covering courses, ebooks, audiobooks, and more. - Enforces mandatory installation and use of a helper script to ensure readable command outputs. - Details login procedures and format-specific dependencies. - Outlines safety guidelines to avoid excessive downloads and potential account bans. - Standardizes on Markdown format for downloads unless otherwise specified by the user.
元数据
Slug dedao-dl-skill
版本 0.1.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

得到 Skill 是什么?

Handles interactions with the dedao-dl CLI tool for downloading and managing content from the Dedao (得到) App. Use when the user wants to list bought courses,... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 329 次。

如何安装 得到 Skill?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install dedao-dl-skill」即可一键安装,无需额外配置。

得到 Skill 是免费的吗?

是的,得到 Skill 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

得到 Skill 支持哪些平台?

得到 Skill 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 得到 Skill?

由 ANGJustinl(@angjustinl)开发并维护,当前版本 v0.1.1。

💬 留言讨论