\r \r

kmdr - Kmoe 漫画下载器\r

\r

概述\r

\r kmdr 是一个用于从 Kmoe 网站下载漫画的命令行工具。此 skill 教导如何使用 kmdr 完成漫画搜索、下载、账号管理等任务。\r \r

环境准备\r

\r

安装 kmdr\r

\r

pip install --pre "kmoe-manga-downloader>=1.4.0.a0,\x3C2.0.0"\r
```\r
\r
验证安装：\r
\r
```bash\r
kmdr --mode toolcall version\r
```\r
\r
如果命令不存在，说明 kmdr 未安装或未添加到 PATH。\r
\r
### 登录配置\r
\r
#### 检测登录状态\r
\r
```bash\r
kmdr --mode toolcall status\r
```\r
\r
- 返回 `code: 0` → 已登录，可继续操作\r
- 返回 `code: 21` 或 `code: 23` → 未登录或凭证失效，需配置凭证\r
\r
#### 配置凭证\r
\r
**方式一（推荐）：用户自行登录**\r
\r
在终端中执行：\r
\r
```bash\r
kmdr login -u \x3Cusername> [-p \x3Cpassword>]\r
```\r
\r
如果不提供 `-p` 参数，将交互式提示输入密码。凭证将安全存储在本地配置文件中，不会暴露给智能体。\r
\r
**方式二：智能体代为登录**\r
\r
如果用户确认当前环境安全，可提供用户名和密码，由智能体执行登录命令。\r
\r
⚠️ **风险提示**：凭证将出现在对话历史中，请确认环境安全后再选择此方式。\r
\r
## 调用方式\r
\r
你的所有命令都应使用 `--mode toolcall` 参数以获取结构化的 JSON 输出：\r
\r
```bash\r
kmdr --mode toolcall \x3Ccommand> [options]\r
```\r
\r
值得注意的是，当你向用户建议手动执行命令时，不要包含 `--mode toolcall` 参数，以便用户使用默认的交互式的输出格式。\r
\r
## 主要命令\r
\r
### 搜索漫画\r
\r
```bash\r
kmdr --mode toolcall [--fast-auth] search \x3Ckeyword> [-p \x3Cpage>] [-m]\r
```\r
\r
- `\x3Ckeyword>`: 搜索关键字（必需）\r
- `-p, --page`: 页码，默认为 1\r
- `-m, --minimal`: 仅返回书名和链接\r
\r
**使用场景**：用户想要搜索特定漫画、查找某作者的作品、发现新漫画。\r
\r
### 下载漫画\r
\r
```bash\r
kmdr --mode toolcall [--fast-auth] download [options]\r
```\r
\r
关键选项：\r
- `-l, --book-url \x3Curl>`: 漫画详情页 URL\r
- `-d, --dest \x3Cpath>`: 下载保存路径，默认从配置中读取，如果没有配置则是当前目录\r
- `-v, --volume`: 指定下载卷号（如 `1,2,3` 或 `1-5` 或 `all`）\r
- `-P, --use-pool`: 启用凭证池自动故障转移\r
\r
**使用场景**：用户想要下载指定漫画、批量下载多个卷。\r
\r
### 登录和状态\r
\r
```bash\r
kmdr --mode toolcall login -u \x3Cusername> -p \x3Cpassword>\r
kmdr --mode toolcall status\r
```\r
\r
**使用场景**：用户需要登录账号、查看剩余配额。\r
\r
### 凭证池管理\r
\r
```bash\r
kmdr --mode toolcall pool add -u \x3Cusername> -p \x3Cpassword>\r
kmdr --mode toolcall pool list [--refresh]\r
kmdr --mode toolcall pool use \x3Cusername>\r
kmdr --mode toolcall pool remove \x3Cusername>\r
```\r
\r
**使用场景**：用户需要管理多个账号、切换默认账号、查看所有账号配额。\r
\r
### 配置管理\r
\r
```bash\r
kmdr --mode toolcall config --set \x3Ckey>=\x3Cvalue>\r
kmdr --mode toolcall config --list\r
kmdr --mode toolcall config --clear\r
```\r
\r
可配置项：`dest`, `proxy`, `num_workers`, `retry`, `callback`, `format`\r
\r
**使用场景**：用户需要设置下载路径、配置代理、调整并发数。在更新配置后，请使用 `config --list` 验证更改是否生效。\r
\r
## 输出格式\r
\r
详细输出格式请参阅 [./references/output-format.md](./references/output-format.md)。\r
\r
### 结果类型\r
\r
- `{"type": "result", "code": 0, ...}`: 最终结果\r
- `{"type": "progress", ...}`: 进度更新（仅下载命令）\r
\r
### 错误处理\r
\r
错误通过 `code` 字段表示，详细状态码请参阅 [./references/error-codes.md](./references/error-codes.md)。\r
\r
## 示例场景\r
\r
详细示例请参阅 [./assets/examples/](./assets/examples/) 目录。\r
\r
### 典型工作流\r
\r
1. **检查环境** → 确认已安装并登录（参见"环境准备"）\r
2. **搜索** → `kmdr --mode toolcall --fast-auth search "漫画名称"`\r
3. **获取详情** → 从搜索结果中获取 `url` 字段\r
4. **预估下载** → `kmdr --mode toolcall --fast-auth download -l \x3Curl> -v \x3Cvolume> --explain`\r
5. **确认配额** → 根据预估消耗决定是否继续（若消耗较大需向用户确认）\r
6. **下载** → `kmdr --mode toolcall --fast-auth download -l \x3Curl> -v \x3Cvolume> [-d \x3Cpath>]`\r
\r
## 注意事项\r
\r
1. **认证要求**：大部分操作需要先登录或配置有效的 cookies\r
2. **配额限制**：下载会消耗账号配额，建议在下载前检查配额状态\r
3. **搜索结果过滤**：用户提供的关键词可能会多个相似结果（相同书名），请查看默认的下载路径\r
    - 如果本地有参考 → 自动选择匹配版本\r
    - 如果本地无参考 → 列出选项供用户选择\r
4. **代理配置**：如果遇到被屏蔽的内容，可以单独配置代理：`kmdr download -p \x3Cproxy_server> -l \x3Curl> -v \x3Cvolume>`\r
\r
## 快速参考\r
\r
| 命令 | 用途 | 示例 |\r
|------|------|------|\r
| `search` | 搜索漫画 | `kmdr --mode toolcall [--fast-auth] search "fate"` |\r
| `download --explain` | 预估下载计划 | `kmdr --mode toolcall [--fast-auth] download -l \x3Curl> -v \x3Cvolume> --explain` |\r
| `download` | 下载漫画 | `kmdr --mode toolcall [--fast-auth] download -l \x3Curl>` |\r
| `login` | 登录账号 | `kmdr --mode toolcall login -u user -p pass` |\r
| `status` | 查看配额 | `kmdr --mode toolcall status` |\r
| `pool list` | 列出凭证 | `kmdr --mode toolcall pool list` |\r
| `config` | 配置设置 | `kmdr --mode toolcall config --set dest=/downloads` |