Workflowy

核心用法

workflowy 是 Workflowy 大纲的非官方命令行工具，基于官方 API 实现完整的读写操作。主要功能包括：

• 读取浏览：workflowy get 获取节点树，workflowy list 扁平化子项，workflowy search 支持正则搜索与限定范围
• 内容编辑：create/update/complete/uncomplete/move/delete 覆盖完整 CRUD，支持 inbox/home 快捷目标
• 批量处理：replace 支持交互式正则替换，transform 实现拆分、裁剪等结构化操作
• 数据分析：report 系列命令统计节点数量、子项分布、修改时间、镜像引用等，辅助信息架构优化
• 多模式访问：get（实时）、export（缓存1分钟）、backup（本地离线）三级策略平衡速度与新鲜度

显著优点

• 操作粒度精细，支持 UUID/短链/URL 多种节点标识
• 批量正则替换与结构化 transform 适合大规模内容整理
• 报告功能弥补 Workflowy 原生数据分析能力的不足
• 离线 backup 模式保障隐私敏感场景下的本地处理

潜在局限

• 非官方工具，依赖个人开发者维护，API 变更可能导致功能失效
• 删除操作级联影响子节点，无回收站机制，误操作风险高
• 需手动管理 API key 文件，无 OAuth 等标准认证流程
• 批量 replace 默认无确认，需显式加 --dry-run 或 --interactive

适合人群

• 日均节点操作量大的重度 Workflowy 用户
• 需要将大纲数据与其他 CLI 工具链集成的开发者
• 有正则批量整理、历史数据分析需求的效率极客

常规风险

• API key 明文存储于 ~/.workflowy/api.key，权限等同于完整账户
• 批量编辑命令破坏性较强，建议始终先 dry-run
• 项目维护状态需关注，生产环境建议锁定版本

核心用法

该 Skill 通过封装非官方的 workflowy CLI 工具（由 GitHub 用户 mholzen 维护），让 Agent 具备与 Workflowy 大纲笔记直接交互的能力。用户需先在 https://workflowy.com/api-key/ 获取 API Key 并存储至本地 ~/.workflowy/api.key 文件，完成一次性配置后即可使用。

主要功能覆盖四大场景：读取（get、list、search 获取节点与全文检索）、写入（create、update、complete、move、delete 增删改节点）、批量操作（replace、transform 支持正则替换、分割、修剪等）、统计分析（report 生成内容分布、节点数量、修改时间等多维报告）。特别支持短 ID 解析、特殊命名目标（inbox、home）以及三种数据访问模式（get实时、export缓存、backup离线），适应从即时查询到批量离线处理的多样需求。

显著优点

1. 功能完整：几乎覆盖 Workflowy 核心 API 能力，支持从单节点查看到整棵树的全文搜索、正则匹配、批量替换等高级操作。
2. 高效批处理：replace 和 transform 命令支持 dry-run 预演与交互式确认，正则捕获组功能适合自动化整理大量笔记。
3. 灵活数据模式：三种访问方法兼顾实时性与性能，离线备份模式适合隐私敏感场景。
4. URL 智能识别：自动解析 workflowy.com 分享链接，提取短 ID 直接定位节点。

潜在缺点与局限性

1. 外部依赖风险：Skill 本身无执行代码，完全依赖用户本地安装的 workflowy CLI，存在供应链安全风险；Homebrew 渠道虽可信，但仍需用户自行验证。
2. 凭证管理隐患：API Key 以明文存储于本地文件，若权限设置不当（如未 chmod 600）易被窃取或误备份。
3. 破坏性操作无二次确认：delete 会级联删除子节点，replace 默认直接执行，文档虽提及风险但 Skill 层无内置确认机制。
4. 非官方工具：mholzen/workflowy 为社区项目，非 Workflowy 官方维护，功能更新与长期支持存在不确定性。

适合的目标群体

• 重度 Workflowy 用户：每日依赖大纲管理项目、知识库、任务清单，希望通过 Agent 自动化整理笔记。
• 数据整理需求者：需要对历史笔记进行批量格式统一、标签迁移、内容归档的用户。
• 效率工具整合者：希望将 Workflowy 与其他工作流（如每日回顾、周报生成）打通的自动化爱好者。
• 隐私敏感用户：离线备份模式适合需要在无网络环境下处理数据的场景。

使用风险

• 凭证泄露：API Key 明文存储需严格设置文件权限，避免同步至网盘或版本控制。
• 数据误删：delete 和 replace 操作不可逆，建议先 dry-run 或手动备份。
• 性能瓶颈：大规模树操作使用 --method=get 可能较慢，应优先选用 export 或 backup 模式。
• 依赖更新滞后：CLI 工具更新后 Skill 文档可能未及时同步，建议关注上游仓库 release 日志。