Workflowy

核心用法

workflowy CLI 是一款非官方的命令行工具，封装了 Workflowy API，让用户无需打开网页即可完成大纲的读写操作。安装后配置 API key 即可使用，支持通过 UUID、短链接或特殊别名（inbox/home）定位节点。

读取能力：获取指定层级的大纲树、按关键词或正则表达式全文搜索、查看节点统计报告（内容分布、子节点数量、最旧修改时间等）。

写入能力：创建节点、更新内容、标记完成/未完成、移动节点、删除（级联删除子节点）。

批量操作：查找替换（支持正则捕获组）、节点内容转换（按换行拆分子节点、去除空白字符）。

数据策略：提供三种访问模式——实时 API（get）、缓存导出（export，约1分钟延迟）、Dropbox 备份（backup，离线可用），用户可根据速度与新鲜度需求灵活选择。

显著优点

• 纯文本工作流：适合习惯终端的用户，可与 fzf、jq、shell 脚本无缝集成。
• 批量处理能力：正则替换、内容转换等功能弥补了网页端批量编辑的不足。
• 离线支持：通过 Dropbox 备份实现无网络环境下的数据读取。
• 灵活的节点引用：支持短 ID、完整 URL、inbox/home 别名，降低操作门槛。

潜在局限

• 非官方工具：由社区开发者维护，存在 API 变更导致失效的风险。
• 删除不可逆：级联删除无确认提示，误操作后果严重。
• 学习成本：需要熟悉命令行参数与 Workflowy 的数据模型（UUID、镜像节点等概念）。
• 实时性权衡：批量操作依赖缓存数据，可能操作到过期内容。

适合人群

• 每日重度使用 Workflowy 且追求效率的进阶用户
• 需要将大纲数据与其他 CLI 工具（如任务管理器、笔记系统）集成的开发者
• 希望自动化重复编辑任务（如批量重命名、整理归档）的自动化爱好者

常规风险

• 数据丢失：delete 命令会连带删除所有子节点且无回收站机制，建议操作前备份。
• 批量替换风险：replace 命令默认直接执行，务必先用 --dry-run 验证，配合 --interactive 二次确认。
• API 密钥安全：key 文件存储于本地 ~/.workflowy/，需确保权限设置为 600，避免多用户环境泄露。

核心用法

该 Skill 通过封装第三方开源工具 workflowy-cli，为用户提供完整的 Workflowy 大纲交互能力。核心功能覆盖四大场景：

读取与检索：支持按节点 ID 获取树状结构、全文搜索（支持正则与大小写忽略）、子树范围限定搜索，以及通过短 ID 或完整 URL 快速定位节点。

写入与编辑：可创建节点（指定父节点或投递至 Inbox）、更新内容、完成/取消完成状态切换、移动节点位置，以及删除节点（级联删除子节点）。

批量操作：提供搜索替换（支持 dry-run 预演、交互式确认、正则捕获组）、内容变换（按换行拆分为子节点、空白字符修剪）等高级功能，适合大规模内容整理。

统计与报告：内置内容分布分析、子节点数量排行、陈旧内容识别、镜像节点统计（需备份模式）等运维视角功能，辅助用户优化大纲结构。

该 Skill 支持三种数据访问模式：get 实时模式、export 缓存模式（约 1 分钟延迟）、backup 离线模式（需启用 Dropbox 备份），用户可根据场景权衡速度与新鲜度。

显著优点

功能覆盖全面：几乎映射了 Workflowy Web 端的核心操作，用户无需切换界面即可完成从快速记录到深度整理的全流程管理。

批量处理高效：搜索替换与 transform 命令显著提升了大规模内容维护效率，尤其适合项目管理中的批量重命名、标签规范化等场景。

离线友好设计：backup 模式支持完全离线操作，结合 Dropbox 同步，可在无网络环境下继续工作并后续同步。

安全凭证管理：API Key 存储于本地指定目录并要求严格权限（chmod 600），遵循最小权限原则，无硬编码密钥风险。

纯文档型安全基线：Skill 本身无可执行代码，所有功能委托外部 CLI 工具，攻击面可控。

潜在缺点与局限性

外部依赖风险：核心功能完全依赖第三方个人开发者（mholzen）维护的 CLI 工具，属 T3 来源级别，项目 Stars 数较少，长期维护稳定性存疑。若上游停止更新，Skill 功能将失效。

安装门槛存在：需用户手动完成 Homebrew 安装、API Key 申请与配置、文件权限设置三步操作，对非技术用户不够友好。

无原生撤销机制：CLI 操作（尤其 delete 级联删除、bulk replace）不可逆，误操作后果严重，需依赖 --dry-run 与用户谨慎确认。

实时性折中：export/backup 模式存在缓存延迟，对需要强一致性的协作场景不适用；实时模式则无缓存加速，大规模树操作性能受限。

平台绑定：仅支持 Workflowy 生态，无法迁移至其他大纲工具（如 Dynalist、Logseq），形成供应商锁定。

适合的目标群体

Workflowy 重度用户：已深度依赖 Workflowy 进行知识管理、项目规划或子弹日记，日均操作频繁的效率追求者。

技术背景知识工作者：熟悉 CLI 环境、具备基础正则表达式能力，追求键盘驱动工作流（Keyboard-driven workflow）的开发者、产品经理、研究员。

批量内容维护者：需要定期整理历史笔记、统一标签规范、迁移项目结构的资料管理员或团队知识库维护者。

离线优先需求者：经常处于弱网环境（差旅、偏远地区），需要本地缓存保障工作连续性的用户。

使用风险与注意事项

CLI 工具供应链安全：安装前务必审查 https://github.com/mholzen/workflowy 源码，确认无恶意行为；仅从官方 Homebrew tap 安装，避免第三方渠道篡改。

API Key 泄露风险：~/.workflowy/api.key 文件若权限配置不当或被备份至云端，可能导致账户完全访问权限泄露。建议定期检查文件权限，避免同步该目录至公共仓库。

误操作数据丢失：delete 与 replace 操作具有破坏性，强烈建议执行 bulk 操作前使用 --dry-run 验证，关键数据定期通过 Workflowy 官方导出功能备份。

性能与速率限制：大规模 export 或频繁 API 调用可能触发 Workflowy 后端限流，建议合理使用缓存模式，避免短时间内高频请求。

功能依赖外部更新：Workflowy 官方 API 变更可能导致 CLI 工具失效，需关注上游仓库更新动态，保持工具版本最新。