Apple 捷徑

Mindwtr 透過 App Intents，在 iPhone、iPad 及原生 Apple Watch App 上支援 Apple 捷徑，著重於 GTD 收集循環：快速將未竟事項放入 Mindwtr，再到應用程式內回顧及處理。第 2 版新增了帶日期的靜默收集、將任務讀入捷徑，以及 Spotlight 搜尋。

這項功能刻意比 Things 成熟的捷徑系統精簡。Mindwtr 會謹慎地擴充動作範圍，以維持可靠性，也絕不繞過 Mindwtr 的一般任務建立、修訂及同步流程。

可用範圍

包含 Mindwtr App Intents 整合的 iOS 組建可使用 Apple 捷徑支援。

支援的介面：

介面	支援狀態
「捷徑」app	是
Siri	是
Spotlight／建議的捷徑	是
透過動作按鈕執行捷徑	是
Apple Watch 直接操作	支援，可在原生 Watch App 中開啟記錄或啟動番茄鐘。從下一個穩定版開始包含
CarPlay	否，v1 不支援

動作

Capture to Mindwtr

使用 Capture to Mindwtr，將任務送入 Mindwtr 的收集箱收集確認流程。

參數：

參數	必要	說明
Task	是	任務標題。空白標題會遭拒絕。
Note	否	新增為任務描述。
Tags	否	以逗號分隔的標籤。Mindwtr 儲存時會將其正規化為 #tag。
Project	否	依標題比對使用中的專案；若沒有相符專案，儲存收集項目時會建立專案。

執行時會發生以下情況：

1. 「捷徑」會開啟 Mindwtr。
2. Mindwtr 顯示收集畫面，並填入標題及選用的中繼資料。
3. 你可以檢視收集項目，再透過 Mindwtr 的一般流程儲存。

任務不會直接從 Swift 寫入。這能讓任務建立留在 Mindwtr 既有的 store、SQLite、修訂及同步邏輯內。

Open Mindwtr List

使用 Open Mindwtr List 跳至 GTD 檢視。

支援的目的地：

清單	開啟位置
Inbox	收集箱
Focus	專注／下一步行動
Waiting	等待中
Someday	將來／也許
Projects	專案
Review	回顧
Calendar	行事曆

若未設定清單，捷徑預設開啟收集箱。

Add to Mindwtr

使用 Add to Mindwtr（v2 之前稱為 Add to Mindwtr Inbox）可安靜建立任務，而不開啟 Mindwtr。這適合在「捷徑」的「自動化」中使用。時間、行事曆或位置觸發條件可以在無人操作手機時新增任務。

參數：

參數	必要	說明
Task	是	任務標題。空白標題會讓捷徑失敗。
Note	否	新增為任務描述。
Tags	否	以逗號分隔的標籤。Mindwtr 會將其正規化為 #tag。
Project	否	依標題比對使用中的專案。未知或已封存的專案會被忽略，任務仍會進入收集箱。
Due date	否	任務的截止日期。僅儲存日期、不含時間，因此本身絕不會排定提醒。
Start date	否	任務的開始日期，與截止日期一樣只含日期。

Task 文字支援完整的快速新增語法（/due:、@context、#tag、+Project 等）。建立任務時會像 app 內的收集框一樣解析這些語法；整理快速新增文字設定決定是否從標題中移除識別到的語法。

執行時會發生以下情況：

1. 動作會將收集項目排入裝置佇列，隨即完成；Mindwtr 維持在背景執行。
2. 下次 Mindwtr 開啟（或回到前景）時，會透過一般 store 及同步流程，在收集箱中建立佇列內的任務。

由於任務會在下次開啟時建立，因此 Mindwtr 再次於該 iPhone 或 iPad 上執行前，任務不會出現在其他同步裝置上，也不會觸發提醒。Project 參數絕不會建立新專案；不過在任務文字中寫入 +Project 會遵循快速新增規則，可以建立新專案。

Get Mindwtr Tasks

使用 Get Mindwtr Tasks 可在不開啟 app 的情況下，將任務讀入捷徑，再串接其他動作（朗讀、顯示選單、傳送到別處）。

參數	必要	說明
List	是	Inbox、Focus、Next、Waiting、Someday 其中之一。
Project	否	依標題比對使用中的專案。若有設定，會優先於清單。

結果來自 Mindwtr 執行期間維護的快照，每個清單或專案最多 50 筆任務，因此反映的是 app 上次開啟時的狀態，與小工具的即時性相同。

Spotlight 中的任務

在 iOS 18 以上版本，Mindwtr 任務會出現在 Spotlight 搜尋中。開啟其中一筆會帶你前往該任務在 Mindwtr 中所屬的清單。索引會在 app 執行時更新，與 Get Mindwtr Tasks 相同。

範例：行事曆觸發的任務

1. 在捷徑 app 中開啟自動化，並建立新的自動化操作。
2. 選擇觸發條件，例如標題含有「garbage collection」的行事曆事件。
3. 新增 Mindwtr 的 Add to Mindwtr 動作，並將 Task 設為「Take out the trash」。
4. 將自動化操作設為立即執行，使其無須確認。

捷徑範例

一鍵收集，不必開啟 Mindwtr

iOS 小工具無法顯示文字欄位或收集視窗：小工具按鈕只能開啟 App，或執行沒有畫面的動作。想要類似 Android 的流程，也就是點一下就在目前 App 上方跳出小提示框，只需建立一次這個捷徑：

1. 在捷徑中建立新捷徑，命名為「收集」。
2. 加入要求輸入（類型為文字，提示為「任務」）。在提示框中點麥克風即可改用語音聽寫。
3. 加入 Mindwtr 的 Add to Mindwtr 動作，並把輸入傳給 Task。這裡支援快速新增語法（/due:tomorrow、@phone、#tag）。
4. 把它放在小工具會在的位置：在捷徑詳細資訊中選加入主畫面，就會在小工具旁多一個圖示；設定 → 動作按鈕可用側邊按鈕執行；iOS 18 可加入控制中心；設定 → 輔助使用 → 觸控 → 背面輕點可用雙擊手機背面執行。

執行時會跳出小文字提示框，儲存後回到你原本在做的事。Mindwtr 維持關閉，任務會在下次開啟 App 時建立到收集箱，和所有 Add to Mindwtr 收集一樣。若想在儲存前先檢查任務，請改用 Capture to Mindwtr。

透過語音收集

1. 開啟 Apple 的捷徑 app。
2. 建立新捷徑。
3. 新增聽寫文字或要求輸入。
4. 新增 Mindwtr 的 Capture to Mindwtr 動作。
5. 將聽寫的文字傳入 Task。
6. 也可將 Tags 設為類似 phone,errands 的值。

這適合在步行、通勤或切換應用程式時快速收集。在某些環境中，Siri 語音辨識仍可能聽錯字詞，因此請先檢視收集內容再儲存。

從 Apple Watch 收集

使用原生 Apple Watch App，即可在手腕上收集任務。在 iPhone 的 Watch app 中安裝後，點選 Speak to Capture 錄音並交由 iPhone 轉寫，或點選 Type 輸入文字。無需伺服器或雲端同步。手機暫時無法連線時，手錶會保留記錄，並在恢復連線後傳送。可用版本和安裝步驟請參閱手錶 app 指南。

如果你希望透過手錶上的捷徑將聽寫文字傳送到自己的伺服器，可以使用下方的自架收集 webhook 方案。

1. 在 iPhone 上開啟 Apple 的捷徑 app，建立一個捷徑並命名為「Capture to Mindwtr」。
2. 新增聽寫文字。
3. 新增取得 URL 內容，並將 URL 設為 https://your-server.example/v1/capture，以你自己的伺服器位址取代範例位址。
4. 將方法設為 POST。
5. 新增名為 Authorization 的標頭，值為 Bearer <token>，並使用你伺服器的其中一組權杖。
6. 將要求內容設為文字，並傳入聽寫的文字。若要改送 JSON，請使用 transcription 欄位存放聽寫文字，再加上值為 Apple Watch 的 client 欄位。
7. 開啟捷徑的詳細資訊，開啟在 Apple Watch 上顯示。
8. 在手錶上透過捷徑 app、錶面複雜功能或智慧型堆疊執行它。同一個捷徑也可在 iPhone 上透過 Siri 或動作按鈕執行。
9. 聽寫的文字會成為收集箱中的任務，並在下次同步時送達你的其他裝置。

從動作按鈕開啟專注檢視

1. 使用 Open Mindwtr List 建立捷徑。
2. 將 List 設為 Focus。
3. 在 iOS 設定中，將該捷徑指派給動作按鈕。

URL scheme 替代方式

Mindwtr 也支援 URL scheme 自動化。當其他自動化工具看不到原生 App Intents 時，可使用此方式。

URL	動作
mindwtr://capture?title=Buy%20groceries	開啟收集畫面並填入標題
mindwtr://capture?title=Buy%20groceries&note=From%20store	開啟收集畫面並填入標題及筆記
mindwtr://capture?title=Buy%20groceries&project=Shopping&tags=errands,home	開啟收集畫面並填入專案及標籤
mindwtr://open-feature?feature=focus	開啟專注檢視
mindwtr://open-feature?feature=review	開啟回顧

支援的收集別名：

欄位	別名
Title	title, text, name, thingName, itemListElementName, itemListName
Note	note, description, body, thingDescription, itemListDescription

目前的限制

Mindwtr 的捷徑支援尚未包含：

• 編輯、完成、複製、刪除或批次動作。
• 從「捷徑」設定重複任務或提醒排程（截止日期與開始日期只含日期）。
• CarPlay。

收集以外的寫入動作是接下來的規劃，將建立在 v2 導入的任務實體之上；這些仍需仔細設計，因為編輯及背景寫入必須維持 Mindwtr 的在地優先同步及 GTD 工作流程規則。

相關連結

• 行動版使用指南
• Mindwtr 的 GTD 工作流程
• 資料與同步
• Things: Using Apple Shortcuts
• Things: Shortcuts Actions
• Apple: App Intents overview