用途:这是一个用于从 Z-Library 和 Anna's Archive 搜索、查找并下载书籍、论文与电子书的技能,通过统一的命令行工具完成多来源检索与下载。
两个后端:zlib 对应 Z-Library(EAPI),需要邮箱与密码,目录最大、支持直接下载;annas 对应 Anna's Archive,需要(捐赠获得的)API Key,聚合多来源与多个镜像。
使用前先运行预检命令检查环境:python3 ${SKILL_PATH}/scripts/book.py preflight,返回 JSON 显示依赖与凭据是否就绪。若 ready 为 true 可直接进入工作流;否则按提示修复。依赖缺失时可运行 bash ${SKILL_PATH}/scripts/setup.sh install-deps 安装 requests;annas 二进制缺失时运行 bash ${SKILL_PATH}/scripts/setup.sh install-annas。
凭据存放于 ~/.claude/book-tools/.env,包含 ZLIB_EMAIL、ZLIB_PASSWORD 与可选的 ANNAS_SECRET_KEY。首次成功登录 Z-Library 后,会话令牌会缓存到 ~/.claude/book-tools/config.json,该文件自动管理、不要手动编辑;登录异常可删除它后重新登录。不要在对话中直接索要用户凭据,应让用户自行编辑 .env 并确认。
工作流为搜索→选择→下载。搜索示例:python3 ${SKILL_PATH}/scripts/book.py search "machine learning" --limit 10;可加 --source zlib --lang english --ext pdf;中文书用 --lang chinese。结果以 JSON 输出,随后以编号表格呈现给用户选择。下载示例:zlib 需 id 与 hash,annas 需 MD5 hash 与文件名,均用 -o 指定目录。其他命令包括 info(仅 Z-Library,返回描述、ISBN、页数、目录等元数据)、config show、setup。
限制与提示:Z-Library 免费账号通常每日下载约 10 本,可先用 info 查看再下载以节省额度;Anna's Archive 的搜索与下载都需要 API Key(通过捐赠获得);zlib 不可达时可用 --source auto 自动回退到 annas;两者都未配置则需走完整安装流程。Z-Library 域名会变化,长期登录失败时可能需要更新内置的 Zlibrary.py 域名。