透過深度連結 自動化你的任務
使用 taskforge:/// URL Scheme，從任何應用程式建立任務、開啟列表、導覽 TaskForge。支援 Obsidian、Apple 捷徑、Raycast、Alfred、Tasker 及任何支援自訂 URL 的工具。
TaskForge 在所有平台上註冊了 taskforge:// 自訂 URL Scheme。深度連結使用三條斜線（///），在 iOS、Android 和 macOS 上均可使用。
taskforge:///[path]?[parameters] 請注意三條斜線（///）。這是所有平台通用的標準格式。
可用路由
TaskForge 支援以下導覽路由。每個路由會開啟應用程式中的特定畫面。
首頁
開啟首頁。
taskforge:/// 或 taskforge:///home 自訂列表
依名稱開啟特定的自訂列表。列表名稱是路徑參數，必須進行 URL 編碼。
taskforge:///list/My%20List 任務詳情
依 ID 開啟特定任務。點擊任務詳情畫面的連結圖示可取得任務的深度連結。
taskforge:///task/abc123def456 行事曆
開啟行事曆檢視。可選擇以 YYYY-MM-DD 格式提供日期作為路徑參數。
taskforge:///calendar 或 taskforge:///calendar/2025-03-15 快速新增
開啟支援自然語言剖析的快速新增對話框。可選擇加上 ?listId=uuid 來指定特定列表。
taskforge:///quick-add 新增任務
開啟新增任務畫面。支援查詢參數預先填入欄位（請參閱下方參數說明）。
taskforge:///new-task 搜尋
開啟首頁並啟用搜尋列。
taskforge:///?search=true 設定
開啟設定畫面。
taskforge:///settings 深度連結參考
開啟應用程式內深度連結參考畫面，顯示所有支援的路由。
taskforge:///settings/deep-links 新增任務參數
/new-task 路由接受以下查詢參數。所有參數皆為選填, 省略的欄位將使用你設定的預設值。
任務屬性
| 參數 | 格式 | 範例 | 說明 |
|---|---|---|---|
name | URL-encoded string | name=Buy%20groceries | 任務標題 |
tags | Comma-separated | tags=work,urgent | 任務標籤 |
contexts | Comma-separated | contexts=home,office | 任務情境 |
projects | Comma-separated | projects=Website,Mobile | 任務專案 |
listId | UUID string | listId=abc-123-def | 指派到自訂列表 |
日期 (ISO 8601: YYYY-MM-DD)
| 參數 | 範例 | 說明 |
|---|---|---|
dueDate | dueDate=2025-03-15 | 到期日 |
scheduledDate | scheduledDate=2025-03-10 | 排程日期 |
startDate | startDate=2025-03-01 | 開始日期 |
completedDate | completedDate=2025-03-20 | 完成日期 |
優先順序
值不區分大小寫。
Highest, High, Medium, Low, Lowest, None 狀態
值不區分大小寫。
todo, done, cancelled, inProgress, onHold, planned, deferred, blocked, someday, ready 完成時操作
任務完成時執行的操作。值不區分大小寫。
keep, delete, archive 略過使用者預設值
在不提供替代值的情況下忽略特定的使用者預設設定。適用於從自動化中建立空白任務。
_skipTags=1 _skipDueDate=1 _skipScheduledDate=1 _skipStartDate=1 _skipDueTime=1 _skipPriority=1 _skipStatus=1 _skipReminders=1 _skipOnCompletion=1 _skipContexts=1 _skipProjects=1 _skipScheduledTime=1 _skipStartTime=1 完整範例
有到期日的簡單任務
taskforge:///new-task?name=Buy%20groceries&dueDate=2025-03-15 有標籤、優先順序和時間的工作任務
taskforge:///new-task?name=Review%20PR&tags=work,code-review&priority=High&dueDate=2025-03-15&dueAt=10:00 每週重複的任務
taskforge:///new-task?name=Team%20Standup&recurrenceInterval=1&recurrenceUnit=week&recurrenceSpecificDayOfWeek=1&dueAt=09:30 忽略所有預設值的任務
taskforge:///new-task?name=Quick%20Note&_skipTags=1&_skipDueDate=1&_skipPriority=1&_skipReminders=1 指派到自訂列表的任務
taskforge:///new-task?name=Sprint%20Task&listId=abc-123-def&tags=sprint&priority=Medium 開啟行事曆到指定日期
taskforge:///calendar/2025-12-25 快速新增到指定列表
taskforge:///quick-add?listId=abc-123-def 在 Obsidian 中使用深度連結
Obsidian 在 Markdown 連結中支援自訂 URL Scheme，是 TaskForge 深度連結的最佳搭檔。在筆記中加入可點擊的連結來建立任務、開啟列表，或直接導覽到 TaskForge 的特定檢視。
筆記中的 Markdown 連結
在 Obsidian 筆記中使用標準 Markdown 連結語法建立可點擊的深度連結：
從會議筆記建立後續任務
[Add follow-up task](taskforge:///new-task?name=Follow%20up%20on%20meeting&tags=work&dueDate=2025-03-20) 快速連結到工作列表
[Open Work Tasks](taskforge:///list/Work%20Tasks) 開啟今天的行事曆檢視
[Today's Calendar](taskforge:///calendar/2025-03-15) 用自然語言快速新增
[Quick Add Task](taskforge:///quick-add) Obsidian 工作流程創意
會議筆記範本
在會議筆記範本底部加入深度連結按鈕。每次會議結束後，點擊即可建立預填標籤和到期日的後續任務。
專案儀表板
將 Obsidian 筆記用作專案儀表板。加入連結來開啟對應的 TaskForge 列表、建立新的專案任務，或在行事曆中檢視專案到期日。
每日筆記整合
在每日筆記範本中加入深度連結。包含開啟今日任務列表的連結、用於記錄想法的快速新增，以及檢視行程的行事曆檢視。
每週回顧範本
建構每週回顧範本，包含建立下週重複任務、開啟回顧列表、導覽到行事曆進行規劃的深度連結。
與其他應用程式整合
TaskForge 深度連結可與任何能夠開啟自訂 URL Scheme 的應用程式或工具搭配使用。以下是各平台上的熱門整合方式。
Apple 捷徑 (iOS / macOS)
使用捷徑應用程式建立強大的自動化。透過"開啟 URL"動作搭配 TaskForge 深度連結，使用 Siri 建立任務、觸發定時自動化，或建構基於位置的工作流程。
Add an "Open URL" action and set the URL to taskforge:///new-task?name=My%20Task&tags=work&priority=High. Name the shortcut and trigger it with "Hey Siri, [shortcut name]".
結合捷徑變數，從剪貼簿內容、行事曆事件或使用者輸入動態產生任務名稱。
Raycast (macOS)
建構自訂 Raycast 指令在 TaskForge 中建立任務。使用深度連結和"Open URL"動作，無需離開目前應用程式即可用鍵盤建立任務。
Create a Raycast script command that opens taskforge:///new-task?name={query}&tags=inbox to capture tasks from anywhere on your Mac.
使用 Raycast 的引數支援，從搜尋列直接傳遞動態任務名稱。
Alfred (macOS)
建構 Alfred 工作流程將任務傳送到 TaskForge。建立接受引數的自訂關鍵字，並將引數進行 URL 編碼後傳遞給 TaskForge 深度連結。
Create a workflow with keyword "task" that opens taskforge:///new-task?name={query}&tags=alfred.
使用 Alfred 的"Open URL"動作搭配動態引數實現快速擷取。
Tasker (Android)
使用 Tasker 在 Android 上自動化 TaskForge。透過"Browse URL"動作，從由時間、位置或事件觸發的 Tasker 設定檔中開啟 TaskForge 深度連結。
Create a Tasker profile that opens taskforge:///list/Work%20Tasks when you connect to your office Wi-Fi.
結合 AutoInput 或其他 Tasker 外掛程式實現進階自動化流程。
Keyboard Maestro (macOS)
建立透過深度連結觸發 TaskForge 操作的巨集。結合文字展開、剪貼簿監控或鍵盤快速鍵，實現情境感知的任務建立。
Set up a hotkey macro that opens taskforge:///new-task?name=%CurrentClipboard%&tags=capture to create a task from your clipboard.
非常適合從任何應用程式中選取的文字建立任務。
IFTTT / Zapier / Make
將 TaskForge 連結到數百個 Web 服務。使用 Webhook 或 URL 動作，從電子郵件、行事曆事件、表單提交或這些平台支援的任何觸發器建立任務。
Create a Zapier workflow that opens a TaskForge deep link when a specific label is added to a Gmail message.
使用這些平台的 URL 編碼功能，安全地將動態資料傳遞到深度連結參數中。
網頁和書籤小程式
在任何網頁中加入 TaskForge 深度連結，或建立瀏覽器書籤小程式快速建立任務。在安裝了應用程式的裝置上點擊連結即可開啟 TaskForge。
HTML: <a href="taskforge:///new-task?name=Review%20Document">Add Review Task</a>
建立一個書籤小程式，將目前頁面標題擷取為任務名稱。
錯誤處理
- 無效參數會被靜默忽略。任務將在沒有該欄位的情況下建立，回退到使用者預設設定。
- 格式錯誤的日期（例如 dueDate=not-a-date）會被略過，該欄位保持為空。
- 無效的列舉值（例如 priority=SuperHigh）會被略過。
- reminders 參數中的無效 JSON 會被略過。
- 未知路由會回退到首頁。
- 缺少必要資料時（例如沒有任務 ID 的 /task/）會回退到首頁。
平台支援
iOS 和 macOS
taskforge:// URL Scheme 已在應用程式的 Info.plist 中註冊。深度連結可從 Safari、捷徑、Spotlight 及任何能開啟 URL 的應用程式中使用。
Android
taskforge:// URL Scheme 透過 AndroidManifest.xml 中的 Intent Filter 註冊。深度連結可從任何能發送 ACTION_VIEW Intent 的應用程式中使用。
常見問題
深度連結在所有平台上都能使用嗎？
是的。TaskForge 深度連結在 iOS、iPadOS、macOS 和 Android 上均可使用。taskforge:// URL Scheme 在每個平台上都原生註冊。
需要對深度連結參數進行本地化嗎？
不需要。深度連結參數始終為英文，與應用程式語言設定無關。路由路徑、參數名稱和優先順序等列舉值始終為英文。任務名稱和標籤等自由輸入值可以使用任何語言, 只需進行 URL 編碼即可。
使用了無效參數會怎樣？
無效或無法辨識的參數會被靜默忽略。缺少的欄位將使用已設定的預設值，任務仍會正常建立。
可以透過深度連結建立有提醒的任務嗎？
可以。提醒透過 reminders 參數以 URL 編碼的 JSON 陣列傳遞。每個提醒物件包含 type、relatedTo 和 offset 等欄位。完整的 JSON 格式請參閱應用程式內深度連結參考。
如何取得 listId 參數所需的列表 ID？
在 TaskForge 中開啟自訂列表編輯器，點擊連結圖示。深度連結 URL 中會包含可用於 listId 參數的列表識別碼。
可以在 Obsidian 中使用深度連結嗎？
當然可以。在 Obsidian 筆記中直接加入 [Create Task](taskforge:///new-task?name=My%20Task) 這樣的 Markdown 連結即可。點擊連結後 TaskForge 會開啟並建立任務。
免費 - iOS 和 Mac 
免費 - Android