用途:通过 note 命令行工具管理 Apple 备忘录,支持列示、读取、创建、编辑、移动、搜索、删除,按文件夹组织,并跨设备同步。是 event CLI(提醒/日历)的笔记版姊妹工具,架构相同、后端独立。
主要能力:note notes list/show/search/create/edit/move/delete 覆盖笔记全流程,note folders list/create/delete 管理文件夹;所有读写命令支持 --json 便于解析取值。可把自由文本分类映射到文件夹(note prefs add/list/get/remove),创建时用 --category 自动落位。提供语义化(模糊)检索的 agentic 做法:把查询扩展为中英文多组关键词,分别执行搜索后合并去重、阅读正文判断。
云端同步:通过 Cloudflare D1 后端双向同步(note sync),正文端到端加密,标题与文件夹名保持明文;支持 push/pull、exclude 黑名单排除敏感文件夹,以及直接读写云端的 D1-direct 子命令。
必要用法:macOS 需在系统设置中授予终端控制“备忘录”的自动化权限,首次运行会弹窗;Linux 先执行 note sync 填充 ~/.local/share/note-sync/local.db。正文以 Markdown 与 Apple 备忘录 HTML 自动互转,标题即正文首行。同步需 NOTE_SYNC_API_URL、NOTE_SYNC_API_TOKEN 与共享的 NOTE_ENCRYPTION_KEY(base64,32 字节,可用 openssl rand -base64 32 生成),密钥请备份,丢失后加密正文不可恢复。
限制:正文以 - 开头时须写作 --body=- milk 或改用 --body-file;移动操作实为复制加删除,会生成新 id;标题/标题样式在写回时被规范为正文;链接写为 label (url) 纯文本;列表项之间会多出空行,表格与内嵌图片不保留;列出或搜索会一次性抓取所有正文,大库耗时数秒;同步冲突按修改时间后写胜;本地存储为明文,D1 上标题与文件夹名明文,请避免把完整正文打印到共享日志。其他细节如 Worker 部署步骤见其自带文档,本资料未提供。