reader-deep-dive

🤿 激活你的阅读记忆档案

🥥5总安装量 2评分人数 1
100% 的用户推荐

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

B

存在边界风险,建议在隔离环境中验证

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ 敏感信息处理规范:Readwise Token 与 WhatsApp 目标号码均通过环境变量注入,脚本启动时强制检查非空,无硬编码风险
  • ✅ 数据全程本地处理:用户阅读内容经内存管道流转,无持久化存储、无第三方中间服务器,隐私保护良好
  • ⚠️ LLM 输出未完全过滤:Gemini 生成的搜索查询与简报内容仅经简单换行删除处理,建议添加长度限制与字符白名单验证
  • ⚠️ 消息发送缺乏内容校验:发送至 WhatsApp 的简报内容直接来自 LLM 输出,未经验证,存在潜在注入或滥发风险(实际影响有限)
  • ✅ 权限最小化:仅需出站 HTTPS、环境变量读取、本地 LLM 调用及文件读取,无文件写入、无系统级操作、无特权命令

使用说明

核心用法

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 内容

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