用途：作为 PKM 书库的数据同步层，将微信读书书架、已读状态、划过和想法写入 Obsidian，并通过微信读书 API 补充单本书详情。书卡与阅读记录的本地补建、总览生成由相邻的 soia-pkm-library-book-catalog 负责。
主要能力：sync_weread_to_library.py 把已读书目同步为图书馆书卡和阅读记录；sync_weread_highlights.py 把划线/想法写入已有阅读记录的机器段；enrich_book_details.py 通过 API 补简介、章节、进度、相似书。目录结构由 --base 决定，书卡位于 00_图书馆/书目/<分类目录>/<书名>.md，阅读记录位于 阅读记录/<状态>/<书名>.md。划线脚本维护 ## 📌 划线 / ## 💭 想法 机器段，用户手写内容应放在其中的 ### 用户笔记 子区块，否则下次同步可能被覆盖。
用法：安装技能后执行 npx skills add Tencent/WeChatReading -g -y 安装强依赖，并在私有配置 env 中设置 OBSIDIAN_VAULT 和 WEREAD_API_KEY，或命令行传 --vault。从 scripts/ 目录运行：python3 sync_weread_to_library.py --vault <vault-path>；python3 sync_weread_highlights.py（预览前 30 本）、--all（全量）或指定书名；python3 enrich_book_details.py <书名>、--all 或 --refresh-chapters。建议先用默认预览或单本模式确认范围，再全量同步。
限制：需本机可访问 https://i.weread.qq.com/api/agent/gateway，缺依赖或 key 时停止 API 调用。批量模式找不到本地书卡或阅读记录会跳过并告警。私有配置路径为 ~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-library-weread-sync/config.yml。不得输出或写入 API key、cookie、token。