flomo-archive
# Flomo 笔记归档工具
## 功能
1. **完整获取** - 获取 Flomo 指定月份的所有笔记，处理 API 50条/次的限制
2. **质量评估** - 自动评估笔记质量，标记低质量/碎片化记录
## 核心策略
Flomo 的 `memo_search` API 单次最多返回 50 条笔记。本工具采用智能分层策略：
1. **按周获取** - 默认粒度，大部分情况足够
2. **降级按天** - 当某周返回 50 条时，降级为按天获取该周
3. **ID 去重** - 处理周边界重叠，确保笔记不重复
## 使用方法
### 获取某月笔记（带质量评估）
```bash
python3 scripts/fetch_month.py <年> <月>
```
示例：
```bash
python3 scripts/fetch_month.py 2025 7
```
### 仅评估已有数据
```bash
python3 scripts/evaluate_quality.py /tmp/flomo_YYYY_MM.json
```
## 质量评估规则
| 规则 | 结果 | 说明 |
|------|------|------|
| 有标签 + 字数≥50 | 高质量 | 已分类且内容充实 |
| 含链接/图片 | 高质量 | 有多媒体内容 |
| 字数<20 | 低质量 | 字数过少 |
| 无标签 + 字数<100 | 低质量 | 建议人工审阅 |
| 疑似流水账关键词 | 低质量 | 如"起床了""晚安"等 |
## 输出格式
- 默认：统计摘要 + 质量报告 + 保存到 `/tmp/flomo_YYYY_MM.json`
- JSON 模式：`--json` 输出完整 JSON
- 详细模式：`-v` 显示每日获取进度
## 技术细节
- API 限制：单次最多 50 条
- 调用频率：每次调用间隔 100ms
- 数据已包含：content, tags, word_count, created_at 等完整字段
- 无需额外 batch_get 调用
## 注意事项
- 需要 `mcporter` 已配置 flomo MCP 服务器
- 结果文件保存在 `/tmp/` 目录，需及时转存
标签
skill
ai
