heartleo/zlib

项目介绍

zlib 是一个 Go 编写的 Z-Library 命令行客户端。它可以搜索图书，按年份、语言、格式过滤和排序，浏览收藏、推荐、热门书和下载历史，查看书籍详情与封面后下载，还能把文件推送到 Kindle 或导入微信读书。同时它提供 MCP 服务与 Claude Code、Codex 插件，让 AI Agent 也能执行这些操作。

它适合已经使用 Z-Library、习惯在终端里找书的读者，也适合希望在编程 Agent 中自动完成检索和投递的用户。日常交互由全屏 TUI 承担，底层是一组可脚本化的子命令。

安装

macOS / Linux 用 Homebrew：

brew install heartleo/tap/zlib-cli

Windows 用 winget：

winget install --id heartleo.zlib --exact

此外还有安装脚本方式（写入 /usr/local/bin，可能要求 sudo）、从 Releases 下载二进制并放进 PATH，以及从源码构建。安装文档 说明了 Go 安装和升级方式。

快速使用

需要一个 Z-Library 账号。先检测当前网络能连通哪些域名：

zlib doctor

从结果中挑一个可用域名登录，然后打开 TUI：

zlib login --domain https://z-lib.gd
zlib tui

在 TUI 里按 / 打开命令列表，选择 /search，输入书名、作者或 ISBN 后按 Ctrl+S；也可以直接输入 /search dune 再按 Enter。选中一本书按 Enter 并确认即可下载，默认目录是当前目录，下载前可以另行选择。登录信息保存在本地，之后只需运行 zlib tui。

需要脚本化输出时，给查询命令加 --json：

zlib search "dune" --ext epub --json --count 10

常用命令

用途	命令
查看收藏	zlib favorites
查看推荐	zlib recommended
查看热门书	zlib most-popular
查看下载历史	zlib history
查看账号与每日额度	zlib profile
按 id 下载	zlib download "id:hash"
发送到 Kindle	zlib kindle send ./book.epub
导入微信读书	zlib weread import ./book.epub

Kindle 投递需要配置 SMTP，微信读书采用扫码登录，两者分别见 Kindle 文档 和 微信读书文档。

接入 AI Agent

把 zlib mcp 注册为本地 stdio MCP 服务器，或安装 Claude Code / Codex 插件。前提是 zlib 在 PATH 中且已登录。以 Claude Code 为例：

claude mcp add -s user zlib -- zlib mcp

在 mcp 后加 --read-only 会隐藏下载、删除历史、Kindle 投递和微信读书导入等操作。其他客户端与参数见 MCP 服务文档。

使用约束

• 能否使用取决于是否有可连通的 Z-Library 镜像；zlib doctor 找不到可用域名或登录失败时，需要先按故障排查处理。
• 需要有 Z-Library 账号，并受其下载额度限制，zlib profile 可查看每日额度。
• 登录状态和配置保存在本地，应把会话文件视为敏感信息；提 Issue 时不要附上密码、Cookie 或会话文件。
• MCP 默认暴露会改动数据的操作，不希望 Agent 下载或删除时应使用 --read-only。
• 项目使用 MIT 许可证。

HotRepo 点评

该项目出现在 HotRepo 记录的 2026-11-15 Go 语言日榜第 10 名，当日新增 40 Star，累计约 1,966 Star；没有全语言日榜名次记录。这只是单次快照、不足以判断趋势，但说明一个 Go CLI 已经获得可见的关注度。技术上值得注意的设计是把常驻 TUI、支持 JSON 的子命令和 MCP 层放在同一个二进制里：交互浏览和 Agent 自动化共用一套实现，并用 --read-only 作为安全边界。这条边界是否够用取决于 Agent 的配置方式，把它接进 Claude Code 或 Codex 的用户应明确选择默认权限还是只读模式。