Tembo

Tembo 是一款 macOS 文件搜索应用。Protocol Launcher 允许您生成 Tembo URL scheme 链接。

使用方式

有两种使用此库的方式：

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

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

选择安装方式

按需加载

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

全量导入

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

说明

Houdah 的 Tembo 官方文章记录的 URL 格式是 tembo2://search?query=[QUERY]&location=[LOCATION]&group=[GROUP]。location 和 group 是附加到搜索查询上的可选参数，location 参数可以重复，用于在 Tembo 的位置菜单中显示多个路径。

group 只能使用 Tembo 官方值：APPLICATIONS、BOOKMARKS、CONTACTS、DIRECTORIES、CALENDAR、EVERNOTE、FONTS、IMAGES、MESSAGES、MOVIES、MUSIC、PDF、SOURCE、SYSTEM_PREFS 和 XML。

同一篇官方文章也把 Alfred 自定义搜索 URL 写为 tembo2://search?q={query}。只有在需要这个文档中的短参数时，才传入 q 而不是 query。

搜索

使用查询文本启动 Tembo 搜索。

On-Demand

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

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

搜索

在指定位置搜索

使用指定位置启动 Tembo 搜索。

On-Demand

import { searchInLocation } from 'protocol-launcher/tembo'

const url = searchInLocation({
  query: 'Houdah Software',
  location: '~/Documents',
})

在指定位置搜索

在多个位置搜索

传入数组即可重复 Tembo 文档中的 location 参数。

On-Demand

import { searchInLocation } from 'protocol-launcher/tembo'

const url = searchInLocation({
  query: 'Houdah Software',
  location: ['~/Documents', '~/Desktop'],
  group: 'PDF',
})

在多个位置搜索

按分组搜索

在官方分组中启动 Tembo 搜索。

On-Demand

import { searchGroup } from 'protocol-launcher/tembo'

const url = searchGroup({
  query: 'Houdah Software',
  group: 'PDF',
})

按分组搜索

Alfred 短查询参数

生成官方 Alfred 自定义搜索形式中的 q 参数。

On-Demand

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

const url = search({
  q: 'Houdah Software',
})

Alfred 搜索

生成的 URL

search({ query: 'Houdah Software' })
// => 'tembo2://search?query=Houdah%20Software'

search({
  query: 'Houdah Software',
  location: '~/Documents',
  group: 'PDF',
})
// => 'tembo2://search?query=Houdah%20Software&location=~/Documents&group=PDF'

searchInLocation({
  query: 'Houdah Software',
  location: '~/Documents',
})
// => 'tembo2://search?query=Houdah%20Software&location=~/Documents'

searchInLocation({
  query: 'Houdah Software',
  location: ['~/Documents', '~/Desktop'],
  group: 'PDF',
})
// => 'tembo2://search?query=Houdah%20Software&location=~/Documents&location=~/Desktop&group=PDF'

searchGroup({
  query: 'Houdah Software',
  group: 'PDF',
})
// => 'tembo2://search?query=Houdah%20Software&group=PDF'

search({ q: 'Houdah Software' })
// => 'tembo2://search?q=Houdah%20Software'

官方文档

• Start a Tembo File Search from Alfred, Butler or LaunchBar