自动化

记录时间不一定要打开 App。Siri 和“快捷指令” App 可以开始、暂停和停止活动，添加备注，并告诉其他快捷指令当前正在进行什么。以 timetrackio:// 开头的链接也能做到这些，任何能打开链接的地方都可以使用。此外，每次你开始或停止活动时，本 App 还可以打开你自己设定的链接。

Siri

本 App 自带现成的 Siri 说法，无需任何设置。例如，你可以说：

说法	作用
“Start activity in aTimeLogger Pro”	Siri 会问你要开始哪个类型，然后开始它
“Pause activity in aTimeLogger Pro”	暂停正在进行的活动
“Resume activity in aTimeLogger Pro”	Siri 会问你要恢复哪个类型，然后恢复该类型已暂停的活动
“Stop activity in aTimeLogger Pro”、“End activity in aTimeLogger Pro”或“Finish tracking in aTimeLogger Pro”	停止正在进行的活动
“Add comment to running activity in aTimeLogger Pro”或“Save comment in aTimeLogger Pro”	Siri 会问你备注内容，并把它放到正在进行的活动上，替换原有备注
“Set 睡眠质量 in aTimeLogger Pro”或“Set field value in aTimeLogger Pro”	在正在进行的活动上设置一个列表字段，见下文
“Get activities in aTimeLogger Pro”	返回正在进行和已暂停的活动，见下文

Siri 会回答它做了什么，例如“已开始工作”。

“快捷指令” App 中也有同样的操作，你可以把它们加入自己的快捷指令。

“快捷指令” App 中的操作

在“快捷指令” App 中，搜索操作“aTimeLogger Pro”：

操作	你填写的内容	作用
“开始活动”	“Activity Type”（活动类型）、“备注”（可选）	开始该类型的活动，并附上备注
“Pause activity”（暂停活动）	–	暂停正在进行的活动
“Resume activity”（恢复活动）	“Activity Type”	恢复该类型已暂停的活动
“停止活动”	“备注”（可选）	停止正在进行的活动；备注会替换该活动的备注
“保存备注”	“备注”	替换正在进行的活动的备注
“设置字段值”	“字段”、“值”	在正在进行的活动上设置一个列表字段
“Get Activities”（获取活动）	–	以文本形式返回正在进行和已暂停的活动

它们的行为如下：

“Activity Type”按完整名称列出你的活动类型，例如群组中的类型显示为“成长/学习”。只写类型名称也可以。
“Pause activity”、“停止活动”和“保存备注”只作用于一个活动。如果有多个活动正在进行，就是其中最早的那个。
如果该类型的活动已经在进行，或者该类型没有已暂停的活动，“Resume activity”会告诉你。
开始和恢复遵循“设置” → “活动” → “开始新活动时”，与在 App 中一样。参阅同时进行多个活动。
开始一个事件类型会记录一次事件。
当操作开始或停止活动时，App 不会询问备注，也不会询问列表字段。

设置字段值

此操作会在正在进行的活动上填写一个列表自定义字段，例如睡眠质量：也就是如果你在 App 里，开始或停止时 App 会询问的内容。

“字段”：你的一个列表字段。Siri 知道它们的名称，所以说“Set 睡眠质量 in aTimeLogger Pro”也可以。
“值”：该字段的一个值。留空的话，快捷指令会在运行时询问。大小写不同的值会匹配到列表中的值；不在列表中的值会让快捷指令再问一次。

如果有多个活动正在进行，值会写入最后开始、且其类型带有该字段的那个活动。如果都没有该字段，快捷指令会告诉你。

Get Activities

“Get Activities”会返回一段 JSON 文本，供其他操作读取：“活动”标签页上的每个活动各一条，正在进行的排在前面。

[
  {"typeName": "Work", "typeId": "D3A1…", "status": "RUNNING", "start": "2026-10-27T13:49:00Z"},
  {"typeName": "Study", "typeId": "8F02…", "status": "PAUSED", "start": ""}
]

status：RUNNING 或 PAUSED。
start：对于正在进行的活动，是它开始或上次恢复的时间，采用 UTC。已暂停的活动为空。
typeId：类型的标识符，重命名类型后保持不变。

示例：到达办公室时开始“工作”

在“快捷指令” App 中，打开“自动化”标签页，创建一个在你到达某个地点时运行的自动化。选择你的办公室。
添加“开始活动”作为它的操作，并把“Activity Type”设为“工作”。
再为离开该地点创建一个自动化，操作为“停止活动”。

示例：“工作”专注模式打开时记录“工作”

专注模式可以自动打开：按日程、在某个地点或在你打开某个 App 时，这些都在“设置” → “专注模式”中设置。每次它打开时，活动都会开始，无需轻点。

在“快捷指令” App 中，打开“自动化”标签页，为“专注模式”创建一个自动化。选择“工作”，然后选取“打开时”和“立即运行”。
添加“开始活动”作为它的操作，并把“Activity Type”设为“工作”。
为同一个专注模式再创建一个自动化，选择“关闭时”，并以“停止活动”作为操作。

Siri 建议

每次你在“活动”标签页上开始、暂停或停止活动时，App 都会告诉 Siri。Siri 会了解你的习惯，可能会在你通常做这件事的时间，在搜索中或锁定屏幕上建议这个操作，例如“开始工作”。

链接

以 timetrackio:// 开头的链接可以开始、暂停和停止活动。你可以在“快捷指令” App 的“打开 URL”操作中、在其他 App 中或在网页上使用它们。打开这样的链接会打开本 App。

timetrackio://start/Work
timetrackio://pause/Work
timetrackio://stop/Learning/Study

操作后面跟着类型：类型名称，或者包含其群组的完整名称，例如 Learning/Study。不区分大小写。如果两个类型同名，请使用完整名称。

start 会开始该类型的一个新活动，遵循“设置” → “活动” → “开始新活动时”。
pause 和 stop 作用于“活动”标签页上该类型的活动。如果该类型在那里有两个活动，链接不会起作用。

没有用于恢复活动的链接。

备注和标签

在 ? 后面添加备注、标签，或者两者都加：

timetrackio://start/Work?comment=Code%20review&tags=project-alpha,coding
timetrackio://stop/Work?comment=Released%20version%202

comment 会替换活动的备注。
tags 会替换活动的标签。标签之间用逗号分隔，不要加空格。
空格要写成 %20。

开始和停止时打开链接

某个类型的活动每次开始、暂停、恢复或停止时，App 都可以打开你自己设定的链接：运行一个快捷指令、通过快捷指令打开专注模式，或者打开一个网页。

打开“设置” → “高级配置” → “URL 方案”（“启动或停止调用 URL 方案”）。
打开该类型的编辑器（参阅活动类型与群组）。编辑器末尾附近会出现“URL Schemes”（URL 方案）部分，其中有“开始 URL”、“停止 URL”、“暂停 URL”和“恢复 URL”。
填写你需要的链接，然后保存该类型。

链接在类型编辑器中设置，而编辑类型是 Premium 功能。

例如，要在“工作”开始时运行你的快捷指令“Work mode”，把它的“开始 URL”设为：

shortcuts://run-shortcut?name=Work mode

按你阅读时的样子输入链接，使用普通空格：App 会在打开前对链接进行编码，所以这里不要写 %20。

只有你在“活动”标签页上的操作才会打开这些链接：轻点类型，以及“暂停”、“恢复”和“停止”按钮。事件类型不会打开它们。如果 App 在那次开始时询问备注，就不会打开“开始 URL”。从小组件、Siri、“快捷指令” App、timetrackio:// 链接或 Apple Watch 开始或停止时，都不会打开这些链接。