通过深度链接 自动化你的任务
使用 taskforge:/// URL Scheme，从任意应用创建任务、打开列表、导航 TaskForge。支持 Obsidian、Apple 快捷指令、Raycast、Alfred、Tasker 及任何支持自定义 URL 的工具。
TaskForge 在所有平台上注册了 taskforge:// 自定义 URL Scheme。深度链接使用三个斜杠（///），在 iOS、安卓、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 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:///space/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 创建任务、触发定时自动化，或搭建基于位置的工作流。
添加“打开 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（安卓）
使用 Tasker 在安卓上自动化 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 Scheme 已在应用的 Info.plist 中注册。深度链接可从 Safari、快捷指令、Spotlight 及任何能打开 URL 的应用中使用。
安卓
taskforge:// URL Scheme 通过 AndroidManifest.xml 中的 Intent Filter 注册。深度链接可从任何能发送 ACTION_VIEW Intent 的应用中使用。
常见问题
深度链接在所有平台上都能使用吗？
是的。TaskForge 深度链接在 iOS、iPadOS、macOS、安卓和 Windows 上均可使用。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 会打开并创建任务。