← ClaudeAtlas

weread-shelf-organizerlisted

微信读书书架自动整理技能 — 全量重组、增量归类、自动创建分组、清理旧分组与迁移核验。当用户要求整理微信读书书架、按表格/规则给书籍分类、创建书架分组、每周定期整理书架、把新书归档到分组时使用。需要 macOS + 已登录的微信读书 Mac 客户端。
tanyaqiong31029/weread-shelf-organizer · ★ 3 · AI & Automation · score 74
Install: claude install-skill tanyaqiong31029/weread-shelf-organizer
# 微信读书书架自动整理 (WeRead Shelf Organizer) 通过本机微信读书 Mac 客户端的登录凭据调用其官方书架接口,实现书架分组的批量整理: 全量重组(按用户提供的分类表)、增量归类(只整理新书/未分组书)、分组创建与清理、迁移后核验。 ## 前置条件 - macOS + 已登录的**微信读书 Mac 客户端**(App Store 版;平时无需保持打开,脚本会自动启动) - `python3`(标准库即可,无第三方依赖) - 本技能目录下的 `scripts/weread_shelf.py` **开始前必须先调用 `weread_shelf.py` 的子命令完成凭据验证(见工作流第 1 步)。** 凭据从客户端本地日志提取(vid/skey),只驻留内存,不落盘、不回显、不写入任何输出文件。 ## 核心约束(安全红线) 1. **只移动「未分组」的书**。用户放入其他自定义分组的书一律跳过(脚本已内置该逻辑)。 2. **不删除书籍、不移出书架、不改变私密状态、不动专辑/文章收藏**。 3. 迁移后**必须核验落位**(`verify`),报告未落位清单。 4. 先 `--dry-run` 出计划,向用户展示或确认后再 `apply`。 5. 拿不准分类的书**宁可保留「需复核」也不要硬塞**,在报告中列出请用户定夺。 ## 脚本用法 所有命令先 `cd` 到本技能 `scripts/` 目录(或用绝对路径): ```bash S=scripts/weread_shelf.py python3 $S creds # 提取并验证凭据(失败→见"凭据失效") python3 $S sync -o snapshot.json # 书架快照 python3 $S plan --rules rules.json [--baseline base.csv] -o plan.json [--dry-run] python3 $S apply --plan plan.json # 批量迁移 + 自动核验 python3 $S review --decisions d.json # 应用复核定类 python3 $S groups --list # 列出分组 python3 $S groups --create "01 成长学习" python3 $S groups --purge-empty # 清理空分组 python3 $S verify --plan plan.json # 独立核验 ``` ## 工作流 ### 第 0 步:准备规则文件 分组规则 JSON(示例见 `examples/rules.example.json`): ```json { "groups": [ {"name": "01 成长学习", "description": "个人成长、学习方法、教育、职场与考试"}, {"name": "02 语言写作", "description": "语言学、翻译、外语、写作与学术研究"} ], "category_map": { "个人成长-成长方法论": "01 成长学习", "经济理财-商业": "03 商业经济", "精品小说": "09 类型小说" } } ``` - `groups`:目标分组(name 需以两位数字前缀开头