Ulysses

Ulysses 是一款适用于 Mac、iPad 和 iPhone 的强大写作应用。Protocol Launcher 允许您生成深度链接以在 Ulysses 中创建和管理文稿、群组及笔记。

使用方式

有两种使用此库的方式：

• 按需导入（On-Demand）：从子路径导入支持 tree-shaking，保持较小的打包体积。
• 完整导入（Full Import）：从根包导入更方便，但会包含所有应用模块。

生产构建建议选择按需导入；快速脚本或演示可以使用完整导入。

选择安装方式

按需加载

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

全量导入

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

打开应用

On-Demand

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

const url = open()

打开 Ulysses

打开项目

通过标识符、名称或路径打开文稿或群组。

On-Demand

import { openItem } from 'protocol-launcher/ulysses'

const url = openItem({
  id: 'DCj45UWKr_g15y2vBPwJdQ',
})

在 Ulysses 中打开项目

新建文稿

创建新文稿，可选择内容、群组、格式和位置。

On-Demand

import { newSheet } from 'protocol-launcher/ulysses'

const url = newSheet({
  text: 'My new sheet content',
  group: '/Books',
  format: 'markdown',
  index: 0,
})

创建新文稿

插入文本

向现有文稿插入或追加文本。

On-Demand

import { insert } from 'protocol-launcher/ulysses'

const url = insert({
  id: 'H8zLAmc1I0njH-0Ql-3YGQ',
  text: 'Inserted text',
  format: 'markdown',
  position: 'end',
  newline: 'prepend',
})

在 Ulysses 中插入文本

附加笔记

将笔记附加到文稿。

On-Demand

import { attachNote } from 'protocol-launcher/ulysses'

const url = attachNote({
  id: 'H8zLAmc1I0njH-0Ql-3YGQ',
  text: 'My new note',
  format: 'markdown',
})

在 Ulysses 中附加笔记

附加关键词

向文稿添加关键词。

On-Demand

import { attachKeywords } from 'protocol-launcher/ulysses'

const url = attachKeywords({
  id: 'H8zLAmc1I0njH-0Ql-3YGQ',
  keywords: 'Draft,Important',
})

在 Ulysses 中附加关键词

新建群组

创建新群组以组织文稿。

On-Demand

import { newGroup } from 'protocol-launcher/ulysses'

const url = newGroup({
  name: 'My Group',
  parent: '/Books',
  index: 0,
})

创建新群组

复制项目

将文稿或群组复制到目标位置。

On-Demand

import { copy } from 'protocol-launcher/ulysses'

const url = copy({
  id: 'hZ7IX2jqKbVmPGlYUXkZjQ',
  targetGroup: 'H8zLAmc1I0njH-0Ql-3YGQ',
  index: 4,
})

在 Ulysses 中复制项目

打开全部

打开显示所有文稿的"全部"特殊群组。

On-Demand

import { openAll } from 'protocol-launcher/ulysses'

const url = openAll()

在 Ulysses 中打开全部

打开收藏

打开"收藏"特殊群组。

On-Demand

import { openFavorites } from 'protocol-launcher/ulysses'

const url = openFavorites()

在 Ulysses 中打开收藏

打开最近

打开"最近 7 天"（最近）特殊群组。

On-Demand

import { openRecent } from 'protocol-launcher/ulysses'

const url = openRecent()

在 Ulysses 中打开最近