> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ticktick

> 通过已连接账户组织项目、任务、评论和标签的任务管理与待办事项应用。

# Ticktick

当你需要在工作流中创建、更新、完成或查看任务和项目时，可以使用 TickTick。它也适用于你需要评论、标签或项目数据来分派工作的场景。

## 配置

| 选项 | 必需 | 说明 |
| - | - | - |
| 名称 | 否 | 工作流画布中此步骤的标签。 |
| 身份验证 | 是 | 此步骤要使用的已连接 Ticktick 账户。 |
| 操作 | 是 | 要执行的 Ticktick 操作（例如 Get User Projects、Get Project By ID、Get Project With Data、Create Project）。 |
| 参数 | 是 | 由该操作的 schema 生成的每个操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，可用于插入 `{{placeholder}}` 值。高级用法还提供 **Raw JSON** 选项卡。 |
| 步骤失败时 | 否 | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。 |

在配置此步骤之前，请使用登录流程在工作区的 **Integrations** 中连接 Ticktick。如果没有可用的活动连接，步骤会显示一个警告，并提供指向 **Integrations** 的链接，而不是账户选择器。

## 参数表单

当你选择某个操作时，**Arguments** 部分会根据该操作的输入 schema 渲染一个表单。引用现有记录的字段包含下拉选择器。

如果你更喜欢手动编写完整的参数对象，请切换到 **Raw JSON** 选项卡。任一选项卡中的更改都会保持同步。

## 常用操作

| 操作 | 说明 |
| - | - |
| **Get User Projects** | 检索已连接账户可访问的所有项目。 |
| **Get Project By ID** | 通过 ID 检索单个项目。 |
| **Get Project With Data** | 检索项目及其任务和列。 |
| **Create Project** | 创建新项目。 |
| **Update Project** | 更新现有项目。 |
| **List All Tasks** | 列出你所有项目中的所有未完成任务。 |
| **Filter Tasks** | 返回匹配项目、日期、优先级、标签、类型或状态筛选条件的任务。 |
| **Get Task By Project And ID** | 通过 ID 从某个项目中检索任务。 |
| **Create Task** | 创建新任务。 |
| **Update Task** | 更新现有任务。 |
| **Complete Task** | 将任务标记为已完成。 |
| **Batch Create Or Update Tasks** | 一次请求中最多创建或更新 50 个任务。 |
| **Add Task Comment** | 为任务添加评论。 |
| **List Task Comments** | 列出附加到任务的评论。 |
| **List Tags** | 列出你账户可用的标签。 |

删除记录等破坏性操作在工作流操作选择器中不可用。

## 输出

此步骤会将 Ticktick 响应存储为步骤输出。响应的结构取决于操作。

在后续步骤中使用完整输出引用：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## 示例

1. 打开 **Integrations**，如果你还没有连接过 Ticktick，就先连接它。
2. 在工作流中添加一个 **Ticktick** 步骤。
3. 在 **Authentication** 中选择一个已连接账户。
4. 在 **Action** 中选择 **Get User Projects**。
5. 填写所需字段。对任何字段值，使用 **Insert Variable** 引用前一步的输出。
6. 点击步骤标题中的 **Run** 来测试该操作，然后在 **Output** 中查看返回的载荷。

## 使用场景

### 根据表单回复创建任务

1. Create Task
2. Update Task
3. Get Task By Project And ID

### 完成已完成的工作

1. List All Tasks
2. Complete Task
3. Add Task Comment

### 查看项目及其任务

1. Get Project By ID
2. Get Project With Data
3. List Task Comments

## 说明

* 此步骤依赖于你工作区中已连接的 Ticktick 集成。
* 工作流操作选择器显示的是一组精选操作。拥有 Ticktick 工具的代理可以使用更多操作。
* 登录界面可能会显示第三方授权品牌标识。

## 将 Ticktick 作为代理工具使用

你也可以在 **Agent Editor** 中将 Ticktick 作为工具添加。打开代理，点击 **Add tool**，然后选择 **Ticktick**。在工具设置面板中，选择代理应使用的已连接账户。代理会在与对话相关时调用 Ticktick 操作。

另请参阅：[Integrations](https://docs.fetchhive.com/zh/workspace/integrations.md)、[Creating and Editing](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md) 和 [Testing and Iteration](https://docs.fetchhive.com/zh/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.