structure｜1️⃣ 三级笔记、思想框架

Readwise CLI 发布：让你读过的一切，对你和你的 AI Agent 随时可用

核心信息

Readwise 官方发布了 Readwise CLI——一个命令行工具，让用户在 Readwise 中保存的所有内容（highlights、文章、PDF、书籍、YouTube、newsletters）都可以直接从终端访问。关键定位：不仅服务于你，也服务于你的 AI agents。同步发布的还有 MCP server（beta）和一个开源的 readwise-skills 技能仓库。

一、背景：Readwise 与 Readwise Reader 是什么

1.1 Readwise：让你的阅读高亮真正被用起来

核心定位：一个阅读高亮（highlights）的聚合、管理和复习工具
解决的问题：人们读完一本书，两周后就忘了关键想法。高亮了大量内容，却再也不会回头看
核心机制：
- 聚合（Liberate）：把散落在 Kindle、iBooks、Instapaper、Pocket、播客、Twitter 等各处的高亮统一到一个地方
- 复习（Retain）：基于 Spaced Repetition（间隔重复）科学方法，每天通过邮件和 app 自动推送你过去的最佳高亮，帮助你真正记住读过的东西
- 组织（Organize）：搜索、标签、收藏、笔记注释，让高亮之间产生连接
集成能力：与 Obsidian、Notion、Logseq 等笔记工具深度集成，高亮和注释可以自动同步到下游知识管理工具

1.2 Readwise Reader：为深度读者打造的全能阅读应用

定位：一个"为现代时代打造的 read-it-later 应用"，比传统的 Instapaper 和 Pocket 更强大、更灵活
核心特性：
- 全格式支持：文章、PDF、电子书、YouTube 视频（带时间同步字幕）、RSS、newsletters、Twitter 帖子——"五种不同的阅读应用合为一体"
- Ghostreader：内置 GPT 阅读助手，可以提问、定义术语、简化复杂语言
- Text-to-Speech：用逼真的人声朗读任何文档，适合在散步、开车、洗碗时消化低信息密度内容
- 全文搜索：即使只记得一个词，也能搜到，甚至离线也可以
- 键盘优先：为 power user 设计，全键盘操作——阅读、高亮、注释都不需要碰鼠标
- Triage 模式：借鉴 Superhuman 邮件收件箱清理的游戏化设计，让你高效筛选和整理积压的阅读内容
架构：Library（永久档案，高信号低噪音）+ Feed（信息流，RSS/newsletters 等持续输入）
跨平台：iOS、Android、local-first web app，全设备同步
与 Readwise 的关系：Reader 中的所有高亮和注释自动同步到 Readwise 主库，再从 Readwise 流向 Obsidian、Notion 等下游工具——形成完整的 阅读→高亮→复习→知识管理 闭环

二、Readwise CLI：核心发布内容

2.1 安装与使用

安装命令：npm install -g @readwise/cli
登录：readwise login（浏览器 OAuth），或无头模式下使用 readwise login-with-token <your-access-token>
登录后，agent 通过 readwise --help 发现所有可用命令

2.2 核心定位

"For you, and your AI agents"——这个工具的目标用户不仅是人类，更是 AI Agent
你在 Readwise 中保存的所有内容——highlights、文章、PDF、书籍、YouTube、newsletters——从终端即时可访问
兼容的 agent 环境：Claude Code、Codex、OpenClaw 等任何 AI agent

2.3 MCP Server（Beta）

如果使用 Claude Desktop、ChatGPT 等 AI 应用（非终端场景），可以通过 MCP（Model Context Protocol） 连接 Readwise
MCP server 地址：https://mcp2.readwise.io/mcp
功能覆盖：搜索高亮和文档、整理收件箱、生成阅读摘要等
CLI 和 MCP 是两条并行路径：终端用户用 CLI，GUI 应用用户用 MCP

三、readwise-skills 技能仓库

3.1 概述

开源仓库：github.com/readwiseio/readwise-skills
定位：预构建的工作流（"pre-built workflows"），你的 AI agent 可以直接运行
安装方式：npx skills add readwiseio/readwise-skills，或直接让 agent 自行安装

3.2 已发布的 Skills（11 个）

Skill	功能描述
readwise-cli	教 agent 如何使用 Readwise CLI——命令语法、设置和常用工作流
readwise-mcp	教 agent 如何使用 Readwise MCP 工具——工具名称、参数和常用工作流
triage	AI 逐篇带你过收件箱，告诉你哪些值得读、为什么
feed-catchup	批量扫描 Reader feed（RSS、newsletters、Twitter digest），挑出精华，标记其余为已读
quiz	针对刚读完的内容测试自己——"像一个同样读过这篇文章的聪明同事给你打分"
book-review	从高亮中生成长篇书评，将该书与你的更广阅读历史综合起来
reader-recap	对话式的近期阅读简报——你完成了什么、高亮了什么、说了什么
surprise-me	分析你的阅读历史，告诉你一些你自己不知道的关于自己的事
highlight-graph	将高亮可视化为交互式 2D 图谱，展示跨来源的思想连接
now-reading-page	从你的 library 生成一个 "What I'm Reading" 网页，可托管到个人站点
build-persona	从高亮、标签和阅读历史构建阅读画像（reader persona），为其他所有 skill 提供个性化基础

3.3 个性化机制

先运行 build-persona 生成 reader_persona.md 文件
其他 skills（triage、feed-catchup、quiz 等）读取这个文件，根据你的兴趣、目标和阅读风格来个性化输出

3.4 开放共建

Readwise 团队声明这些 skills 只是起点（"just a starting point, quickly hacked up"），鼓励社区提交 PR 贡献更多 skills

四、生态兼容性

4.1 支持的 Agent 平台

Claude Code：skills 路径 ~/.claude/skills/
Codex CLI：skills 路径 ~/.codex/skills/
OpenCode：skills 路径 ~/.opencode/skills/
OpenClaw：CLI 与 OpenClaw 天然兼容
Claude Desktop / Cowork：通过 plugin marketplace 安装，或通过 MCP

4.2 第三方 Skills 生态

除官方 readwise-skills 外，社区已有第三方 skill 项目（如 ryanlyn/readwise-skill），在 token 效率上声称比官方 MCP 提升 2.0x-9.4x

关键概念

Readwise：阅读高亮的聚合、间隔重复复习和知识管理平台，连接 Kindle、iBooks、Pocket 等数十个来源，并向 Obsidian、Notion 等笔记工具输出
Readwise Reader：Readwise 旗下的全能阅读应用，支持文章、PDF、电子书、YouTube、RSS、newsletters，内置 AI 助手（Ghostreader）和 TTS，定位为"为 power reader 打造的下一代 read-it-later 应用"
Readwise CLI：官方命令行工具，让终端和 AI Agent 直接访问 Readwise/Reader 中的所有数据
MCP（Model Context Protocol）：一种让 AI 应用直接访问外部服务的标准化协议，Readwise MCP server 让 Claude、ChatGPT 等可以直接操作你的阅读数据
readwise-skills：官方开源的 agent 技能仓库，包含预构建工作流（triage、quiz、book-review 等），可被 Claude Code、Codex、OpenClaw 等直接使用
build-persona：个性化基础设施——从你的阅读数据生成阅读画像文件，让所有 skills 的输出都根据你的兴趣和风格定制
Spaced Repetition（间隔重复）：Readwise 核心复习机制背后的科学方法，在合适的时间重新浮现高亮，对抗遗忘曲线
Ghostreader：Reader 内置的 GPT 驱动的阅读助手，支持提问、术语定义、语言简化等

concepts｜2️⃣ 关键概念、概念网络

agentic reading｜3️⃣ 费曼 x3