omnifocus

🎯 OmniFocus智能任务自动化管家

基于官方Omni Automation的macOS本地任务管理方案,通过JXA实现零网络风险的OmniFocus深度集成,让GTD工作流效率倍增。

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

使用说明

OmniFocus Automation 是一款专为 macOS 平台设计的本地任务管理自动化技能,通过 JavaScript for Automation (JXA) 与 AppleScript 混合技术方案,为用户提供对 OmniFocus 应用的深度命令行控制。

核心用法
该技能通过封装 JXA 脚本实现与 OmniFocus 的无缝集成,支持完整的任务生命周期管理。用户可通过命令行执行 inbox(收件箱查看)、add(添加任务)、complete(标记完成)、due(设置截止日期)等 20 余项操作,涵盖任务增删改查、项目管理、标签分类及重复规则设置。所有命令返回结构化 JSON 数据,便于与 Alfred、Raycast 等效率工具或自定义 Shell 脚本集成,构建个性化的 GTD(Getting Things Done)工作流。

显著优点
首先,纯本地执行架构确保数据隐私零风险,所有操作均在 macOS 系统内完成,无网络传输、无云端依赖,契合敏感任务管理场景。其次,功能覆盖全面,不仅支持基础 CRUD 操作,更提供重复任务规则设置(固定周期/完成延后/推迟延后)、标签自动创建、跨项目移动等高级功能,满足复杂项目管理需求。再者,混合技术方案(JXA 为主、AppleScript 为辅)巧妙规避了 OmniFocus API 的类型转换缺陷,保证了操作稳定性。

潜在局限
该技能存在明显的平台依赖性,仅支持 macOS 且需安装 OmniFocus 商业软件(3 或 4 版本),Windows 与 Linux 用户无法使用。作为 T3 级个人开发者作品,长期维护稳定性与社区支持弱于官方或企业级解决方案。此外,初次配置需用户在系统设置中手动授权自动化权限,对普通用户存在一定门槛。功能上,缺少与日历应用、邮件系统的原生联动,复杂工作流需额外脚本配合。

适用人群
本技能最适合已深度使用 OmniFocus 的 GTD 实践者、命令行爱好者及自动化工作流构建者。特别是需要批量处理任务、通过脚本生成日报/周报、或希望将 OmniFocus 与开发环境(如 VS Code、Terminal)集成的效率极客。对于仅偶尔使用任务管理工具的用户,直接操作 OmniFocus GUI 可能更为直观。

使用风险
数据安全方面,delete 命令永久删除任务且不可逆,建议执行前通过 info 命令确认任务 ID。系统兼容性上,macOS 系统更新可能导致 JXA 行为变更,需关注技能版本更新。性能方面,大量任务批量操作(如千级任务查询)可能因 OmniFocus 应用响应延迟导致脚本超时。商业依赖风险在于,OmniFocus 软件本身为付费应用,若用户未购买或未来停止维护,技能将失去作用基础。

安全解读

核心功能

OmniFocus Skill 是专为 macOS 设计的本地任务管理自动化工具,通过 JavaScript for Automation (JXA) 与 OmniFocus 3/4 进行深度集成。它提供完整的任务生命周期管理:从收件箱快速捕获、项目化组织、标签系统管理,到截止日期与重复规则的精细化配置。所有操作均通过 JSON 接口返回,便于与其他工具链集成。

显著优点

1. 零网络依赖:纯本地实现,任务数据永不离开设备,满足高隐私要求场景
2. GTD 原生支持:收件箱(Inbox)、项目(Projects)、标签(Tags)、标记(Flagged)、今日视图(Today)等核心概念完整映射

3. 重复任务灵活配置:支持固定间隔(fixed)、完成后截止(due-after-completion)、完成后延期(defer-after-completion)三种模式,覆盖周/月/年多级周期

4. 混合技术栈稳健性:针对 JXA 在标签和重复任务上的已知类型转换 bug,智能回退至 AppleScript 实现,保障功能完整性

5. 输入安全处理:内置 escapeForAppleScript 转义机制,防范 AppleScript 注入风险

潜在局限

  • 平台锁定:仅支持 macOS,且需 OmniFocus 3/4 正版软件(价格较高)
  • 首次授权摩擦:需在系统设置中手动开启 OmniFocus 的自动化权限
  • 无移动端同步:虽 OmniFocus 本身支持 iOS 同步,但本 Skill 无法直接在移动设备运行
  • 学习曲线:GTD 方法论本身需要适应期,命令行操作对非技术用户不够友好

适合人群

  • 已使用 OmniFocus 的资深 GTD 实践者,希望打通命令行/脚本工作流
  • 需要在本地安全环境中自动化任务管理的隐私敏感用户
  • 追求「收件箱清零」效率,习惯键盘驱动工作流的高级用户
  • 希望将 OmniFocus 与自建工具链(如 daily notes、周报生成)集成的开发者

常规风险

| 风险项 | 说明 | 缓解措施 |
|--------|------|----------|
| 自动化权限误操作 | 用户可能误拒权限导致功能失效 | 首次使用提供清晰的权限引导说明 |
| 命令行误输入 | `delete` 等操作不可逆 | 建议配合 `--dry-run` 模式或备份机制 |
| 日期格式错误 | 非 ISO 格式日期导致解析失败 | 严格遵循 YYYY-MM-DD 格式输入 |
| 项目/文件夹名称大小写敏感 | 大小写不匹配导致命令失败 | 建议先使用 `list` 命令确认精确名称 |

---

安全评级说明:本 Skill 通过 CLS-Certify A 级认证(78分),无外部网络请求、无第三方依赖、代码公开透明。doShellScript 的使用仅限于本地 AppleScript 通信,且已实施输入转义防护。

omnifocus 内容

scripts文件夹
手动下载zip · 5.8 kB
omnifocus.jstext/javascript
请选择文件