zlib-download：命令行书籍搜索下载工具，支持Z-Library和Anna's Archive

zlib-download by psylch/media-master

81 周安装量

4 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/psylch/media-master --skill zlib-download

自动化命令行工具资源整合

🇨🇳中文介绍

书籍工具

通过统一的命令行界面从多个来源搜索和下载书籍。

语言

匹配用户语言：使用用户使用的语言进行回应。

后端

后端	来源	需要认证	最佳用途
zlib	Z-Library (EAPI)	邮箱 + 密码	最大的目录，直接下载
annas	Anna's Archive	API 密钥（需捐赠）	聚合来源，多个镜像

预检

在任何工作流之前，运行预检以检查环境准备情况：

python3 ${SKILL_PATH}/scripts/book.py preflight

返回标准化的 JSON：

{
  "ready": true,
  "dependencies": { "python3": {"status": "ok"}, "requests": {"status": "ok"} },
  "credentials": { "zlib": {"status": "configured"}, "annas_api_key": {"status": "not_configured"} },
  "services": { "annas_binary": {"status": "ok"} }
}

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

检查项	修复方法
缺少 `requests`	`bash ${SKILL_PATH}/scripts/setup.sh install-deps`（或手动：`pip3 install requests` / `uv pip install requests`）
`zlib` 未配置	引导用户编辑 `~/.claude/book-tools/.env` — 设置 `ZLIB_EMAIL` 和 `ZLIB_PASSWORD`
`zlib` 过期	缓存的令牌已过期，且 `.env` 中没有邮箱/密码。引导用户将凭据重新添加到 `~/.claude/book-tools/.env`
`annas_api_key` 未配置	引导用户向 Anna's Archive 捐赠以获取 API 密钥，然后将 `ANNAS_SECRET_KEY` 添加到 `~/.claude/book-tools/.env`
缺少 `annas_binary`	`bash ${SKILL_PATH}/scripts/setup.sh install-annas`（或手动：从 annas-mcp releases 下载，解压到 `~/.local/bin/annas-mcp`）

设置（仅首次使用）

仅在预检报告 ready: false 时运行设置。以交互方式引导用户完成配置。

步骤 1：安装依赖项

bash ${SKILL_PATH}/scripts/setup.sh install-deps

步骤 2：配置凭据

凭据存储在 ~/.claude/book-tools/.env 中。从技能捆绑的模板创建该文件：

mkdir -p ~/.claude/book-tools
# 仅当 .env 不存在时才复制 — 绝不覆盖现有凭据
if [ ! -f ~/.claude/book-tools/.env ]; then
  cp ${SKILL_PATH}/scripts/.env.example ~/.claude/book-tools/.env
else
  echo "发现现有 .env 文件 — 跳过复制以保护您的凭据。"
fi

.env 文件内容如下：

# Z-Library 凭据
ZLIB_EMAIL=your_email@example.com
ZLIB_PASSWORD=your_password_here

# Anna's Archive（可选，需要捐赠获取 API 密钥）
# ANNAS_SECRET_KEY=your_api_key_here

重要提示：不要直接在聊天中向用户索要凭据。而是：

创建 .env 文件（或 .env.example 模板）
告诉用户编辑 ~/.claude/book-tools/.env 并填入他们的凭据
等待用户确认已填写
然后继续进行搜索

python3 ${SKILL_PATH}/scripts/book.py preflight

在继续之前确认 ready: true。

规范路径：~/.claude/book-tools/.env — 这是用户编辑凭据的唯一位置。

变量	用途	必需
`ZLIB_EMAIL`	Z-Library 邮箱	用于 Z-Library 后端
`ZLIB_PASSWORD`	Z-Library 密码	用于 Z-Library 后端
`ANNAS_SECRET_KEY`	Anna's Archive API 密钥	用于 Anna's Archive 后端

首次成功登录 Z-Library 后，会话令牌会自动缓存在 ~/.claude/book-tools/config.json 中以提升性能。此文件是自动管理的 — 请勿手动编辑。如果出现登录问题，请删除 config.json，脚本将使用 .env 中的凭据重新登录。

典型流程是：搜索 → 选择 → 下载。

# 自动检测后端（先尝试 zlib，然后是 annas）
python3 ${SKILL_PATH}/scripts/book.py search "machine learning" --limit 10

# 带过滤器的 Z-Library 搜索
python3 ${SKILL_PATH}/scripts/book.py search "deep learning" --source zlib --lang english --ext pdf --limit 5

# Anna's Archive 搜索
python3 ${SKILL_PATH}/scripts/book.py search "reinforcement learning" --source annas

# 中文书籍搜索
python3 ${SKILL_PATH}/scripts/book.py search "莱姆 索拉里斯" --source zlib --lang chinese --limit 5

输出（JSON 到标准输出）：

{
  "source": "zlib",
  "count": 5,
  "books": [
    {
      "source": "zlib",
      "id": "12345",
      "hash": "abc123def",
      "title": "Deep Learning",
      "author": "Ian Goodfellow",
      "year": "2016",
      "language": "english",
      "extension": "pdf",
      "filesize": "22.5 MB"
    }
  ]
}

2. 向用户展示结果

搜索后，将结果以带编号的表格形式呈现，以便用户选择：

| # | 标题 | 作者 | 年份 | 格式 | 大小 |
|---|-------|--------|------|--------|------|
| 1 | Deep Learning | Ian Goodfellow | 2016 | pdf | 22.5 MB |
| 2 | ... | ... | ... | ... | ... |

如果结果包含多种语言或版本，请按语言或类别分组，并使用子标题以提高清晰度。

询问："您想下载哪本书？（输入编号）"

# Z-Library 下载（需要搜索结果中的 id + hash）
python3 ${SKILL_PATH}/scripts/book.py download --source zlib --id 12345 --hash abc123def -o ~/Downloads/

# Anna's Archive 下载（需要搜索结果中的 MD5 hash）
python3 ${SKILL_PATH}/scripts/book.py download --source annas --hash a1b2c3d4e5 --filename "deep_learning.pdf" -o ~/Downloads/

{
  "source": "zlib",
  "status": "ok",
  "path": "~/Downloads/Deep Learning (Ian Goodfellow).pdf",
  "size": 23592960
}

下载后，呈现结构化的完成报告：

[书籍下载] 完成！
书籍：[标题] 作者：[作者]
来源：[zlib/annas]
路径：[文件路径]
大小：[文件大小]

如果使用 Z-Library，还需提及剩余的每日下载配额。

书籍信息（仅限 Z-Library）

python3 ${SKILL_PATH}/scripts/book.py info --source zlib --id 12345 --hash abc123def

返回完整的元数据：描述、ISBN、页数、目录等。

python3 ${SKILL_PATH}/scripts/book.py config show

python3 ${SKILL_PATH}/scripts/book.py setup

错误	原因	操作
"Z-Library 未配置"	无凭据	引导用户编辑 `~/.claude/book-tools/.env`
"Z-Library 登录失败"	凭据错误或服务宕机	请用户验证凭据。Z-Library 域名会更改 — 如果持续失败，可能需要更新随附的 `Zlibrary.py` 中的域名。
"未找到 annas-mcp 二进制文件"	未安装二进制文件	运行 `setup.sh install-annas`
"Anna's Archive API 密钥未配置"	无 API 密钥	引导用户向 Anna's Archive 捐赠以获取 API 访问权限，然后将密钥添加到 `.env`
搜索超时	网络问题	重试一次。如果持续，尝试另一个后端。
"无可用后端"	两个后端均未配置	引导用户完成从步骤 1 开始的完整设置流程

场景	行为
Z-Library 宕机	自动回退到 Anna's Archive（`--source auto` 处理此情况）
Anna's Archive 不可用	仅使用 Z-Library
两者均未配置	停止并引导用户完成设置流程

Z-Library 有每日下载限制（免费账户通常为 10 次/天）。使用 info 命令在下载前检查书籍，以避免浪费配额。
Anna's Archive 需要 API 密钥才能进行搜索和下载（通过捐赠获取）。
对于中文书籍，使用 Z-Library 的 --lang chinese 参数可获得最佳结果。
如果 Z-Library 无法访问，使用 --source auto 自动回退到 Anna's Archive。
当搜索特定作者的多语言作品时，运行并行搜索（例如英文名 + 中文名），并将结果合并到一个表格中。

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

44,900 周安装

zlib-download：命令行书籍搜索下载工具，支持Z-Library和Anna's Archive

🇨🇳中文介绍

书籍工具

语言

后端

预检

相关 Skills

设置（仅首次使用）

步骤 1：安装依赖项

步骤 2：配置凭据

步骤 3：验证

凭据存储

工作流

1. 搜索

2. 向用户展示结果

3. 下载

4. 向用户报告

其他命令

书籍信息（仅限 Z-Library）

检查配置

检查后端状态

错误处理

降级处理

提示

最新 Skills