概述
Workflowy CLI 是由 mholzen 开发的非官方命令行工具，用于与 Workflowy 大纲服务进行交互。它通过官方 API 提供完整的树形结构管理能力，包括读取、搜索、创建、更新、移动和删除节点，以及批量操作和数据统计功能。
核心用法
工具支持三种数据访问模式：--method=get 实时获取特定项目，--method=export 使用约1分钟缓存的快速导出，--method=backup 基于 Dropbox 备份的离线模式。常用操作包括：workflowy get 获取节点树，workflowy search 全文搜索（支持正则），workflowy create 创建节点，workflowy update/complete/move/delete 修改节点状态，以及 workflowy replace/transform 执行批量替换和内容转换。统计报告功能可分析内容分布、子节点数量和修改时间。
显著优点
1. 完整 API 覆盖：支持 Workflowy 核心功能，包括节点镜像分析、批量替换等高级操作
2. 灵活的数据源：三种访问模式平衡实时性与性能，备份模式支持完全离线使用
3. 短 ID 支持：可直接使用 Workflowy 内部链接的短 ID 或完整 URL 操作节点
4. 批量处理能力：正则替换、内容转换（如按换行拆分为子节点）大幅提升整理效率
5. 安全意识：文档明确提醒删除操作会级联删除子节点，并建议使用 --dry-run 预览批量操作
潜在局限
- 非官方工具：由社区开发者维护，非 Workflowy 官方支持，存在 API 变更导致功能中断的风险
- 安装门槛：需要手动获取 API 密钥并配置权限（
chmod 600），对非技术用户不够友好 - 功能边界：某些 Workflowy 高级功能（如格式样式、协作权限）可能未完全覆盖
- 依赖外部备份：镜像分析等功能必须使用 Dropbox 备份模式，增加了配置复杂度
适合人群
- 日均操作 Workflowy 超过 30 分钟的重度用户
- 需要批量整理大纲（如标签规范化、内容迁移）的效率优化者
- 偏好命令行工作流、熟悉正则表达式的技术型用户
- 希望离线分析或备份 Workflowy 数据的数据管理者
常规风险
API 密钥存储在 ~/.workflowy/api.key，需确保文件权限为 600 防止泄露；批量删除和替换操作不可逆，执行前应使用 --dry-run 或 --interactive 确认；备份模式数据可能滞后约1分钟，关键操作前建议切换实时模式验证数据状态。