drafts

📋 macOS终端Drafts笔记管家

基于AppleScript的Drafts CLI文档指南,助力macOS用户通过终端高效管理笔记,需配合Drafts Pro订阅使用。

收藏
3.8k
安装
1.7k
版本
v1.0.0
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

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

核心用法围绕命令行操作展开,提供完整的 CRUD 功能支持。用户可通过 drafts create 快速创建笔记并附加标签或标记旗帜,利用 drafts list 按文件夹(收件箱/归档/废纸篓)或标签筛选查看,通过 drafts get 获取指定 UUID 的草稿内容或当前活跃草稿。修改操作支持 appendprependreplace 三种模式,满足不同场景下的内容更新需求。此外,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 并备份重要内容,避免误操作导致数据不可逆丢失。

安全解读

核心用法

drafts Skill 是一个纯文档型工具说明,指导用户通过命令行与 macOS 上的 Drafts 笔记应用交互。主要功能包括:

  • 创建笔记drafts create "内容" [-t 标签] [-f 标记] [-a 归档]
  • 列出笔记drafts list [-f 文件夹] [-t 标签过滤]
  • 查看/编辑drafts get [uuid] 获取内容,drafts edit <uuid> 打开编辑器
  • 修改内容drafts prepend/append/replace 支持在笔记前后插入或替换全文
  • 运行动作drafts run "动作名" 执行 Drafts 自动化动作

所有命令返回 JSON 格式结果,支持 --plain 切换为可读文本。

显著优点

1. 效率提升:无需离开终端即可快速捕获想法,适合开发者工作流
2. 结构化输出:JSON 格式便于脚本集成和自动化处理

3. 标签系统完善:支持多标签管理和按标签过滤

4. 与 Drafts 生态深度整合:可直接调用 Drafts 强大的动作系统

5. 文档清晰:命令示例丰富,常见工作流(快速捕获、每日日志)有明确指引

潜在缺点与局限性

1. 平台极度受限:仅支持 macOS(依赖 AppleScript),Linux/Windows 完全不可用
2. 应用依赖性强:Drafts 必须正在运行,命令才能执行;若应用无响应会导致命令挂起

3. 付费门槛:需要 Drafts Pro 订阅才能使用自动化功能

4. 外部工具依赖:Skill 本身仅为文档,实际功能依赖用户自行安装的 drafts CLI 工具

5. 无原生错误处理:若 Drafts 未运行,命令会失败或挂起,需用户手动排查

适合人群

  • macOS 重度用户:已习惯使用 Drafts 作为主力笔记工具
  • 开发者/极客:希望在终端环境中快速记录,避免切换应用
  • 自动化爱好者:需要将笔记操作集成到 Shell 脚本或工作流中
  • 已有 Drafts Pro 订阅者:已解锁自动化功能,可充分利用 CLI 能力

常规风险

| 风险类型 | 说明 | 等级 |
|---------|------|------|
| 平台锁定风险 | 更换操作系统后完全不可用 | 中 |
| 功能依赖风险 | CLI 工具停止维护或 Drafts API 变更可能导致 Skill 失效 | 低 |
| 隐私风险 | 笔记内容通过 AppleScript 在本地传递,无云端传输,风险可控 | 低 |
| 剪贴板操作 | 文档包含复制到剪贴板的示例,属正常功能但需注意敏感内容 | 极低 |

安全认证结论:安全等级 A(95 分),纯文档无代码,无恶意模式,来源为个人开发者(T3),建议关注上游更新。

drafts 内容

手动下载zip · 1.9 kB
SKILL.mdtext/markdown
请选择文件