核心功能
raindrop 是一款命令行书签管理工具，通过调用 Raindrop.io 官方 API 实现对云端书签库的完整 CRUD 操作。核心能力覆盖：
- 检索查询：搜索关键词、列出收藏夹、获取标签统计、查找无标签书签
- 组织管理：创建收藏夹、单条/批量移动书签、更新元数据（标题、标签）
- 批量操作：利用 Raindrop 批量 API 实现高效迁移（单次最多 100 条）
- AI 辅助：获取 Raindrop 智能推荐的标签和标题
显著优点
1. 开发者友好：纯 bash + curl/jq 实现，无复杂依赖，易于集成到脚本工作流
2. 批量效率：bulk-move 命令相比单条循环调用减少 99% API 请求次数
3. 灵活认证：支持环境变量文件或运行时参数传递 token，适配 CI/CD 场景
4. 完整覆盖：同时支持读写操作，是唯一覆盖收藏夹管理的 CLI 方案
5. 分页与限流：内置 --delay 参数和分页控制，主动规避 API 限流
潜在局限
- 依赖第三方服务：Raindrop.io 服务可用性直接影响功能
- Token 安全：需妥善保管
RAINDROP_TOKEN，明文存储于本地文件存在泄露风险 - 无离线缓存：除 Pro 用户的
cache命令外，操作均需联网 - 功能边界：复杂筛选（如按日期范围、域名过滤）需自行组合 jq 处理
- API 限制：免费用户受 Raindrop 自身配额约束（120 req/min）
适合人群
- 需要批量整理数千条书签的重度 Raindrop 用户
- 追求「Inbox 归零」工作流，希望自动化处理 Unsorted 书签的效率控
- 开发需要将书签数据集成到个人知识管理（PKM）系统的技术用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| Token 泄露 | 配置文件 `~/.config/raindrop.env` 若权限设置不当（建议 600）可被其他进程读取 |
| 误操作覆盖 | `update` 命令会直接覆盖标签/标题，无撤销机制；建议操作前 `--json` 备份 |
| 批量删除不可逆 | `delete` 和 `bulk-move` 操作立即生效，Trash 仅保留有限时间 |
| API 限流触发 | 高频调用可能导致临时封禁，建议生产环境启用 `--delay` |