【免费下载链接】zlibrary-to-notebooklm一键将 Z-Library 书籍自动下载并上传到 Google NotebookLM项目地址https://gitcode.com/gh_mirrors/zl/zlibrary-to-notebooklm点击查看免费下载zlibrary-to-notebooklm 是一个开源的自动化桥梁工具一条命令即可把 Z-Library 上的书籍自动下载下来并上传到 Google NotebookLM让你立刻用 AI 与整本书对话。它的核心架构非常干净——Python 做编排、Playwright 负责浏览器自动化、NotebookLM CLI 负责上传三层各司其职。本文将从新手视角带你拆解这条完整链路看懂每个模块在源码中是如何协作的。先搞懂全链路一本书是怎么上车的 整条流水线可以概括为8 个阶段完整 13 步流程图见 docs/WORKFLOW.mdZ-Library 书籍链接 ↓ 1. 加载已保存的登录会话~/.zlibrary/storage_state.json ↓ 2. Playwright 启动 Chromium访问书籍页面 ↓ 3. 智能选择格式PDF 优先EPUB 备选 ↓ 4. 文件下载到 ~/Downloads ↓ 5. 格式处理PDF 直接用 / EPUB 转 Markdown ↓ 6. 词数检查超过 35 万词自动按章节分块 ↓ 7. NotebookLM CLI 创建笔记本并逐个上传 ↓ 8. 返回笔记本 ID ✅对应到源码三个脚本正好对应三个工位模块源码文件职责 登录工位scripts/login.py一次性登录并保存浏览器会话 下载工位scripts/upload.py全链路编排下载 转换 上传 转换工位scripts/convert_epub.py把 EPUB 翻译成 Markdown想快速上手安装可参考 INSTALL.md技能定义则写在 SKILL.md 和 skill.yaml 中方便作为 Claude Skill 被 AI 助手直接调用。模块一login.py 的一次登录永久使用魔法 登录脚本只有 90 来行却包含三个关键设计见 scripts/login.py持久化浏览器上下文用launch_persistent_context把整个浏览器数据目录固定到~/.zlibrary/browser_profile/cookies、缓存全部落地保存下次启动直接带着记忆打开网站。反自动化检测启动参数里带了--disable-blink-featuresAutomationControlled抹掉浏览器被 Playwright 驱动的指纹降低被风控拦截的概率。半自动 安全存储浏览器自动打开 Z-Library登录动作由人完成避开验证码等难题回终端按 ENTER 后会话写入storage_state.json并设置600权限仅本人可读写、目录700权限。这套人肉登录 机器复用的模式是浏览器自动化项目里最稳妥的登录方案。模块二upload.py 全链路编排架构核心 scripts/upload.py 是全项目的中枢核心是ZLibraryAutoUploader类主流程在 scripts/upload.py 的main()中只有三步调用downloaded_file, file_format await uploader.download_from_zlibrary(url) final_file uploader.convert_to_txt(downloaded_file, file_format) result uploader.upload_to_notebooklm(final_file)2.1 智能格式选择如何找到下载按钮download_from_zlibrary 方法处理了网站新旧两套 UI 的兼容优先级为PDF EPUB 其他PDF 保留排版AI 分析效果最好新版界面先找三点菜单按钮点开后再找PDF/EPUB选项旧版界面找data-convert_topdf转换按钮点击后轮询最多 60 秒等页面出现转换完成提示兜底策略如果都失败就扫全页所有a[href*/dl/]下载链接从 URL 里判断格式。下载环节还注册了page.on(download, handle_download)事件监听由 Playwright 统一接管下载并保存到~/Downloads万一事件没捕获到还有扫描下载目录里 2 分钟内最新文件的备用兜底。这种多层容错是自动化脚本对抗网站改版的关键。2.2 为什么用 JavaScript 点击而不是直接 click源码里点击链接用的是download_link.evaluate(el el.click())——直接执行 JS 点击可以绕过元素被遮挡、不可见等 Playwright 常规点击限制是浏览器自动化里常用的小技巧。模块三convert_epub.py 把 EPUB 翻译成 AI 友好的 Markdown NotebookLM 对纯文本的检索效果最好所以下载到 EPUB 时scripts/convert_epub.py 会接手转换用ebooklib打开 EPUB遍历所有文档项get_type() 9提取书名、作者等元数据用BeautifulSoup逐节点递归处理 HTMLh1~h6转 Markdown 标题、b/strong转加粗、ul/ol转列表、a转链接核心函数 html_to_markdown自动丢弃script、nav、svg等噪声标签并过滤掉内容不足 100 字符的空章节。依赖清单见 requirements.txtplaywright、ebooklib、beautifulsoup4、lxml 四个核心库。模块四35 万词智能分块绕开 NotebookLM CLI 的限制 NotebookLM 官方单来源上限是 50 万词但 CLI 上传大文件时容易超时所以项目选了一个实测安全值35 万词。split_markdown_file 的分块算法相当讲究先按#/##/###章节标题切分保证每一块从章节边界开始内容完整不截腰单个章节本身超过 35 万词的再按段落二次切分词数统计做了中英文兼容——中文字符逐字计数英文按单词计数count_words输出为书名_part1.md、书名_part2.md……逐块上传到同一个笔记本。例如 270 万词的大书会被切成 8 块每块约 34 万词全部上传后 AI 提问时依然当作一本书回答。模块五NotebookLM CLI 上传与 JSON 解析 上传阶段upload_to_notebooklm通过subprocess调用三条 CLI 命令完成收尾notebooklm create 书名 --json # 创建笔记本解析出 notebook ID notebooklm use notebook_id # 切换上下文 notebooklm source add 文件路径 --json # 上传来源分块则循环执行几个工程细节值得学习--json 解析 ID从输出里提取notebook.id和source.id失败时直接返回结构化错误信息方便上层或 AI Skill做重试书名清洗自动去掉文件名里的[...]、(...)杂质并截断到 50 字符保证笔记本标题干净分块容错某一块上传失败只跳过该块并继续最后汇总成功 x/y 个分块不会全盘失败。配置与安全所有状态都在 ~/.zlibrary/ 项目不落任何凭据到仓库里所有运行状态集中在家目录结构说明见 README.zh-CN.md~/.zlibrary/ ├── storage_state.json # 登录会话cookies权限 600 ├── browser_profile/ # 浏览器持久化数据权限 700 └── config.json # 账号配置备份会话过期是最高频问题处理方式就是删掉storage_state.json重新跑一遍 scripts/login.py更多问题可查 docs/TROUBLESHOOTING.md。新手阅读路线如何一步步看懂这个项目 ️建议按由外到内的顺序阅读源码约 1 小时可通读全部核心代码README.zh-CN.md—— 5 分钟了解功能与使用方式docs/WORKFLOW.md—— 对着 13 步流程图理解全链路scripts/login.py—— 最短的脚本理解会话保存机制scripts/upload.py—— 重点精读三个方法download_from_zlibrary→convert_to_txt→upload_to_notebooklmscripts/convert_epub.py—— 学习递归式 HTML→Markdown 转换写法docs/TROUBLESHOOTING.md—— 反推作者踩过的坑。总结这套架构的三大可借鉴点 ✨zlibrary-to-notebooklm 代码量不大但把浏览器自动化 文件格式处理 第三方 CLI 集成三件事串得干净利落职责单一三个脚本各管一段main()三行串起全流程读起来没有心理负担处处容错新旧 UI 双兼容、下载事件双兜底、分块上传失败不中断自动化脚本的稳定性全靠这些细节尊重限制用 35 万词分块正面解决 CLI 超时问题而不是硬扛官方限制。如果你想在自己的项目里做类似的网站自动化 → 格式转换 → AI 知识库链路这个仓库的源码结构就是很好的起步模板。⚠️免责声明本项目仅供学习研究与技术演示用途请仅用于你拥有合法访问权限的资源并支持正版阅读。赞分享【免费下载链接】zlibrary-to-notebooklm一键将 Z-Library 书籍自动下载并上传到 Google NotebookLM项目地址https://gitcode.com/gh_mirrors/zl/zlibrary-to-notebooklm点击查看免费下载相关推荐上传书籍后怎么玩zlibrary-to-notebooklm NotebookLM深度提问技巧大全上传书籍后怎么玩zlibrary to notebooklm NotebookLM深度提问技巧大全 zlibrary to notebooklm 是一个一zlibrary-to-notebooklm是什么一键将Z-Library书籍导入NotebookLM的AI知识库神器zlibrary to notebooklm是什么一键将Z Library书籍导入NotebookLM的AI知识库神器 zlibrary to noteboo登录一次永久使用zlibrary-to-notebooklm 的 Playwright 会话保存原理详解登录一次永久使用zlibrary to notebooklm 的 Playwright 会话保存原理详解 zlibrary to notebooklm 是一个创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考