
源码系统概览
文章正文
zlib 是一个用 Go 写的 Z-Library 命令行工具,把搜书、下载与推送 Kindle 收进一个二进制文件。
它能在终端里开一个常驻界面翻页选书,也能用 search 命令加 json 参数把结果交给脚本或 AI 智能体。
仓库附带 Claude Code 与 Codex 插件,智能体首次使用时若本机没有程序会自行安装。
源码简介
仓库有两百多个文件,其中 Go 源码一百二十三个,internal 目录八十七个文件承载命令行与服务实现。
根目录按能力拆文件:客户端负责会话与请求,接口文件分别处理登录、搜索、书籍详情、推荐、收藏与历史。
客户端同时保存两种凭据:Cookie 与接口要求的用户标识请求头,登录成功后写入本地会话文件。
终端界面基于 Bubble Tea 与 Lipgloss,搜索视图自己维护视口偏移,光标停在可见行时列表不动。
文档目录二十八份材料覆盖安装、配置、排障、Kindle 投递、接口说明与主题,另有一份对官方安卓客户端 1.11.4 的静态接口调查。
站点目录是独立落地页,单个自包含页面,没有构建步骤,由 GitHub Pages 发布。
许可证为 MIT。
适用场景
习惯在终端里找书、又不想开浏览器反复登录的读者,可以用它搜完直接下载。
需要把选书流程接进脚本或智能体的开发者,可用 json 输出与随附插件。
想给 Kindle 批量送书的人,配置一次邮箱后就能用一条命令投递。
功能亮点
检索与筛选:按年份、语言与格式过滤,结果支持排序,终端与命令行两种形态共用一套参数。
图书浏览:收藏、推荐、热门与下载历史都能在界面里翻页查看。
配额可见:账号命令读出资料与当日下载余量,避免撞上限。
域名诊断:doctor 命令探测可用镜像,遇到被拦截的域名可以直接换一个。
Kindle 投递:把本地文件发到 Kindle 邮箱,邮件密码只从环境变量读取。
智能体接入:Claude Code 与 Codex 共用同一份生成的技能包,持续集成会校验生成物与源文件一致。
技术架构与部署指南
技术栈与运行环境
语言:Go,从源码编译需要 1.26 或更高版本;发行版预编译了 macOS、Linux 与 Windows 的两个架构。
终端界面:Bubble Tea 与 Lipgloss,支持自定义主题,默认是一套深色配色。
配置优先级:进程环境变量高于工作目录的 .env,再高于用户目录下的全局 .env。
网络:可配 HTTP 代理;部分域名会向非浏览器请求返回拦截跳转,需要靠诊断命令换域名。
账号:需要一个 Z-Library 账号,登录后只保存服务端下发的 Cookie,不保存密码。
安装与部署提示
包管理器:macOS 与 Linux 用 brew 安装,Windows 用 winget,一条命令完成。
安装脚本:官方提供 curl 管道脚本,默认装到系统 bin 目录,可能需要管理员权限。
源码安装:用 go install 拉取模块,记得把 Go 的二进制目录加进 PATH。
首次使用:先跑诊断命令找域名,再登录,然后打开终端界面。
离线导入:已有浏览器会话时,可导入导出的 Netscape Cookie 文件完成登录。
截图与演示说明
文档里的动图展示了终端界面的实际操作,下面按顺序说明几个可直接对照的页面。
搜索页:输入书名后列表分栏显示标题、作者、年份与格式,底部一行提示当前可用按键。
文档目录另有登录表单、书籍详情卡、下载历史与 Kindle 投递四段动图,可逐段对照。
主题页能实时预览配色,选中后用回车保存;宽终端把预览放在列表右侧,窄终端放在下方。
常见问题
问:一定要有账号吗?
要。搜索与下载都走登录态接口,未登录时客户端会直接返回需要登录的错误。
问:为什么有时搜不到或登录失败?
常见原因是当前域名被拦截。先跑诊断命令换一个可用域名,也可以用代理或导入 Cookie 的方式登录。
安全风险提示
登录后的 Cookie 与会话文件等同账号密码,请按同等强度保护,不要提交到代码仓库。
下载受版权保护的图书可能违反所在地区法律与网站条款,使用前请自行确认授权范围。
命令行会把代理、邮箱与接口域名写进本机配置,分享排障截图前注意打码。
仓库对官方安卓客户端的接口调查只是静态阅读,不能证明相关接口在当前时点仍然可用。
下载说明
本页提供 zlib 命令行工具的完整源码打包下载,含 Go 客户端、终端界面、文档、插件与落地页。
压缩包不设提取密码,预编译版本可从发布页取得,源码安装需 Go 1.26 以上。
源码采用 MIT 许可证,可自由用于个人与商业项目,请保留原始版权声明。
相关源码推荐:Koodo Reader 电子书阅读器源码 · book-to-skill 书籍转智能体技能
GitHub项目开源地址:https://github.com/heartleo/zlib