# Yuque Dl

> 下载语雀知识库到本地 Markdown。支持公开/私有知识库、企业私有服务、密码访问的知识库。当用户提供语雀链接、说"下载语雀"、"下载知识库"、"yuque"、"语雀文档"时使用此 skill。

- Skill: `azure12355/yuque-dl` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add azure12355/yuque-dl`
- Raw SKILL.md: https://api.skillmd.com/api/skills/azure12355/yuque-dl/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: azure12355 (https://skillmd.com/u/azure12355)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/azure12355/yuque-dl

---


# 语雀知识库下载器

将语雀知识库下载为本地 Markdown 文件。

## 前置条件

- Node.js 18.4+
- yuque-dl 已全局安装 (`npm install -g yuque-dl`)

## 默认下载位置

```
/Users/lytton/mac_wps_clound/Obsidian笔记知识库/宝藏资源库/语雀知识库/
```

## 基础用法

### 下载公开知识库（下载到默认位置）

```bash
yuque-dl "https://www.yuque.com/用户名/知识库" -d "/Users/lytton/mac_wps_clound/Obsidian笔记知识库/宝藏资源库/语雀知识库"
```

### 指定其他下载目录

```bash
yuque-dl "URL" -d /path/to/other/
```

### 增量下载（跳过已下载）

```bash
yuque-dl "URL" --incremental
```

## 私有知识库

### 1. 分享的私有知识库

需要提供 token（从浏览器 Cookie 获取 `_yuque_session` 值）：

```bash
yuque-dl "URL" -t="your_token_here"
```

### 2. 企业私有服务

企业域名非 `yuque.com` 结尾，需要指定 key 和 token：

```bash
yuque-dl "https://yuque.company.com/xxx" -k "cookie_key" -t="cookie_value"
```

### 3. 公开密码访问的知识库

输入密码后，根据登录状态选择不同 cookie：

**已登录语雀：**
```bash
yuque-dl "URL" -t="_yuque_session值"
```

**未登录语雀：**
```bash
yuque-dl "URL" -k "verified_books" -t="verified_books值"
```

## 常用选项

| 选项 | 说明 |
|------|------|
| `-d, --distDir <dir>` | 下载目录 (默认: download) |
| `-i, --ignoreImg` | 忽略图片不下载 |
| `--ignoreAttachments [ext]` | 忽略附件，可指定后缀如 `mp4,pdf` |
| `-t, --token <token>` | 语雀 cookie token |
| `-k, --key <key>` | cookie key (默认: _yuque_session) |
| `--toc` | 输出文档 toc 目录 |
| `--incremental` | 增量下载 |
| `--hideFooter` | 隐藏页脚信息 |

## 预览下载内容

启动 Web 服务预览：

```bash
yuque-dl server ./download/知识库/
```

访问 http://localhost:5173/ 预览

## 获取 Token 方法

1. 登录语雀网站
2. 打开浏览器开发者工具 (F12)
3. 进入 Application → Cookies
4. 找到 `_yuque_session` 的值

## 工作流程

1. **解析链接**: 确认是语雀知识库链接
2. **判断类型**: 公开/私有/企业/密码访问
3. **获取凭证**: 私有知识库需要用户提供 token
4. **执行下载**: 使用合适参数下载
5. **返回结果**: 告知下载位置

## 常见问题

**Token 含特殊字符报错：**
```bash
# 错误写法
yuque-dl "URL" -t "-abc123"

# 正确写法（用等号）
yuque-dl "URL" -t="-abc123"
```

**附件下载失败：**
即使是公开知识库，下载附件也需要登录 token。

**网络波动失败：**
重新运行即可，已下载的进度会保留。