前言¶
微信读书里的划线、想法、书评和阅读进度，默认都留在 App 里。想按书整理成 Markdown、在本地检索，或用一个页面浏览已导出的内容，往往要手动复制，或自己写脚本对接接口。下面介绍 SkillHub 上的社区 Skill「微信读书评论、划线拉取」（@user_568e5b5e/weread-sync，v1.0.0），它把官方 CLI weread-sync 的登录、增量同步和 demo 浏览写进 Agent 工作流，用自然语言即可触发。
这是什么¶
一句话定位：在 Cursor 等支持 Skills 的 Agent 里，当你要查微信读书的书籍、划线、笔记、书评、阅读状态，或要把数据同步到本地 Markdown、打开本地可视化 demo 时，由 Agent 按固定流程调用 weread-sync。
- 出品与托管：社区来源（community），发布者
user_568e5b5e，SkillHub 分类为data-analysis。 - 依赖关系：Skill 本身不声明
requires_api_key；实际数据拉取依赖本机全局安装的 npm 包weread-sync，登录态保存在本地。 - 官方入口：SkillHub 技能页、API 坐标页。
核心功能¶
以下能力与安装包内 SKILL.md 一致，均通过 weread-sync 子命令完成（支持 --json 输出 JSON）：
- 登录与状态：
login扫码登录；status查看登录与同步状态、已同步书籍数；logout清除本机登录态。 - 书籍与阅读状态：
notebooks列出有笔记/划线的书；books-status按reading/finished/other分类；book-probe实时拉取单本书详情、划线、书评、章节。 - 导出与同步：
sync将书籍导出为本地 Markdown；增量同步根据笔记数、书评数、进度等指纹判断是否有变化，无变化则跳过；--force可强制全量重导；export-dir查看导出目录及是否有数据。 - 本地浏览：
demo启动本地可视化页面，浏览已同步书籍与 Markdown 笔记。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装说明 执行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 将 Skill 装进当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端的 skills 目录，否则默认落在 ./skills/ 且 Agent 可能无法识别。常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
skillhub install weread-sync --namespace user_568e5b5e --dir ~/.cursor/skills/
也可让 Agent 按官方提示安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_568e5b5e/weread-sync`。
3. 安装并准备 CLI 工具¶
Skill 要求先全局安装 npm 包：
npm install -g weread-sync
经过上面的步骤，在对话中提及查看微信读书数据、同步 Markdown 或打开 demo 时，Agent 会按 Skill 中的流程引导你执行对应命令。
典型用法¶
Skill 内约定的操作顺序如下。
首次使用：登录
weread-sync login
显示二维码，扫码后登录态写入本机。
拉取并导出 Markdown
weread-sync sync
需要全量重导时：
weread-sync sync --force
查看进度与书单（可选）
weread-sync status
weread-sync notebooks
weread-sync books-status
单本书探测（可选）
weread-sync book-probe
具体书名或 ID 参数以 weread-sync 自带帮助为准（weread-sync book-probe --help）。
打开本地可视化 demo
weread-sync demo
在 Agent 侧，你可以直接用简介中的意图发起对话，例如：「同步我微信读书里的划线和笔记到本地 Markdown」「列出有笔记的书」「打开 weread-sync 的 demo 页面」。
适用场景与注意¶
适合谁
- 已在微信读书长期积累划线、想法、书评，希望落到本地 Markdown 做检索或二次整理的人。
- 希望在 Agent 会话里查阅读状态、书单，而不必每次手写 curl 或查 API 的人。
使用注意
- 需要本机已安装 Node.js/npm，并能执行
npm install -g weread-sync。 - 数据与登录态在本地；换机或清缓存后需重新
login。 sync为增量逻辑，若怀疑导出不完整，可用--force强制全量。- Skill 为社区贡献（community），页面统计（截至资料抓取）：评分 100000，下载 1838，安装 5；行为以你本机安装的 v1.0.0 与
weread-sync版本为准。 - 与 SkillHub 上其他微信读书类 Skill（名称相近）不同，本 Skill 坐标固定为
@user_568e5b5e/weread-sync，安装时注意--namespace user_568e5b5e。
结尾¶
「微信读书评论、划线拉取」把扫码登录、增量同步 Markdown、本地 demo 浏览收敛成一套 Agent 可执行的说明，适合把阅读数据从 App 里搬到本地文件体系。安装与命令细节以 SkillHub 页面与包内 SKILL.md 为准：
- https://www.skillhub.cn/skills/user_568e5b5e/weread-sync
- https://api.skillhub.cn/user_568e5b5e/weread-sync
