终端里的 Z‑Library

Name: zlib
Author: heartleo

搜书、下载、发送到 Kindle，全程不用离开终端。

brew install heartleo/tap/zlib

Go 1.25+ macOS · Linux · Windows MIT

zlib search 点击后可用 ↑ ↓ ← → ⏎

$ brew install

挑一个包管理器。

每个版本都发 macOS、Linux、Windows 的预编译二进制。也可以自己编译，就一个 Go module。

然后跑 zlib doctor --eapi 挑一个可用域名

接着zlib login --eapi，再 zlib search

$brew install heartleo/tap/zlib

macOS 和 Linux。用 brew upgrade zlib 升级。

>winget install heartleo.zlib

Windows 10 及以上，PowerShell 或 Terminal 都行。

$curl -fsSL https://raw.githubusercontent.com/heartleo/zlib/main/install.sh | sh

自动识别系统和架构，把二进制放进 PATH。

$go install github.com/heartleo/zlib/cmd/zlib@latest

需要 Go 1.25 及以上。

$ git clone https://github.com/heartleo/zlib
$ cd zlib
$ go build -o zlib ./cmd/zlib

用标准 Go 工具链就能编译。make test 跑测试。

$ zlib --help

八条子命令，都能写进脚本。

search、history、profile、doctor 都支持 --json，手敲和写脚本用的是同一个工具。点一条看它输出什么。

kindle 通过你自己的 SMTP 服务器把文件发送到 Kindle 邮箱，配置说明在这里（英文）。

zlib search

/plugin install

交给你的编码 agent。

zlib 自带 Claude Code 和 Codex 插件。Agent 调用的是同一个二进制，读的是同一份 --json 输出。

Claude Code

装上 marketplace，然后直接报书名。

/plugin marketplace add heartleo/zlib
/plugin install zlib@zlib-plugin-cc

/zlib "the pragmatic programmer" 搜索并下载，/zlib:kindle 转寄 Kindle。

Codex

纯 skills 插件，不需要常驻 MCP server。

$ codex plugin marketplace add heartleo/zlib
$ codex plugin add zlib@zlib

让 Codex 找书，或者把自带的 Kindle skill 指向本地文件。

$ zlib doctor

镜像站不让进的时候。

现在大多数 Z-Library 网页域名都挂在 DiamWall 后面。先跑 doctor。它不用登录，也不动你已经存好的会话，把所有已知镜像探一遍，然后告诉你哪些还能用。

healthy正常响应，可以直接用

challenged返回了 JS 工作量证明，客户端会自动解掉

diamwall_blocked被拦截了，换一个

redirect_loop重定向绕不出去

network_errorDNS、TLS、超时或连接重置，试试代理

zlib doctor --eapi

$ zlib theme

选一套，或者跟着终端走。

这些配色你的编辑器多半已经在用了，zlib theme auto 会读终端背景色自己挑。这个页面用了其中两套：亮色 latte，暗色 mocha。