核心用法
Instapaper CLI (ip) 是 Instapaper 服务的官方命令行工具，本 skill 专注于其自动化操作与故障排查。核心能力涵盖六大模块：
1. 认证管理：通过 ip login 完成 OAuth/XAuth 认证，支持 --password-stdin 安全输入，依赖 INSTAPAPER_CONSUMER_KEY 和 INSTAPAPER_CONSUMER_SECRET 环境变量。
2. 数据读取：ip list 与 ip export 支持游标分页 (--cursor)、时间边界 (--since/--until、--updated-since) 实现增量同步；--select 提供客户端过滤。
3. 输出格式：默认 --ndjson 流式输出，适合管道处理；--json 用于单对象；--plain 提供稳定文本；--stderr-json 与 --progress-json 支持结构化监控。
4. 批量变更：支持 --dry-run、--idempotent 安全模式；--ids/--stdin 配合 --batch 实现高效批量操作；删除需显式确认。
5. 高级功能：ip text 提取文章 HTML，ip highlights 管理标注，ip folders 管理文件夹层级与排序。
6. 诊断调试：ip doctor --json 前置检查，--debug 输出请求时序，--stderr-json 结构化错误与退出码映射。
显著优点
- 结构化输出：NDJSON/JSON/Plain 三种机器可读格式，原生支持管道与自动化
- 增量同步：游标机制与
updated-since实现高效差量更新，适合定时任务 - 安全设计：密码 stdin 输入、环境变量隔离、无持久化明文凭证
- 批量原子性：
--batch与--idempotent降低误操作风险
潜在局限
- 依赖外部服务：Instapaper API 稳定性与速率限制直接影响可用性
- 认证门槛：需自行申请 Consumer Key/Secret，非开箱即用
- 平台限制：部分功能（如高亮标注）依赖 Instapaper 高级订阅
适合人群
- 需要将 Instapaper 集成至个人知识管理（PKM）系统的开发者
- 构建书签归档、全文检索、阅读分析自动化流程的高级用户
- 跨平台批量管理数千级书签的内容策展人
常规风险
- 凭证泄露：Consumer Secret 若硬编码或提交至版本控制将导致账户风险
- 数据覆盖：批量
import/delete在无--dry-run时可能造成不可逆丢失 - API 变更：Instapaper 被 Pinterest 收购后维护频率降低，存在长期支持不确定性
- 速率限制：高频同步可能触发 429 错误，需实现指数退避重试