透過深度連結 自動化你的任務
使用 taskforge:/// URL 方案，從任何應用程式建立任務、開啟列表、導覽 TaskForge。支援 Obsidian、Apple 捷徑、Raycast、Alfred、Tasker 及任何支援自訂 URL 的工具。
TaskForge 在所有平台上註冊了 taskforge:// 自訂 URL 方案。深度連結使用三條斜線（///），在 iOS、Android、macOS 和 Windows 上均可使用。
taskforge:///[path]?[parameters] 請注意三條斜線（///）。這是所有平台通用的標準格式。
可用路由
TaskForge 支援以下導覽路由。每個路由會開啟應用程式中的特定畫面。
首頁
開啟首頁。
taskforge:/// 或 taskforge:///home 空間
依名稱開啟特定的空間。名稱是路徑參數，必須進行 URL 編碼。舊版 taskforge:///list/ 前綴仍可作為已棄用的別名繼續使用，因此你之前取得的連結依然有效。
taskforge:///space/My%20Space 依標籤檢視任務
開啟帶有特定標籤的所有任務。標籤是路徑參數，必須進行 URL 編碼。
taskforge:///tag/urgent 依情境檢視任務
開啟具有特定情境的所有任務。情境是路徑參數，必須進行 URL 編碼。
taskforge:///context/home 依專案檢視任務
開啟特定專案中的所有任務。專案是路徑參數，必須進行 URL 編碼。
taskforge:///project/Website 任務詳情
依 ID 開啟特定任務。點選任務詳情畫面的連結圖示可取得任務的深度連結。ID 是根據任務標題和檔案產生的，因此若之後重新命名任務或移動其檔案，已儲存的任務連結將無法解析；請在編輯後重新取得連結。
taskforge:///task/abc123def456 筆記
透過相對於儲存庫的路徑開啟指定筆記。此路徑是查詢參數，必須進行 URL 編碼，包括巢狀筆記中的斜線。未知或缺失的路徑不會導致錯誤，而是會開啟筆記瀏覽器。
taskforge:///note?path=Projects%2FMy%20Note.md 今日筆記
開啟今日筆記，如果尚不存在，會先依你設定的範本建立它。
taskforge:///daily-note 新增筆記
開啟筆記編輯器，開始撰寫一篇全新的空白筆記。
taskforge:///new-note 行事曆
開啟行事曆檢視。可選擇以 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 編碼字串 | name=Buy%20groceries | 任務標題 |
tags | 以逗號分隔 | tags=work,urgent | 任務標籤 |
contexts | 以逗號分隔 | contexts=home,office | 任務情境 |
projects | 以逗號分隔 | projects=Website,Mobile | 任務專案 |
listId | UUID 字串 | 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 _skipDuration=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&recurrenceWeekdays=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 依儲存庫路徑開啟筆記
taskforge:///note?path=Projects%2FMy%20Note.md 前往（或建立）今日筆記
taskforge:///daily-note 在 Obsidian 中使用深度連結
Obsidian 在 Markdown 連結中支援自訂 URL 方案，是 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:///space/Work%20Tasks) 開啟今天的行事曆檢視
[Today's Calendar](taskforge:///calendar/2025-03-15) 用自然語言快速新增
[Quick Add Task](taskforge:///quick-add) Obsidian 工作流程創意
會議筆記範本
在會議筆記範本底部加入深度連結按鈕。每次會議結束後，點選即可建立預填標籤和到期日的後續任務。
專案儀表板
將 Obsidian 筆記用作專案儀表板。加入連結來開啟對應的 TaskForge 列表、建立新的專案任務，或在行事曆中檢視專案到期日。
每日筆記整合
在每日筆記範本中加入深度連結。包含開啟今日列表檢視的連結、用於記錄想法的快速新增，以及檢視行程的行事曆檢視。
每週回顧範本
建構每週回顧範本，包含建立下週重複任務、開啟回顧列表、導覽到行事曆進行規劃的深度連結。
與其他應用程式整合
TaskForge 深度連結可與任何能夠開啟自訂 URL 方案 的應用程式或工具搭配使用。以下是各平台上的熱門整合方式。
Apple 捷徑 (iOS / macOS)
使用捷徑應用程式建立強大的自動化。透過"開啟 URL"動作搭配 TaskForge 深度連結，使用 Siri 建立任務、觸發定時自動化，或建構基於位置的工作流程。
新增一個「開啟 URL」動作，並將 URL 設為 taskforge:///new-task?name=My%20Task&tags=work&priority=High。為捷徑命名，然後用「嘿 Siri，[捷徑名稱]」觸發它。
結合捷徑變數，從剪貼簿內容、行事曆行程或使用者輸入動態產生任務名稱。
Raycast (macOS)
建構自訂 Raycast 指令在 TaskForge 中建立任務。使用深度連結和"Open URL"動作，無需離開目前應用程式即可用鍵盤建立任務。
建立一個 Raycast 指令碼指令，開啟 taskforge:///new-task?name={query}&tags=inbox，在 Mac 上任何地方都能擷取任務。
使用 Raycast 的引數支援，從搜尋列直接傳遞動態任務名稱。
Alfred (macOS)
建構 Alfred 工作流程將任務傳送到 TaskForge。建立接受引數的自訂關鍵字，並將引數進行 URL 編碼後傳遞給 TaskForge 深度連結。
建立一個關鍵字為「task」的工作流程，開啟 taskforge:///new-task?name={query}&tags=alfred。
使用 Alfred 的"Open URL"動作搭配動態引數實現快速擷取。
Tasker (Android)
使用 Tasker 在 Android 上自動化 TaskForge。透過"Browse URL"動作，從由時間、位置或行程觸發的 Tasker 設定檔中開啟 TaskForge 深度連結。
建立一個 Tasker 設定檔，在連上辦公室 Wi-Fi 時開啟 taskforge:///space/Work%20Tasks。
結合 AutoInput 或其他 Tasker 外掛程式，打造更複雜的自動化流程。
Keyboard Maestro (macOS)
建立透過深度連結觸發 TaskForge 操作的巨集。結合文字展開、剪貼簿監控或鍵盤快速鍵，實現情境感知的任務建立。
設定一個熱鍵巨集，開啟 taskforge:///new-task?name=%CurrentClipboard%&tags=capture，從剪貼簿內容建立任務。
非常適合從任何應用程式中選取的文字建立任務。
IFTTT / Zapier / Make
將 TaskForge 連結到數百個 網路服務。使用 Webhook 或 URL 動作，從電子郵件、行事曆行程、表單提交或這些平台支援的任何觸發器建立任務。
建立一個 Zapier 工作流程，在 Gmail 訊息被加上特定標籤時開啟 TaskForge 深度連結。
使用這些平台的 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 方案 已在應用程式的 Info.plist 中註冊。深度連結可從 Safari、捷徑、Spotlight 及任何能開啟 URL 的應用程式中使用。
Android
taskforge:// URL 方案 透過 AndroidManifest.xml 中的 Intent Filter 註冊。深度連結可從任何能發送 ACTION_VIEW Intent 的應用程式中使用。
常見問題
深度連結在所有平台上都能使用嗎？
是的。TaskForge 深度連結在 iOS、iPadOS、macOS、Android 和 Windows 上均可使用。taskforge:// URL 方案 在每個平台上都原生註冊。
需要對深度連結參數進行本地化嗎？
不需要。深度連結參數始終為英文，與應用程式語言設定無關。路由路徑、參數名稱和優先順序等列舉值始終為英文。任務名稱和標籤等自由輸入值可以使用任何語言， 只需進行 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 會開啟並建立任務。