zlib:在终端里搜书、下书,顺手推到 Kindle 和微信读书

一、这个项目解决的是什么问题

在终端里找电子书,一直是个别扭的事。网页版要开浏览器、过验证、点一堆跳转;想批量下几本想看的书,就得反复在页面和文件管理器之间切。zlib 这个项目把这些动作收进了一个命令行工具:搜、看详情、下载、管历史、发到 Kindle、发到微信读书,都在终端里完成。

当前版本 v0.0.15,MIT 许可,星标三千二百多,用 Go 写的。作者给它的定位是「给你和你的 AI agent 用的 Z-Library 命令行客户端」,所以它除了给人用,还专门做了给 agent 调的接口。

先把最重要的话放在前面:它本身只是一个客户端,内容来自 Z-Library。Z-Library 上的很多书是有版权的,能不能下、下了能不能用,取决于你所在地区的法律和这本书的授权状态。这个工具不会改变这件事,它只是把操作变快了。自己承担判断,别把工具当成授权。

二、核心设计机制

第一层是单二进制。Go 编译出来一个可执行文件,没有运行时依赖,装完就能跑。所以它同时有 Homebrew、安装脚本、winget 和直接下二进制四条安装路径,随便挑一条。

第二层是镜像探测。Z-Library 的域名经常变,不同网络能连上的也不一样。所以它有个 zlib doctor 命令,专门测哪些镜像在你的网络里通,输出一个可用列表。登录时必须显式指定一个域名,就是这个原因——它不猜,让你从实测结果里挑。

第三层是本地会话。登录之后凭据存在本地,后续只跑 zlib tui 就能进,不用每次输密码。代价是这份会话文件本身就是敏感数据,别往仓库里提交,别丢到共享目录。

第四层是双形态输出。同一个命令,给人看是表格,给脚本看加 --json 就是结构化数据。这个设计让它能同时服务终端用户和自动化流程,也是它敢说自己给 agent 用的底气。

三、功能拆解

搜索是核心。支持按年份、语言、格式过滤,结果能排序、能翻页。命令行的写法是 zlib search "dune" --ext epub,加 --json --count 10 拿十条结构化结果。在 tui 里按 / 打开命令列表选 search,输入标题、作者或者 ISBN,Ctrl+S 提交。

浏览有四条线:收藏、推荐、热门、下载历史。对应 zlib favorites、zlib recommended、zlib most-popular、zlib history 四条命令。想看自己的账号状态和当日下载额度,用 zlib profile。

下载是 zlib download "id:hash",把 id:hash 换成搜索结果里那本书的完整 id。默认下到当前目录,下载前可以改目录。

周边能力有三块。封面能在终端里显示,前提是终端支持 Kitty graphics 或 Sixel,并且至少一百列二十行,不满足就只显示文字。元数据能查能改,zlib meta book.epub 看现状,加 --fetch 联网查,用 -t -a 改标题作者,加 --rename 顺带改文件名。投递能发 Kindle(zlib kindle send)也能发微信读书(zlib weread import)。

四、适合谁,不适合谁

适合已经在终端里干活的人。搜索、下载、发 Kindle 一条链走完,不用切窗口,这是它最实在的价值。

适合要批量处理的人。--json 输出加上脚本,几十本书的信息整理成表格很快,比一页页点网页省事得多。

适合用 Claude Code、Codex、Grok 这类工具的人。它提供了插件和 MCP 服务两条接入路径,插件带技能和 MCP,MCP 是 zlib mcp 起的本地 stdio 服务。

不适合完全不用命令行的人。它没有图形界面,tui 再友好也是键盘操作,习惯鼠标的人会觉得别扭。

不适合想找一个「合法电子书来源」的人。它不是书源,是客户端。这个区别很重要。

五、几个需要提前知道的限制

第一,必须有 Z-Library 账号,而且得先找到一个你网络能连上的域名。没账号连登录这一步都过不去,这不是能绕的。

第二,域名和网络是最大的不确定项。zlib doctor 能测出哪些通,但如果你的网络里一个都不通,就得配代理。项目支持配代理和自己信任的镜像,配置在 /config 里。这部分会随网络环境变化,具体以项目文档为准。

第三,版权风险要自己担。Z-Library 的藏书里有大量受版权保护的作品,下载和传播的合法性取决于你所在地的法律和具体用途。这个工具让下载变得非常容易,容易本身就是风险——批量下几百本放在那里,和买一本看一本,性质不一样。作者在文档里没有替你处理这件事,也不会处理。

第四,封面显示挑终端。Kitty graphics 或 Sixel 二者之一,还要至少一百列二十行,否则退化成纯文字。这不是 bug,是终端能力限制。

第五,会话文件是敏感数据。登录状态存在本地,泄露等于账号被人用。报 bug 时作者明确要求附上 zlib version、系统、命令和报错,但要去掉密码、cookie 和会话文件。

六、项目现状

v0.0.15,MIT 许可,Go 编写,星标三千二百多。Homebrew 的 formula 名字从 zlib 改成了 zlib-cli,命令还是 zlib,这一点很多人会踩——照着旧教程 brew install zlib 装不上,要用 brew install heartleo/tap/zlib-cli。

安装有四条路:Homebrew、安装脚本(装到 /usr/local/bin,可能要 sudo)、Windows 的 winget、以及从发布页下二进制自己放进 PATH。升级有 zlib update。

agent 接入这块做得比较全,Claude Code、Codex、Grok 三家都有插件市场命令,也都能直接注册 MCP 服务。MCP 加 --read-only 会隐藏下载、删历史、发 Kindle、导入微信读书和改元数据这些写操作,只留查询。这个开关在给别人用的时候很有用。

文档分得比较细,安装、用法、终端界面、封面、元数据、配置、主题、Kindle、微信读书、MCP、排错各有一页。遇到问题先翻排错那一页,登录失败和网络问题都在里面。

七、常见问题

问:没有 Z-Library 账号能用吗?

答:不能。登录是前置条件,搜索和下载都要账号。唯一不需要登录的是 zlib meta 的元数据查询,那部分走的是公开的图书信息源。所以第一步是注册账号,第二步是 zlib doctor 找可用域名,第三步才是 zlib login --domain 加地址。

问:zlib doctor 一个域名都测不通怎么办?

答:那是你的网络到这些镜像都不通,不是工具坏了。两个方向:配代理,或者用自己能访问的镜像地址。配置都在 /config 里,也可以直接改配置文件。这块随网络环境变化很大,别人的可用地址对你不一定有效,以项目文档和排错页的说明为准。

问:brew install zlib 报找不到怎么办?

答:formula 改名了。现在叫 zlib-cli,命令还是 zlib。正确的写法是 brew install heartleo/tap/zlib-cli。这个改名在文档里专门用醒目块标出来了,但旧教程还在流传,照着抄就会卡在这一步。

问:下载的书有版权问题吗?

答:这个必须说清楚:工具是客户端,书来自 Z-Library,上面有大量受版权保护的作品。下载、传播、商用的合法性取决于你所在地的法律和具体用途,工具不改变这件事,也不提供任何授权。它把操作变简单了,但判断仍然在你。建议只用于明确允许的用途,比如公版书、自己已购买的书的备份、或者授权明确的资料。

问:封面在终端里显示不出来。

答:两个条件都要满足:终端支持 Kitty graphics 或 Sixel,并且窗口至少一百列二十行。缺一个就只显示文字。macOS 上的 iTerm2、Kitty 支持得比较好,系统自带终端一般不行。窗口太窄也会退化,先把窗口拉大再试。

问:怎么让 AI agent 用它?

答:两条路。一是装插件,Claude Code 用 /plugin marketplace add heartleo/zlib 再 /plugin install zlib@zlib-plugin-cc,Codex 用 codex plugin marketplace add heartleo/zlib 再 codex plugin add zlib@zlib。二是注册 MCP,把 zlib mcp 当本地 stdio 服务加进去,前提是 zlib 在 PATH 里并且已经登录。登录这一步要你自己做,别把密码交给 agent。

问:MCP 怎么限制权限?

答:在 mcp 后面加 --read-only,它会隐藏下载、删历史、发 Kindle、导入微信读书和改元数据这些写操作,只留查询类工具。给别人用、或者让 agent 自由跑的时候建议开着。不加的话 agent 理论上能替你下书、删历史、往外发文件,这些动作一旦发生不好追。

下载地址

夸克网盘(永久有效):https://pan.quark.cn/s/22b9858ea553

本教程由「宝藏星球屋」整理,更多软件、游戏、开源项目都在 https://cbge.top。

本站全部免费,如果觉得内容有用,可打赏支持服务器续费打赏支持
固定文章缩略图

新人必看的入站详细说明指南

解决的你的各种疑难杂症以及各种相关教程

前往查看 »
© 版权声明
THE END
喜欢就支持一下吧
点赞23 分享
评论 抢沙发
头像
欢迎您留下宝贵的见解!
提交
头像

昵称

取消
昵称表情代码图片

    暂无评论内容