核心用法
weread-import 是一款专为微信读书设计的笔记导出与同步工具，主要面向 Obsidian 等 Markdown 知识库用户。通过 CLI 方式运行，支持单本或批量导出书籍划线与笔记。
关键操作流程：
1. 首次运行自动安装 Node.js 依赖
2. 内置 Chrome CDP 自动启动与 Cookie 刷新机制
3. 默认 --mode api 获取完整元数据（作者、bookId、划线数等）
4. 输出标准 Markdown 文件，含 YAML frontmatter 元信息
5. 支持 --force 强制重渲染、增量跳过、删除归档等高级特性
显著优点：
- 自动化 Cookie 管理：优先使用
--cookie-from browser自动从 Chrome CDP 提取并刷新 Cookie，避免手动维护过期问题 - 完整的元数据：API 模式返回作者、书籍ID、划线统计等结构化数据
- 非侵入式浏览器集成：使用
disconnect()而非close()，不干扰用户正常浏览 - 智能合并策略：支持新增/更新/保留/删除四种分类，删除条目归档至
## 已删除 - 模板化输出：支持自定义 frontmatter tags，与 Obsidian 等工具生态无缝衔接
潜在局限：
- 运行环境依赖：需 Node.js + Playwright，首次执行有安装耗时
- 浏览器登录态前置：CDP 模式要求 Chrome 已登录微信读书，定时任务场景下登录过期会导致失败
- Chrome 版本限制：146+ 版本需非默认
--user-data-dir，虽脚本自动处理但增加复杂度 - 仅限微信读书：不支持多平台读书笔记聚合
- 定时任务限制：严格禁止加
--force、硬编码 cookie 等操作，灵活性受限
适合人群：
- Obsidian/Notion 等双链笔记用户，希望自动化同步微信读书笔记
- 需要结构化元数据（书籍分类、作者、阅读进度）进行知识管理的读者
- 有一定技术基础、能接受命令行操作的效率工具使用者
常规风险：
- 微信读书 API 可能因官方策略调整而失效
- 频繁 API 调用存在账号风控理论风险（脚本已做时间戳防缓存优化）
- 浏览器 CDP 模式需保持 Chrome 运行，占用系统资源
- 定时任务失败时（登录过期）需人工介入重新授权