# zlib 快照（抓取日期 2026-10-05）

- 项目：https://github.com/heartleo/zlib（Go，MIT 开源，617 star / 48 fork）
- 官网：https://zlib.heartleo.dev
- 一句话：Z-Library 命令行客户端——终端里搜书、下载、推送 Kindle。

## 功能

- 交互式搜索（上下浏览、左右翻页、回车下载）
- 按书 ID 下载，实时进度
- 下载历史浏览（含重新下载）
- `zlib profile` 查看每日下载额度
- `zlib kindle` 推送到 Kindle 邮箱
- 主题（mocha/latte/dracula/tokyo/nord/gruvbox）
- 代理与自定义镜像域名支持（`ZLIB_PROXY`、`ZLIB_DOMAIN`）
- Claude Code 插件：`/plugin marketplace add heartleo/zlib` 后 `/plugin install zlib@zlib-plugin-cc`，`/zlib "书名"` 搜索下载，`/zlib:kindle` 推送
- Codex 插件：`codex plugin marketplace add heartleo/zlib` + `codex plugin add zlib@zlib`

## 安装

```sh
# macOS / Linux（Homebrew）
brew install heartleo/tap/zlib
# Windows
winget install heartleo.zlib
# 通用
curl -fsSL https://raw.githubusercontent.com/heartleo/zlib/main/install.sh | sh
```

## 上手（关键：先设 ZLIB_DOMAIN）

Z-Library 镜像经常变，先探测可用镜像：

```sh
zlib doctor --eapi
export ZLIB_DOMAIN=https://z-lib.gd   # 选 doctor 报 healthy/challenged 的
zlib login --eapi
zlib search "dune"
```

登录后域名会写入 `~/.config/zlib/.env`，下次不用重设。

## 常用命令

```sh
zlib search "dune" --ext epub        # 搜书，可按格式过滤
zlib download <ID> --dir ~/Downloads # 按 ID 下载
zlib download <ID> --send-to-kindle  # 下载并推送 Kindle
zlib history                          # 下载历史
zlib profile                          # 每日额度
```

## 注意

- 需要 Z-Library 账号登录；免费账号每日下载有限额。
- 镜像域名失效是最常见的故障原因，用 `zlib doctor --eapi` 重测。
- 国内网络建议配代理：`export ZLIB_PROXY=http://127.0.0.1:7890`（示例，按自己代理填）。