微信读书笔记整理至 IMA

要解决什么问题

微信读书的划线和想法分散在 App 里，想进 IMA 做检索、和知识库联动时，手工复制很难保留章节层级、目录锚点，以及「想法对应哪段原文」。本技能把「书名或 bookId → 抓取 → 排版 → 写入笔记本 / 可选入知识库」收成一条可重复执行的流水线。

流水线怎么跑

核心入口是 scripts/pipeline.py，支持分步子命令或 all 一键串联：

• 解析 bookId：只有书名时，通过微信读书搜索接口取最匹配 bookId。
• fetch：经 Agent Gateway 拉 chapterinfo（多级目录，勿用 bookmarklist 的扁平 chapters）、bookmarklist（划线）、review/list/mine（想法；注意 reviews[].review 嵌套）。
• build：生成 notes.md——章用 ##/### 保持四级以内层级；文首目录带锚点；划线用 > 引用块；有 range 的想法先展示原文再写 我的想法：；chapterUid=0 的书评汇总到文末 书评。
• write / kb：import_doc 写入 --folder-id 或按 --notebook-name 查找的笔记本；可选 add_knowledge 入 --kb-id 或按名查找的知识库。

凭证与目标 ID 全部参数化：WEREAD_API_KEY、IMA_OPENAPI_CLIENTID / IMA_OPENAPI_APIKEY 走环境变量或 ~/.config 回退文件，不在 skill 里写死。

边界与坑

• Windows 控制台中文易乱码：人类可读摘要在 *_result.json，stdout 以 OK / ID 为主。
• 个人自建知识库可能不在可搜索列表，显式传 --kb-id 最稳。
• 同章内划线文本去空白后完全相同只展示一次；无 range 的书评级想法归书评段，不代表匹配失败。