用途:通过 JXA 脚本自动化管理 OmniFocus 中的任务,可在用户请求与 OmniFocus 交互时使用。
主要能力:scripts/ 目录下的脚本包括 add_task.js(添加任务到收件箱)、list_tasks.js(按过滤条件列出任务)、search_tasks.js(按关键词搜索任务)、complete_task.js(按名称完成任务)、update_task.js(更新任务属性)、get_stats.js(获取统计信息)。
使用方式:运行命令 osascript -l JavaScript scripts/<script-name>.js [args]。添加任务示例:osascript -l JavaScript scripts/add_task.js "任务名" ["备注"] ["YYYY-MM-DD"],返回任务 ID。列出任务示例:osascript -l JavaScript scripts/list_tasks.js [filter] [limit],过滤器包括 inbox、available(默认)、flagged、due-soon、overdue、all。搜索示例:osascript -l JavaScript scripts/search_tasks.js "关键词" [limit]。完成示例:osascript -l JavaScript scripts/complete_task.js "任务名"。更新示例:osascript -l JavaScript scripts/update_task.js "任务名" [--note "文本"] [--due "YYYY-MM-DD"] [--flag true/false]。统计示例:osascript -l JavaScript scripts/get_stats.js,返回 total、incomplete、inbox、flagged、overdue、dueSoon、available、blocked 等计数。
输出处理:脚本返回 JSON,建议解析后以用户友好格式呈现,突出逾期和即将到期项。
限制:需要 macOS 且 OmniFocus 已安装并运行;脚本需具备执行权限;日期格式为 YYYY-MM-DD;任务名称精确匹配区分大小写,搜索不区分大小写;所有操作作用于默认 OmniFocus 文档;除添加、完成和更新外,脚本为只读安全。更多细节参见 references/jxa-api.md 与 references/automation-guide.md。