30秒速读：在终端里找书、下载、发到阅读器，来回切换工具很打断节奏。本篇介绍一款命令行工具，把检索、下载和发送 Kindle 收拢到终端里完成。
zlib 是一款面向终端的 Z-Library 命令行工具，用 Go 编写、MIT 协议开源，由开发者 heartleo 维护。它把图书检索、文件下载和投递 Kindle 收拢到命令行里完成，提供常驻终端界面和一批子命令，基于 Go 1.26 以上、单模块即可编译，也做成插件接给 Claude Code、Codex 等 AI Agent。
场景痛点
习惯待在终端里的人，找书时还要切到浏览器、翻网页、登录、再手动下载附件，动作被打断好几层。命令行里没有顺手的检索入口，想把书直接送进 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，密码不进对话。
开源地址
GitHub 国内访问较慢，如打不开可多刷新几次
项目官网：https://zlib.heartleo.dev/
软件信息
| 项目 | 内容 |
| 版本 | 以官网为准 |
| 大小 | 以官网为准 |
| 平台 | 终端命令行工具，需 Go 1.26 以上编译 |
| 语言 | 以官网为准 |
| 更新日期 | 以官网为准 |
版本对比与推荐
| 版本 | 适合人群 | 说明 |
| 最新公开版 | 大多数用户 | 功能与修复最新，稳定优先，推荐使用 |
| 历史旧版本 | 旧系统或特殊兼容需求 | 仅在新版无法运行时考虑，对比后按需回退 |
版本推荐：优先使用最新公开版；从源码编译时先确认本机 Go 版本达到 1.26 以上。
安装步骤
- 前往官方仓库获取源码或发布包，以官网为准
- 按官方说明完成编译或安装，确认终端能正常启动常驻界面
- 首次使用先做一次网络诊断，确认检索链路通畅后再批量操作
安装细节以官网为准，遇到系统拦截提示时先核对安装包来源是否为官网或官方仓库。
必改设置
- 本地登录态：入口在工具的登录或账号配置里，按官方说明完成本地登录态配置，凭据只保存在本机，不要写进公开脚本（通用建议）。
- 下载目录：入口在工具的下载或存储配置里， заранее定好存放目录，批量下载后按目录归档更易查找（通用建议）。
- Kindle 投递地址：入口在工具的投递或设备配置里，投递前先核对接收地址是否正确，避免文件发错设备（通用建议）。
- 脚本输出格式：入口在搜索或输出配置里，需要批量处理时优先用结构化输出，方便后续筛选与归档（通用建议）。
常见问题
- 支持哪些书源与格式？以官方说明为准，下载前先确认目标图书的版权状态，只获取自己有权使用的内容。
- 编译失败怎么办？先确认 Go 版本是否达到 1.26 以上，再按官方说明检查模块与网络配置。
- 发送 Kindle 失败怎么办？先检查接收地址与网络诊断结果，确认投递链路无误后再重试单本。
- 能接给 AI Agent 用吗？据原文说明，可做成插件接给 Claude Code、Codex 等 Agent，具体接入方式以官网为准。
注意事项
- 只获取自己有权使用的图书内容，尊重版权与平台规则。
- 批量下载前先小批量验证目录与格式，跑通后再放大批量。
- 账号凭据只保存在本机，调试输出不要包含敏感信息。
关注「软件教程管家」
回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。
本站资源仅供个人学习交流，请勿用于商业用途。软件与资料版权归原作者所有；如有侵权，请通过公众号「软件教程管家」联系我们，我们将在 24 小时内下架处理。查看免责声明 ›
