Things

Things 是一款屡获殊荣的个人任务管理器，旨在帮助你规划每一天、管理项目并朝着目标切实迈进。它将优美的极简设计与强大的功能相结合，助你理清思路、井井有条地处理从日常琐事到人生目标的各项事务。Protocol Launcher 允许你生成深度链接，以便在 Things 中快速打开并管理你的任务。

使用

提供两种使用方式：

• 按需加载（通过子路径导入），支持 Tree Shaking，体积更小。
• 全量导入（从根包导入），使用简单，但会包含所有应用模块。

生产环境建议使用按需加载以减小体积；快速脚本或演示可选择全量导入。

选择安装方式

按需加载

推荐使用。生产环境优化。

全量导入

使用便捷。适合快速脚本。

打开 Things

On-Demand

import { open } from 'protocol-launcher/things'

const url = open()

打开 Things

搜索

On-Demand

import { search } from 'protocol-launcher/things'

const url = search({
  query: 'vacation',
})

在 Things 中搜索

显示

显示内置列表、项目、区域、标签或待办事项。

On-Demand

import { show } from 'protocol-launcher/things'

// 显示今日列表
const url = show({
  id: 'today',
})

// 通过 ID 显示项目
const url = show({
  id: 'GJJVZHE7SNu7xcVuH2xDDh',
})

// 通过查询显示
const url = show({
  query: 'vacation',
})

// 通过查询和筛选显示
const url = show({
  query: 'vacation',
  filter: 'errand',
})

显示今日列表 显示项目 通过查询显示 通过查询和筛选显示

添加项目

向 Things 添加新项目。

On-Demand

import { addProject } from 'protocol-launcher/things'

// 添加带开始日期的项目
const url = addProject({
  title: 'Build treehouse',
  when: 'today',
})

// 添加到区域
const url = addProject({
  title: 'Plan Birthday Party',
  area: 'Family',
})

// 添加带截止日期的项目
const url = addProject({
  title: 'Submit Tax',
  deadline: 'December 31',
  areaId: 'Lg8UqVPXo2SbJNiBpDBBQ',
})

添加项目 添加到区域 添加带截止日期的项目

更新项目

更新现有项目（需要 auth-token）。

On-Demand

import { updateProject } from 'protocol-launcher/things'

// 更新项目开始日期
const url = updateProject({
  id: 'Jvj7EW1fLoScPhaw2JomCT',
  authToken: 'xxx',
  when: 'tomorrow',
})

// 添加标签到项目
const url = updateProject({
  id: 'Jvj7EW1fLoScPhaw2JomCT',
  authToken: 'xxx',
  addTags: 'Important',
})

// 清除项目截止日期
const url = updateProject({
  id: 'Jvj7EW1fLoScPhaw2JomCT',
  authToken: 'xxx',
  deadline: '',
})

更新项目 添加标签到项目 清除项目截止日期

添加待办

向 Things 添加新的待办事项。

On-Demand

import { add } from 'protocol-launcher/things'

// 添加简单待办
const url = add({
  title: 'Book flights',
})

// 添加带备注和标签的待办
const url = add({
  title: 'Buy milk',
  notes: 'Low fat.',
  when: 'evening',
  tags: 'Errand',
})

// 添加多个待办
const url = add({
  titles: 'Milk\nBeer\nCheese',
  list: 'Shopping',
})

添加待办 添加带备注的待办 添加多个待办

更新待办

更新现有待办（需要 auth-token）。

On-Demand

import { update } from 'protocol-launcher/things'

// 更新待办开始日期
const url = update({
  id: 'SyJEz273ceSkabUbciM73A',
  authToken: 'xxx',
  when: 'today',
})

// 更新待办标题
const url = update({
  id: 'SyJEz273ceSkabUbciM73A',
  authToken: 'xxx',
  title: 'Buy bread',
})

// 追加备注到待办
const url = update({
  id: 'SyJEz273ceSkabUbciM73A',
  authToken: 'xxx',
  appendNotes: 'Wholemeal bread',
})

// 清除待办截止日期
const url = update({
  id: 'SyJEz273ceSkabUbciM73A',
  authToken: 'xxx',
  deadline: '',
})

更新待办 更新待办标题 追加备注到待办 清除待办截止日期

JSON 导入

基于 JSON 的高级导入功能，用于导入项目和待办事项。

On-Demand

import { json } from 'protocol-launcher/things'

// 导入带待办的项目
const url = json({
  data: [
    {
      type: 'project',
      attributes: {
        title: 'Go Shopping',
        items: [
          {
            type: 'to-do',
            attributes: {
              title: 'Bread',
            },
          },
          {
            type: 'to-do',
            attributes: {
              title: 'Milk',
            },
          },
        ],
      },
    },
  ],
})

// 带 auth-token 导入
const url = json({
  authToken: 'xxx',
  data: [
    {
      type: 'to-do',
      attributes: {
        title: 'Milk',
      },
    },
  ],
})

导入项目数据 带 Auth Token 导入