reader-deep-dive

🤿 激活你的阅读记忆档案

基于 Readwise API 的个人阅读管理工具,通过本地 LLM 分析近期阅读主题并关联历史存档,生成 WhatsApp 深度简报,帮助用户建立知识时间线。

收藏
5.4k
安装
2.3k
版本
v0.1.0
CLS 安全性认证2026-05-14
点击查看完整报告 >

使用说明

核心用法

Reader Deep Dive 是一款面向知识工作者的个人阅读管理自动化工具。用户配置 Readwise API Token 后,该技能每日扫描用户最近 24 小时保存至 Readwise Reader 的文章,调用本地 Gemini LLM 提取核心主题,进而搜索用户阅读档案库中 3 天、3 个月乃至数年前的相关内容,最终生成一份按时间线组织的「深度阅读简报」,通过 WhatsApp 推送至用户手机。

使用方式灵活:既可手动执行 bash scripts/brief.sh 触发,也可通过 clawdbot cron 设置定时任务(如每日下午 2 点自动运行)。提示词模板开放于 prompts// 目录,支持用户自定义简报风格。

显著优点

知识连接能力是该技能的核心价值。区别于简单的阅读列表同步,它主动挖掘用户历史存档中的主题关联,将「我曾在某处保存过」转化为可视化的思考演进时间线,有效对抗「数字囤积症」。

架构简洁可信:全程本地处理,数据经 HTTPS 直传 Readwise 官方 API,无第三方中间服务器,用户阅读内容不落盘、不持久化,隐私风险极低。敏感凭证(API Token、WhatsApp 目标号码)均通过环境变量注入,无硬编码隐患。

低门槛集成:依赖均为标准 Unix 工具(curl、jq、bash),无需复杂运行时环境;WhatsApp 推送借助 clawdbot 框架,配置一次即可复用。

潜在缺点与局限性

LLM 输出不可控:主题分析依赖 Gemini 的推理质量,若近期保存文章主题分散或语义模糊,生成的搜索查询可能偏离用户真实兴趣,导致历史关联结果相关性下降。简报内容同样由 LLM 生成,存在事实性错误或过度解读的风险。

单一数据源锁定:深度关联能力完全依赖 Readwise 的搜索 API,若用户阅读内容分散于 Pocket、Instapaper、Notion 等平台,则无法形成完整的知识图谱。

无持久化与回溯:简报生成后即推送,本地不保留历史记录,用户若未保存 WhatsApp 消息,则无法回顾往期的主题分析结果。

网络与 API 依赖:Readwise API 的可用性、速率限制及未来接口变更均可能影响技能稳定性;目前脚本缺乏重试与降级机制。

适合的目标群体

  • 重度 Readwise 用户:已建立规模化阅读存档(数百篇以上),希望激活「沉睡」历史内容的学者、研究员、知识型创作者。
  • 主题式学习者:围绕特定领域(如 AI、投资、心理学)持续输入,需要周期性回顾思考脉络的终身学习者。
  • 信息焦虑管理者:收藏即遗忘、希望降低阅读 FOMO(错失恐惧)的职场人士。

使用风险

  • 性能风险:若用户存档规模极大(数万篇),Readwise API 搜索响应可能延迟,导致脚本执行超时;建议关注 API 分页与超时配置。
  • 依赖项风险gemini CLI 工具为本地外部依赖,其版本、配置及可用性直接影响技能运行;需确保本地环境已正确配置 Google Gemini API 凭证。
  • 内容准确性风险:LLM 生成的主题关联与简报总结可能包含错误推断,用户应批判性阅读,不宜直接作为学术引用或决策依据。
  • Token 泄露风险:虽脚本本身安全处理环境变量,但用户若在共享环境或日志中打印 $READWISE_TOKEN,仍存在泄露可能;建议使用只读权限的 Token 并定期轮换。

安全解读

核心用法

Reader Deep Dive 是一款面向深度阅读者的个人知识管理工具,核心功能是将用户"最近保存的内容"与"历史阅读存档"进行智能关联,生成高信号值的每日简报。

典型工作流:

  • 扫描 Readwise Reader 最近 24 小时的"新收藏"
  • 通过系统默认 LLM 识别当前阅读主题与关注焦点
  • 在时间维度上横向搜索(3天前、3个月前、数年前)的关联内容
  • 通过 WhatsApp 推送"Deep Dive"简报,呈现该主题的思考演进时间线

触发方式:支持手动执行 bash scripts/brief.sh 或配置 Cron 定时任务(如每日 14:00 自动运行)。

---

显著优点

1. 解决"收藏即遗忘"痛点
大多数用户的阅读列表是"只写不读"的坟墓。该工具通过主动关联历史内容,将静态收藏转化为动态知识网络。

2. 时间线叙事价值
不同于简单的"相似文章推荐",它刻意设计跨时间尺度的关联(近期→中期→长期),帮助用户看见自己认知的演进轨迹。

3. 极简架构,低耦合
纯 Bash 脚本实现,依赖外部 CLI 工具(curl/jq/gemini/clawdbot),无复杂运行时,易于审计和自定义。

4. WhatsApp 原生集成
简报直接推送至 IM 工具,阅读场景自然嵌入日常信息流,降低回顾门槛。

---

潜在缺点与局限性

1. 外部依赖较重
依赖 4 个外部 CLI 工具(curl、jq、Google Gemini CLI、clawdbot),任一工具缺失或版本不兼容将导致执行失败。目前缺乏依赖预检机制。

2. URL 编码实现简陋
使用 ${QUERY// /%20} 仅处理空格编码,对 &、?、= 等特殊字符支持不足,可能构造错误请求。

3. 无超时与容错机制
curl 和 gemini CLI 调用均未设置超时,网络异常时可能无限挂起;失败时缺乏有意义的错误提示。

4. 隐私数据流转
阅读标题、摘要等元数据需经过 Google Gemini API 进行主题分析,对云端 LLM 敏感的用户需知悉此点。

5. 定制化门槛
虽然支持修改 prompts/briefing.txt,但核心逻辑(时间维度切片、关联算法)封装在脚本中,非开发者难以深度定制。

---

适合人群

  • Readwise 重度用户:已积累数百至数千条阅读存档,希望激活历史资产
  • 主题研究者:需要在某一领域持续跟踪、建立长期认知地图
  • 知识管理实践者:信奉"渐进式归纳"或"第二大脑"理念,重视笔记间的上下文关联
  • 技术极简主义者:偏好可审计的 Bash 方案,而非黑箱式 SaaS 工具

---

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 令牌泄露 | 中 | `READWISE_TOKEN` 以环境变量存储,需确保 `.bashrc` 或部署环境权限正确 |
| API 可用性 | 低 | Readwise API 或 Gemini API 服务中断将影响功能 |
| 数据残留 | 低 | 简报内容通过 WhatsApp 发送,消息历史留存于 Meta 服务器 |
| 版本漂移 | 低 | gemini CLI 或 clawdbot 更新可能引入不兼容变更 |

建议生产环境加固: 添加依赖预检脚本、替换 URL 编码方案、为网络请求设置 30 秒超时、定期(季度)审计依赖项安全公告。

reader-deep-dive 内容

prompts文件夹
scripts文件夹
手动下载zip · 5.9 kB
analyze.txttext/plain
请选择文件