zlib — Z-Library 命令行搜书下载并发送 Kindle，终端与 AI Agent 都能用

zlib 是一款面向终端的 Z-Library 命令行工具，用 Go 编写、MIT 协议开源，由开发者 heartleo 维护。它把图书检索、文件下载和投递 Kindle 收拢到命令行里完成，提供常驻终端界面和一批子命令，基于 Go 1.26 以上、单模块即可编译，也做成插件接给 Claude Code、Codex 等 AI Agent。项目属于开源软件，源码放在 GitHub，同时以开源项目的形式公开发布。

场景痛点

习惯待在终端里的人，找书时还要切到浏览器、翻网页、登录、再手动下载附件，动作被打断好几层。命令行里没有顺手的检索入口，想把书直接送进 Kindle 也要另开邮件客户端处理，浏览器标签页开了一串，登录态还时常掉线，找到的文件也要手动挪进阅读器。效率工具想省掉的就是这些来回切换。

主要功能特点

🔍 搜索 ——按年份、语言和格式筛选;排序结果
📚 浏览 ——收藏、推荐、热门书籍和下载历史
📥 下载 — 查看书籍详情并选择下载目录
📖 发送到 Kindle —— 将文件发送到你的 Kindle 地址
🕒 个人资料 ——查看你的每日下载配额
🎨 主题 — 将颜色主题与 /theme 切换
🌐 网络 ——用zlib doctor 找到可用的镜像，或者使用代理
🤖 AI 代理集成 ——通过代理插件与 Claude Code 和 Codex 集成

常驻终端界面搜书

运行zlib tui 打开常驻终端界面，每页底部列出可用按键。按 / 弹出命令列表，覆盖搜索、收藏、历史、账号、设置、主题；j/k 选择图书，←/→ 翻页，Ctrl+F 改查询和过滤，Enter 下载先确认，Esc 返回，/quit 退出。它是偏阅读器场景的终端入口，带电子书阅读器式的浏览节奏。

搜索筛选与脚本输出

搜索可按年份、语言和格式筛选，结果支持排序。命令行里zlib search “dune” –ext epub 直接输出表格，加 –json 输出供脚本使用的 JSON，–count 限定条数；下载时把 id:hash 换成结果里书籍的完整 id 即可。这套参数化检索是下载工具的常见做法，也让软件工具能被脚本串起来调用。

收藏、推荐、热门与下载历史

zlib favorites 浏览收藏，recommended 看推荐，most-popular 看热门，history 翻下载历史，profile 查看账号与每日下载配额。这些列表在 TUI 和命令行两边都能进，不用回网页再找。/theme 切换配色，/config 管网络、下载和 Kindle，是工具推荐里可长期挂着用的命令行产品。

下载并发送到 Kindle

选中图书确认后开始下载，默认落到当前目录，也能在下载前选其他目录。Kindle 一侧先按文档配好 SMTP 和投递邮箱，再用zlib kindle send ./book.epub 把文件发过去，全程不离开终端。预编译二进制覆盖 macOS、Linux、Windows，是一款跨平台应用，不同系统的安装方式各自独立。

网络诊断与本地登录态

zlib doctor 先检测当前网络可用的镜像域名，把结果填进zlib login –domain，再在表单输入邮箱密码；登录状态保存在本地，后续直接zlib tui。已有浏览器会话的，也能按排障指南导入 Cookie 登录。工具支持代理，没有可用域名或登录失败时查排障指南。这部分是开发者工具常见的网络自检思路，也归入实用软件的网络适配环节。

安装与升级

macOS、Linux 用 brew install heartleo/tap/zlib，或跑安装脚本；Windows 用 winget install –id heartleo.zlib，也能从 Releases 下预编译二进制放进 PATH。Go 安装、源码编译见指南，zlib update 沿用原安装方式升级。

接入 Claude Code 与 Codex

装好插件后 Agent 也能调 zlib，没装时首次使用会自行安装。Claude Code 用 marketplace add 再 install，Codex 用 codex plugin add，之后让 Agent 搜某本书的 EPUB、先列结果再下载。登录自己跑zlib login，密码不进对话，这是 AI工具接入的凭据边界。

官方网站

官网 https://zlib.heartleo.dev/

GitHub https://github.com/heartleo/zlib

下载地址

https://pan.quark.cn/s/faf77f403618

zlib — Z-Library 命令行搜书下载并发送 Kindle，终端与 AI Agent 都能用

场景痛点