Nozbe

Nozbe 是一款任务和项目管理应用。Protocol Launcher 可以根据 Nozbe 官方 x-callback-url 文档生成 nozbe4:// URL，覆盖 /goto、/add_task、/update_task 和 /add_project。

Nozbe 的 x-callback-url 动作需要 secret。你可以在 Nozbe 的 Settings -> Advanced -> Automate with x-callback-url 中生成它，并且应该妥善保管。

用法

该库有两种使用方式：

• 从子路径 On-Demand 导入可以启用 tree-shaking，让 bundle 更小。
• 从根包 Full Import 导入更方便，但会包含所有 app 模块。

生产构建建议使用 On-Demand；快速脚本或演示可以使用 Full Import。

选择安装方式

按需加载

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

全量导入

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

Goto

根据复制出来的 Nozbe path 打开某个 Nozbe 视图。这里的 path 指 https://nozbe.app/ 之后的部分。

On-Demand

import { goto } from 'protocol-launcher/nozbe'

const url = goto({
  path: 'teams/zR17yVDEDrpBbi8x/single_tasks',
})

打开 Nozbe Path

Team Views

打开 Nozbe 官方文档中的 Priority、Single Tasks、Quick Add 和 Jump To 视图。

On-Demand

import {
  gotoPriority, gotoSingleTasks, gotoQuickAdd, gotoJumpTo
} from 'protocol-launcher/nozbe'

const priorityUrl = gotoPriority({
  teamId: 'TeamID',
})

const singleTasksUrl = gotoSingleTasks({
  teamId: 'zR17yVDEDrpBbi8x',
})

const quickAddUrl = gotoQuickAdd({
  teamId: 'zR17yVDEDrpBbi8x',
})

const jumpToUrl = gotoJumpTo({
  teamId: 'zR17yVDEDrpBbi8x',
})

打开 Priority 打开 Single Tasks 打开 Quick Add 打开 Jump To

Tag And Project

打开 Nozbe 空间中的指定 tag 或 project。

On-Demand

import { gotoTag, gotoProject } from 'protocol-launcher/nozbe'

const tagUrl = gotoTag({
  teamId: 'zR17yVDEDrpBbi8x',
  tagId: '6fxaXuTFwaqd13QV',
})

const projectUrl = gotoProject({
  teamId: 'zR17yVDEDrpBbi8x',
  projectId: 'mfdcza541h8g20hz',
})

打开 Nozbe Tag 打开 Nozbe Project

Add Task

向项目中添加任务。Nozbe 会在成功时返回 task_id。

On-Demand

import { addTask } from 'protocol-launcher/nozbe'

const url = addTask({
  projectId: 'u79rr9gfqszxtn45',
  name: 'Added with url',
  secret: 'REPLACE_WITH_YOUR_SECRET',
})

const taskWithOptionsUrl = addTask({
  projectId: 'u79rr9gfqszxtn45',
  name: 'Plan launch',
  isPriority: true,
  responsibleId: '',
  dueAt: 1717200000000,
  isAllDay: true,
  comment: 'Kickoff notes',
  secret: 'REPLACE_WITH_YOUR_SECRET',
  xSuccess: 'sourceapp://done',
  xError: 'sourceapp://error',
})

Update Task

更新任务的 priority 或完成状态。

On-Demand

import { updateTask } from 'protocol-launcher/nozbe'

const url = updateTask({
  taskId: 'abcd1efgh2dcba3j',
  isCompleted: true,
  secret: 'REPLACE_WITH_YOUR_SECRET',
})

Add Project

在 Nozbe workspace 中添加项目。Nozbe 会在成功时返回 project_id。

On-Demand

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

const url = addProject({
  teamId: 'u79rr9gfqszxtn45',
  name: 'Project added with url',
  secret: 'REPLACE_WITH_YOUR_SECRET',
})

const projectWithOptionsUrl = addProject({
  teamId: 'u79rr9gfqszxtn45',
  name: 'Private Project',
  description: '',
  isOpen: false,
  color: 'ultramarine',
  secret: 'REPLACE_WITH_YOUR_SECRET',
})

官方文档

• Nozbe X-Callback-Url schemes