drafts

drafts 是一款专为 macOS 平台设计的 Drafts 应用 CLI 工具文档，旨在通过终端命令实现对 Drafts 笔记的高效管理，为习惯命令行操作的用户提供完整的笔记自动化解决方案。

核心用法围绕命令行操作展开，提供完整的 CRUD 功能支持。用户可通过 drafts create 快速创建笔记并附加标签或标记旗帜，利用 drafts list 按文件夹（收件箱/归档/废纸篓）或标签筛选查看，通过 drafts get 获取指定 UUID 的草稿内容或当前活跃草稿。修改操作支持 append、prepend 和 replace 三种模式，满足不同场景下的内容更新需求。此外，drafts run 可触发 Drafts 应用内的自动化 Action，drafts edit 支持在外部编辑器中打开草稿，实现与 Drafts 生态的深度集成。所有命令默认返回结构化 JSON 数据，便于脚本化处理和二次开发。

显著优点体现在工作流效率提升和平台集成度上。作为原生 macOS 工具，它利用 AppleScript 与 Drafts 应用无缝通信，确保操作实时同步且符合 macOS 自动化生态。JSON 输出格式便于开发者构建自动化工作流，特别适合日常日志追加、快速捕获想法等重复性场景。命令设计遵循 Unix 哲学，支持管道和脚本集成，能够轻松融入现有的 Shell 工作流，显著提升知识管理效率。

潜在缺点主要集中在平台限制和依赖成本上。该工具严格限定仅支持 macOS 系统（基于 AppleScript），且必须保持 Drafts 应用前台运行，无法后台静默操作，命令执行存在阻塞风险。功能完整使用依赖 Drafts Pro 订阅，增加了持续使用成本。由于基于 AppleScript 桥接，执行速度受 Drafts 应用响应影响，大容量笔记批量操作时可能出现明显延迟。此外，标签系统区分大小写，可能导致管理混乱或筛选遗漏。

适合目标群体为 macOS 生态重度用户、Drafts Pro 订阅者以及习惯终端工作的效率爱好者。特别适合软件开发者、技术写作者和知识管理从业者，能够满足批量处理笔记、构建自动化日志系统、将 Drafts 集成到 Shell 工作流等进阶需求。对于已深度使用 Drafts 作为核心笔记工具的用户价值最大。

使用风险主要包括环境依赖性和权限管理复杂性。必须确保 Drafts 应用持续运行，否则命令将失败或无限挂起，建议配合 open -a Drafts 检查。初次使用需在系统设置中授予 Automation 权限，系统更新或权限重置可能导致功能中断。CLI 工具需通过 Go 环境安装，对非技术用户存在配置门槛。由于直接操作本地笔记数据且支持替换操作，建议在使用修改命令前验证 UUID 并备份重要内容，避免误操作导致数据不可逆丢失。