近3万星，Karakeep 0.34 发布：网页抓取更强了，支持自动离线阅读，内存占用更低
内容提要
Karakeep 0.34.0 发布，GitHub 星标近 3 万。本次更新包括：网页抓取改用 Patchright 和完整 Chrome，提升反爬与 Cloudflare 验证处理能力；移动端支持自动离线下载和完整列表离线保存；新增手动保存视频功能；修复内存泄漏，常驻内存降低约 40MB；优化数据库与搜索。注意：认证已迁移至 Better Auth，网页用户需重新登录。
延伸解读
抓取升级的实际意义
Karakeep 0.34 将浏览器自动化工具从 Playwright 换成 Patchright，并改用完整 Chrome，同时加入时区设置和真实 User-Agent。这些改动直接针对网页收藏工具最常见的失败场景：被网站识别为爬虫或卡在 Cloudflare 验证页。对经常收藏新闻、博客等有反爬机制站点的用户，抓取成功率会明显提升，保存下来的内容也更接近网页正文而非验证页面。
离线阅读的两种模式
移动端新增自动离线下载和完整离线列表两项功能。前者在打开应用时自动下载最近收藏的网页，适合通勤等网络不稳定场景；后者允许指定某个收藏列表全部保存到本地，适合提前准备大量阅读材料。需要注意的是，目前移动端商店应用还未正式更新，想用这些功能可能需要等待商店版本推送，或关注官方后续说明。
自部署用户的内存收益
官方修复了服务器查询缓存导致的内存泄漏，并改为只加载已启用功能所需的组件，预计大多数部署环境常驻内存可减少约 40MB。对在小型服务器或 Docker 中长期运行 Karakeep 的用户，这一优化能降低资源压力。同时 SQLite 数据库、标签搜索和批量索引速度也有优化，未启用 Prometheus 时基础 CPU 占用降低，整体运行更轻量。
升级前必须注意的认证变更
本次更新将身份认证从 NextAuth 迁移到 Better Auth，升级后所有网页版用户都需要重新登录一次，移动端和 API Key 不受影响。此外，如果数据库中存在仅邮箱大小写不同的账户，需要提前处理，否则可能导致无法登录。仍在使用 Browserless 的用户，官方建议迁移到 karakeep-chrome，才能获得本次反爬虫能力提升。升级前应先检查账户情况，避免登录受阻。
Q&A
Karakeep 0.34 版本在网页抓取方面做了哪些改进？
Karakeep 将浏览器自动化工具从 Playwright 更换为 Patchright，并开始使用完整的 Google Chrome 浏览器。这让 Karakeep 更不容易被网站识别为自动化爬虫，尤其是 Cloudflare 的验证页面，Karakeep 现在会自动等待验证完成，避免直接将验证页面当成网页正文保存。同时，还增加了浏览器时区设置、自动使用真实浏览器 User-Agent 等功能，进一步提高抓取成功率。
Karakeep 移动端新增的离线阅读功能有哪些？
新版本增加了两项功能：自动离线下载，打开应用时自动下载最近收藏的网页；完整离线列表，可以指定某个收藏列表，将其中的内容全部保存到本地。此外，移动端还增加了平板多栏布局、标签管理、公开列表管理、附件下载和使用统计等功能。
Karakeep 0.34 如何降低服务器内存占用？
官方修复了一个服务器查询缓存导致的内存泄漏问题，并调整了依赖加载方式，只加载已启用功能需要的组件。按照官方预计，大多数部署环境的常驻内存占用可以减少约 40MB。此外，还优化了 SQLite 数据库、标签搜索和批量索引速度，并降低了未启用 Prometheus 时的基础 CPU 占用。
升级到 Karakeep 0.34 需要注意哪些事项？
Karakeep 将身份认证系统从 NextAuth 迁移到了 Better Auth，升级后所有网页版用户都需要重新登录一次。移动端和 API Key 不受影响。另外，如果数据库中存在仅邮箱大小写不同的账户，需要提前处理，否则可能导致无法登录。对于还在使用 Browserless 的用户，官方建议迁移到 karakeep-chrome，以获得这次更新带来的反爬虫能力提升。
Karakeep 新增的 Preserve Video 功能是做什么的？
Karakeep 新增了「Preserve Video」功能，用户可以通过 yt-dlp 下载指定书签中的视频。这样，用户就可以关闭自动视频下载，只对特别想保留的视频手动执行下载。
Karakeep 0.34 在搜索和界面方面有哪些其他更新？
搜索新增 has:notes 和 has:highlights，可以筛选包含笔记或高亮内容的书签。失效链接管理页面重新设计，支持搜索、分类和批量删除。网页图片自动转换为 WebP，减少存储空间占用。修复 Android 分享书签时可能丢失或重复的问题。MCP Server 升级至新版 SDK，CLI 内置官方 Agent Skill。更新网页界面，支持跟随系统切换深色模式。
