SuperAPI AI 工具集

soia-pkm-library

通用与其它

查看项目

更新于 10-16 07:28

技能介绍

用途:维护 Obsidian 书库中“书本”这条数据线,即图书馆书目与阅读记录的同步、补全与总览生成,把微信读书的书架、阅读进度、划线和想法落盘为长期阅读档案。

主要能力:7 个确定性脚本(无 LLM 判断)。sync_weread_to_library.py 将已读书目同步为书卡与阅读记录;sync_weread_highlights.py 追加划线/想法;enrich_book_details.py 补单本或全部书详情;backfill_reading_records.py 为有书卡无记录的书补建待读记录;gen_library_md.py、gen_records_md.py、gen_genre_library_md.py 分别重生成图书馆总览、阅读记录总览与按类型总览。

使用方式:先安装 npx skills add soia-team/soia-open-skills,再安装微信读书官方 skill:npx skills add Tencent/WeChatReading -g。在 https://weread.qq.com/r/weread-skills 登录获取 WEREAD_API_KEY,写入 ~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-library/config.yml 的 env 段(含 OBSIDIAN_VAULT)。脚本在 scripts 目录下用 python3 运行,支持 --vault、--base、--config、--output 参数;--output 可干跑预览。

适用场景:个人或家庭书库的微信读书数据同步与视图维护。

限制:同步类脚本强依赖 weread-skills 与 WEREAD_API_KEY,需联网访问微信读书 Agent API Gateway;本地生成类脚本不需要 key。仅需 Python 3 标准库。秘钥不得写入 vault 或开源仓库。划线机器段会被整段覆盖,手写笔记需放在 ### 用户笔记 子区块。不做推荐、排计划或云盘整理。