weread-shelf-organizerlisted
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 需以两位数字前缀开头