核心用法
UpNote 技能提供对笔记应用 UpNote 的自动化控制能力,基于 x-callback-url 协议实现。用户需通过 scripts/upnote.sh 脚本执行所有操作,主要功能包括:
笔记管理:创建新笔记(支持 Markdown)、指定笔记本、打开已有笔记;笔记本管理:创建新笔记本、打开特定笔记本;内容浏览:搜索笔记、按标签/过滤器查看、访问快捷方式/模板/回收站等视图模式。
关键操作流程:创建笔记需 --title 和 --text 参数,可选 --markdown 启用富文本渲染、--notebook 指定目标笔记本、--new-window 新开窗口;获取笔记/笔记本 ID 需在 UpNote 内右键复制链接提取。
显著优点
- 协议标准化:基于成熟的 x-callback-url 方案,与 iOS/macOS 自动化生态兼容
- 功能覆盖全面:涵盖笔记生命周期管理(创建/查看/搜索/分类)
- 脚本封装友好:Shell 脚本自动处理 URL 编码,降低命令行使用门槛
- Markdown 原生支持:满足开发者和技术写作者的格式需求
潜在缺点与局限性
- 平台受限:仅支持已安装 UpNote 的 macOS/iOS 设备,无跨平台能力
- ID 获取繁琐:打开/管理已有内容需手动从应用内复制链接提取 ID,无法通过名称直接引用
- 应用强制前台:所有操作都会唤起 UpNote 应用,打断当前工作流
- 无返回值:脚本执行后无法获取创建结果或状态反馈,难以链式自动化
- 依赖本地文件:需确保
scripts/upnote.sh存在于正确路径
适合人群
UpNote 重度用户、追求笔记工作流自动化的效率爱好者、习惯命令行/脚本管理的开发者。不适合无 UpNote 订阅、需跨平台同步或期望静默后台操作的用户。
常规风险
- 路径依赖风险:脚本位置固定,移动或重命名将导致技能失效
- 编码问题:特殊字符处理依赖脚本实现,极端情况下可能出现编码错误
- 应用版本兼容性:UpNote 更新可能变更 x-callback-url 参数,需同步维护脚本
- 无权限隔离:脚本以当前用户权限运行,无额外沙箱保护