dedao-dl

# 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:
```bash
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 "<cookie_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 `ID`s)
- **List articles in a course**: 
  - For purchased courses (using integer ID): `python scripts/run_dedao.py course -i <course_ID>`
  - For free courses (using EnID...