用途:作为 PKM 书库的数据同步层,把微信读书的已读书目、划线/想法写入 Obsidian,并通过微信读书 API 补充单本书详情。书卡与阅读记录的本地补建、总览生成由相邻技能 soia-pkm-library-book-catalog 负责。
主要能力:sync_weread_to_library.py 同步已读书目并创建/更新书卡与阅读记录;sync_weread_highlights.py 同步划线与想法到已有阅读记录的机器段;enrich_book_details.py 补简介、章节、进度、相似书。划线同步默认预览 noteCount 前 30 本,支持 --all 和指定书名。
必要用法:先安装本技能,例如运行 claude plugin marketplace add soia-team/soia-open-skills 与 claude plugin install soia-pkm-vault@soia;或只用 npx skills add soia-team/soia-open-pkm-vault-skills -g -a '*' -s soia-pkm-library-weread-sync -y,注意与插件二选一以免出现两份索引。强依赖 weread-skills:npx skills add Tencent/WeChatReading -g -y,以及 WEREAD_API_KEY,需在 https://weread.qq.com/r/weread-skills 登录获取,写入私有配置(如 ~/.config/soia-skills/soia-pkm-library-weread-sync/config.yml)中的 env.OBSIDIAN_VAULT 与 env.WEREAD_API_KEY,密钥不得提交。脚本从 scripts/ 目录执行,示例:python3 sync_weread_to_library.py --vault <vault-path>;python3 sync_weread_highlights.py --all;python3 enrich_book_details.py <书名>。目录契约为 00_图书馆/书目/<分类目录>/<书名>.md 与 阅读记录/<状态>/<书名>.md,书卡中 category/subcategory 为分类权威源。
适用场景与限制:适合管理微信读书笔记到 Obsidian 的个人知识库同步;需要本机可访问 https://i.weread.qq.com/api/agent/gateway、Python 3 及 OBSIDIAN_VAULT 配置。缺依赖或 key 时脚本停止 API 调用并给出安装或获取提示;找不到书卡时批量模式跳过并告警。用户手写内容应放在 ### 用户笔记 子区块,否则可能被下次同步覆盖。WorkBuddy 需按 docs/install/workbuddy.md 单独安装。未提供的收费、价格等信息暂未说明。