Bunch

Bunch 是一款 macOS 工作区自动化应用。Protocol Launcher 可以为 Bunch 生成深度链接。

使用方式

提供两种使用方式：

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

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

选择安装方式

按需加载

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

全量导入

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

URL 方法

以下 helper 在适用时都支持 Bunch 文档中的 x-callback-url 路径格式，以及官方的 x-source、x-success、x-delay 和 x-bunch-beta URL 值。

打开 Bunch

On-Demand

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

const url = open({
  bunch: 'Comms',
})

const shortcutUrl = open({
  bunch: 'Comms',
  syntax: 'shortcut',
})

const pathUrl = open({
  bunch: 'WorkBunch',
  syntax: 'path',
})

使用完整 URL 打开 Bunch 使用 Shortcut URL 打开 Bunch 使用 Path URL 打开 Bunch

使用 Bunch Beta 打开

On-Demand

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

const url = open({
  bunch: 'Comms',
  scheme: 'x-bunch-beta',
})

在 Bunch Beta 中打开

带 Frontmatter 值打开

On-Demand

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

const url = open({
  bunch: 'Default',
  variables: {
    launch: 'TextEdit',
  },
})

带变量打开

带 Callback 参数打开

On-Demand

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

const callbackUrl = open({
  bunch: 'Comms',
  xCallback: true,
  'x-source': 'com.googlecode.iterm2',
})

const successUrl = open({
  bunch: 'Comms',
  'x-success': 'com.brettterpstra.marked2',
  'x-delay': 15,
})

使用 x-callback-url 打开 打开后启动 Marked 2

关闭 Bunch

On-Demand

import { close } from 'protocol-launcher/bunch'

const url = close({
  bunch: 'Comms',
})

const pathUrl = close({
  bunch: 'Comms',
  syntax: 'path',
})

使用完整 URL 关闭 Bunch 使用 Path URL 关闭 Bunch

切换 Bunch

On-Demand

import { toggle } from 'protocol-launcher/bunch'

const url = toggle({
  bunch: 'Comms',
})

const pathUrl = toggle({
  bunch: 'Comms',
  syntax: 'path',
})

使用完整 URL 切换 Bunch 使用 Path URL 切换 Bunch

切换带标签的 Bunch

On-Demand

import { toggle } from 'protocol-launcher/bunch'

const url = toggle({
  tag: 'Tag1+Tag2',
})

切换带标签的 Bunch

编辑 Bunch

On-Demand

import { edit } from 'protocol-launcher/bunch'

const url = edit({
  bunch: 'Example',
})

const pathUrl = edit({
  bunch: 'Example',
  syntax: 'path',
})

使用完整 URL 编辑 Bunch 使用 Path URL 编辑 Bunch

运行原始 Bunch 文本或文件

On-Demand

import { raw } from 'protocol-launcher/bunch'

const fileUrl = raw({
  file: '~/MiscBunch.bunch',
})

const textUrl = raw({
  txt: '(dnd on)',
})

运行原始文件 运行原始文本

刷新 Bunch 文件

On-Demand

import { refresh } from 'protocol-launcher/bunch'

const url = refresh()

刷新 Bunch 文件

在 Finder 中显示 Bunch 文件夹

On-Demand

import { reveal } from 'protocol-launcher/bunch'

const url = reveal()

显示 Bunch 文件夹

设置偏好

On-Demand

import { setPref } from 'protocol-launcher/bunch'

const toggleUrl = setPref({
  toggleBunches: 1,
})

const folderUrl = setPref({
  configDir: '~/Dropbox/Sync/Bunches',
})

启用 Toggle Bunches 设置 Bunch 文件夹

运行 Snippet

On-Demand

import { snippet } from 'protocol-launcher/bunch'

const url = snippet({
  file: 'useful.snippets',
  fragment: 'Music',
  variables: {
    playlist: 'spotify:playlist:3cSpIL4Q0H3uqdBMbT6c9x',
  },
})

const pathUrl = snippet({
  file: 'useful.snippets',
  fragment: 'Speak',
  syntax: 'path',
  variables: {
    var1: 'foo',
    var2: 'bar baz',
  },
})

使用完整 URL 运行 Snippet 使用 Path URL 运行 Snippet

打开偏好设置

On-Demand

import { prefs } from 'protocol-launcher/bunch'

const url = prefs()

打开 Bunch 偏好设置

官方文档

• The Bunch URL Handler