名称： omnifocus
描述： 通过 Omni Automation 管理 OmniFocus 的任务、项目和文件夹。用于任务管理、待办清单、项目跟踪、GTD 工作流，以及添加/完成/编辑任务、设置截止日期、管理标签和重复任务。需要在 macOS 上安装 OmniFocus。

OmniFocus

通过 JXA (JavaScript for Automation) 控制 OmniFocus。

要求

• 已安装 OmniFocus 3 或 4 的 macOS 系统
• OmniFocus 必须正在运行（或将被自动启动）

快速参考

# 通过包装脚本运行
./scripts/of <命令> [参数...]

# 或直接运行
osascript -l JavaScript ./scripts/omnifocus.js <命令> [参数...]

命令

列表/查询

创建

修改

重复任务

# repeat <任务ID> <方法> <间隔> <单位>
of repeat abc123 fixed 1 weeks
of repeat abc123 due-after-completion 2 days
of repeat abc123 defer-after-completion 1 months
of unrepeat abc123

方法：fixed, due-after-completion, defer-after-completion
单位：days, weeks, months, years

输出格式

所有命令均返回 JSON。成功响应包含 "success": true。错误响应包含 "error": "消息"。

{
  "success": true,
  "task": {
    "id": "abc123",
    "name": "任务名称",
    "note": "备注内容",
    "flagged": false,
    "completed": false,
    "deferDate": "2026-01-30",
    "dueDate": "2026-02-01",
    "project": "项目名称",
    "tags": ["标签1", "标签2"],
    "repeat": {"method": "fixed", "rule": "RRULE:FREQ=WEEKLY;INTERVAL=1"}
  }
}

示例

# 添加任务到收件箱
of add "购买杂货"

# 添加任务到指定项目
of add "审阅文档" "工作项目"

# 设置截止日期并标记
of due abc123 2026-02-01
of flag abc123 true

# 添加标签
of tag abc123 "紧急"
of tag abc123 "家庭"

# 创建重复任务
of add "每周回顾" "习惯"
of repeat xyz789 fixed 1 weeks

# 搜索并完成任务
of search "杂货"
of complete abc123

# 获取今日任务
of today

注意事项

• 任务 ID 为 OmniFocus 内部 ID（在所有任务响应中返回）
• 日期使用 ISO 格式：YYYY-MM-DD
• 项目和文件夹名称区分大小写
• 使用 tag 命令时，若标签不存在会自动创建
• 所有输出均为 JSON 格式，便于解析

技术细节

本技能主要使用 JavaScript for Automation (JXA) 执行操作，对于标签和重复任务操作则回退到 AppleScript（由于已知的 JXA 类型转换错误与这些特定 OmniFocus API 的兼容性问题）。

这种混合方法提供了：
- 易于解析的 JSON 输出
- 对标签名称中特殊字符的稳健转义处理
- 带有清晰消息的错误处理

首次运行： OmniFocus 可能会提示允许自动化访问。请在“系统设置”>“隐私与安全性”>“自动化”中启用。