Apple 快捷指令
Mindwtr 通过 iPhone 和 iPad 上的原生 App Intents 支持 Apple 快捷指令。首个版本聚焦 GTD 记录循环：快速把未闭合事项放入 Mindwtr，再在应用内回顾和处理。
这套功能有意小于 Things 已成熟的快捷指令系统。Things 提供创建、查找、编辑、显示和自定义项目/清单操作。Mindwtr v1 从记录与导航开始，确保可靠，并且不会绕过 Mindwtr 的常规任务创建、修订和同步路径。
可用范围
包含 Mindwtr 的 App Intents 集成的 iOS 构建可使用 Apple 快捷指令。
支持的界面：
| 界面 | 是否支持 |
|---|---|
| 快捷指令应用 | 是 |
| Siri | 是 |
| Spotlight / 建议的快捷指令 | 是 |
| 通过操作按钮运行快捷指令 | 是 |
| Apple Watch 直接操作 | 否，v1 不支持 |
| CarPlay | 否，v1 不支持 |
操作
记录到 Mindwtr
使用 记录到 Mindwtr 把任务发送到 Mindwtr 的收集箱记录确认流程。
参数：
| 参数 | 必填 | 说明 |
|---|---|---|
| 任务 | 是 | 任务标题。空标题会被拒绝。 |
| 备注 | 否 | 添加为任务描述。 |
| 标签 | 否 | 逗号分隔的标签。Mindwtr 保存时会规范化为 #tag。 |
| 项目 | 否 | 按标题匹配活跃项目；保存记录时也可创建项目。 |
运行时会：
- 快捷指令打开 Mindwtr。
- Mindwtr 显示记录界面，并填入标题和可选元数据。
- 你检查记录，再通过 Mindwtr 的常规流程保存。
Swift 不会直接写入任务，因此任务创建始终通过 Mindwtr 现有的存储、SQLite、修订和同步逻辑。
打开 Mindwtr 清单
使用打开 Mindwtr 清单跳到 GTD 视图。
支持的目标：
| 清单 | 打开位置 |
|---|---|
| 收集箱 | 收集箱 |
| 专注 | 专注/下一步行动 |
| 等待 | 等待中 |
| 将来 | 将来/也许 |
| 项目 | 项目 |
| 回顾 | 回顾 |
| 日历 | 日历 |
未配置清单时，快捷指令默认打开收集箱。
添加到 Mindwtr 收集箱
使用添加到 Mindwtr 收集箱可在不打开 Mindwtr 的情况下静默创建任务。这项操作适合用于快捷指令自动化。时间、日历或位置触发器无需有人操作手机即可添加任务。
参数：
| 参数 | 必填 | 说明 |
|---|---|---|
| 任务 | 是 | 任务标题。空标题会让快捷指令失败。 |
| 备注 | 否 | 添加为任务描述。 |
| 标签 | 否 | 逗号分隔的标签。Mindwtr 会规范化为 #tag。 |
| 项目 | 否 | 按标题匹配活跃项目。未知或已归档项目会被忽略，任务仍会进入收集箱。 |
运行时会：
- 操作在设备上将记录加入队列并立即结束。Mindwtr 保持在后台。
- 下次打开 Mindwtr（或返回前台）时，排队的任务会通过常规存储与同步路径创建到收集箱。
由于任务在下次打开应用时才创建，因此在这台 iPhone 或 iPad 上再次运行 Mindwtr 之前，它不会出现在其他已同步设备上，也不会触发提醒。与 记录到 Mindwtr 不同，这项操作绝不会创建新项目。
示例：日历触发的任务
- 在快捷指令应用中打开自动化并新建自动化。
- 选择触发器，例如标题包含“garbage collection”的日历事件。
- 添加 Mindwtr 的添加到 Mindwtr 收集箱操作，将任务设为“Take out the trash”。
- 将自动化设为立即运行，无需确认。
快捷指令示例
通过语音记录
- 打开 Apple 的快捷指令应用。
- 新建快捷指令。
- 添加听写文本或询问输入。
- 添加 Mindwtr 的 记录到 Mindwtr 操作。
- 把听写文本传入任务。
- 可将标签设为
phone,errands等内容。
这适合在步行、通勤或切换应用时快速记录。Siri 语音识别在某些环境中仍可能听错，请在保存前检查记录。
通过操作按钮打开专注
- 使用打开 Mindwtr 清单创建快捷指令。
- 将清单设为专注。
- 在 iOS 设置中把该快捷指令分配给操作按钮。
URL scheme 备用方案
Mindwtr 还支持 URL scheme 自动化。其他自动化工具无法发现原生 App Intents 时可使用。
| URL | 操作 |
|---|---|
mindwtr://capture?title=Buy%20groceries | 打开记录并填入标题 |
mindwtr://capture?title=Buy%20groceries¬e=From%20store | 打开记录并填入标题和备注 |
mindwtr://capture?title=Buy%20groceries&project=Shopping&tags=errands,home | 打开记录并填入项目和标签 |
mindwtr://open-feature?feature=focus | 打开专注 |
mindwtr://open-feature?feature=review | 打开回顾 |
支持的记录别名：
| 字段 | 别名 |
|---|---|
| 标题 | title、text、name、thingName、itemListElementName、itemListName |
| 备注 | note、description、body、thingDescription、itemListDescription |
v1 限制
Mindwtr v1 不包含：
- 自定义 AppEntity 任务或清单类型。
- 查找、编辑、复制、删除或批量操作。
- 直接从快捷指令设置重复任务、提醒或日期计划。
- Apple Watch 或 CarPlay 支持。
这些都是很好的未来候选功能，但需要谨慎设计，因为编辑和后台写入必须保持 Mindwtr 的本地优先同步与 GTD 工作流程规则。