Workflowy

核心用法

Workflowy CLI 是 Workflowy 大纲工具的非官方命令行客户端，基于 Go 语言开发，通过调用官方 API 实现完整的节点操作能力。核心功能覆盖四大场景：

读取与浏览：workflowy get 获取根节点或指定节点树，workflowy list 平铺子节点，workflowy search 支持全文搜索与正则匹配，可限定子树范围检索。

内容编辑：workflowy create 创建节点（支持 inbox/home 快捷目标），workflowy update 重命名，workflowy complete/uncomplete 切换完成状态，workflowy move 移动节点，workflowy delete 级联删除。

批量处理：workflowy replace 支持搜索替换与正则捕获组，workflowy transform 提供 split/trim 等结构化转换，适合数据清洗与格式统一。

统计分析：内置报告命令统计节点数量、子节点分布、修改时间、镜像引用等，辅助大纲健康度检查。

数据访问策略：提供三级方法——get 实时查询中等速度；export 缓存约 1 分钟延迟，适合整树遍历；backup 读取 Dropbox 备份，离线最快但数据较旧。

显著优点

• 完整 CRUD：覆盖 Workflowy 核心操作，弥补官方缺乏 CLI 的空白
• 批量自动化：正则替换、转换、报告功能适合大规模数据治理
• 灵活访问模式：三种数据方法权衡实时性与性能，适配不同场景
• 轻量集成：单二进制文件，Homebrew 一键安装

潜在局限

• 非官方维护：由个人开发者维护，API 变更存在滞后风险
• 安全依赖本地文件：API 密钥以明文存储于 ~/.workflowy/api.key，需手动设置 600 权限
• 无官方背书：功能边界与稳定性不及官方渠道
• 备份方法受限：镜像分析等功能强制依赖 Dropbox 备份启用

适合人群

• 习惯命令行工作流、需批量处理大纲的 Workflowy 重度用户
• 希望将 Workflowy 集成到自动化脚本或 CI/CD 的技术用户
• 需离线分析或数据导出迁移的高级用户

常规风险

• 密钥泄露：配置文件权限不当或误提交版本控制导致 API 密钥暴露
• 误删数据：delete 命令级联删除子节点，批量 replace/move 操作不可逆
• 数据一致性：--method=export/backup 缓存机制下可能操作过期数据
• 第三方信任：需评估个人维护者长期维护意愿与代码审计状态

使用建议

操作前优先 --dry-run 验证，敏感操作配合版本控制或 Workflowy 原生历史功能；定期审计 ~/.workflowy 目录权限；关键业务场景建议保留官方 Web 端作为 fallback。