Calendar 366

Calendar 366 是一款适用于 iPhone、iPad、Apple Watch 和 Mac 的日历与任务应用。Protocol Launcher 允许你生成 Calendar 366 URL scheme 链接，用于添加事件和任务、打开项目、显示视图、生成摘要和导入日历。

使用

这个库有两种使用方式：

• 从子路径按需导入，支持 Tree Shaking 并保持较小的包体积。
• 从根包完整导入更适合快速脚本或演示，但会包含所有应用模块。

生产构建建议选择按需导入；完整导入适合快速脚本或演示。

选择安装方式

按需加载

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

全量导入

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

添加事件或任务

Calendar 366 官方文档列出了 cal366://add，其中 type 为 event 或 task，query 是可选的自然语言输入。addEvent() 和 addTask() 只是围绕同一个官方命令的轻量 helper。

On-Demand

import { add, addEvent, addTask } from 'protocol-launcher/calendar-366'

const eventUrl = add({
  type: 'event',
  query: 'Meeting tomorrow 10am',
})

const eventShortcutUrl = addEvent({
  query: 'Meeting tomorrow 10am',
})

const taskUrl = addTask({
  query: 'Call dentist',
})

添加事件添加任务

打开项目

通过 calendarItemExternalIdentifier 或 identifier 打开事件或任务。Calendar 366 官方文档说明 date 是任务的可选参数。

On-Demand

import { openItem } from 'protocol-launcher/calendar-366'

const eventUrl = openItem({
  type: 'event',
  id: 'ABC123',
})

const taskUrl = openItem({
  type: 'task',
  id: 'TASK123',
  date: 1717200000,
})

显示视图、任务或日期

view 使用 Calendar 366 官方列出的视图名称，tasks 使用官方任务列表编号，date 使用 timeIntervalSince1970。

On-Demand

import { show } from 'protocol-launcher/calendar-366'

const monthUrl = show({
  view: 'month',
})

const overdueTasksUrl = show({
  tasks: 1,
})

const dayUrl = show({
  view: 'day',
  date: 1717200000,
})

显示月视图显示逾期任务显示日视图

摘要

On-Demand

import { summarize } from 'protocol-launcher/calendar-366'

const url = summarize()

生成摘要

导入日历

Calendar 366 官方文档列出的日历文件 URL 类型是 file:// 和 https://。

On-Demand

import { importCalendar } from 'protocol-launcher/calendar-366'

const url = importCalendar({
  url: 'https://example.com/calendar.ics',
})

生成的 URL

add({ type: 'event', query: 'Meeting tomorrow 10am' })
// => 'cal366://add?type=event&query=Meeting%20tomorrow%2010am'

addEvent({ query: 'Meeting tomorrow 10am' })
// => 'cal366://add?type=event&query=Meeting%20tomorrow%2010am'

addTask({ query: 'Call dentist' })
// => 'cal366://add?type=task&query=Call%20dentist'

openItem({ type: 'event', id: 'ABC123' })
// => 'cal366://open?type=event&id=ABC123'

openItem({ type: 'task', id: 'TASK123', date: 1717200000 })
// => 'cal366://open?type=task&id=TASK123&date=1717200000'

show({ view: 'month' })
// => 'cal366://show?view=month'

show({ tasks: 1 })
// => 'cal366://show?tasks=1'

show({ view: 'day', date: 1717200000 })
// => 'cal366://show?view=day&date=1717200000'

summarize()
// => 'cal366://summarize'

importCalendar({ url: 'https://example.com/calendar.ics' })
// => 'cal366://import?url=https%3A%2F%2Fexample.com%2Fcalendar.ics'