Buchen

Buchen 是一款书签管理工具。Protocol Launcher 允许您生成 Buchen URL scheme 链接。

使用方式

有两种使用此库的方式：

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

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

选择安装方式

按需加载

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

全量导入

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

注意事项

Buchen 官方支持页面只记录了以下 URL scheme 形式：

• buchen://add-tag?name=<tag name>
• buchen://add?name=<bookmark name>&url=<url>&browser=<browser ?>
• buchen://go-bookmarks
• buchen://go-tags
• buchen://go-folders

官方页面说明，任何包含 ? 的参数块都是可选的，任何作为值传入的 URL 都必须进行 URL 编码。addBookmark() 会按查询参数值对书签 URL 进行百分号编码。可选的 browser 值限定为官方名称：safari、edge、icab mobile、opera、brave、chrome、firefox、firefox focus、duckduckgo、quiche 和 jayson。

Buchen 官方文档说明 safari 是默认浏览器的另一个名称，并说明浏览器在所有地方都使用这些名称，包括 Buchen JSON 导出文件。

添加标签

On-Demand

import { addTag } from 'protocol-launcher/buchen'

const url = addTag({
  name: 'reading list',
})

在 Buchen 中添加标签

添加书签

On-Demand

import { addBookmark } from 'protocol-launcher/buchen'

const url = addBookmark({
  name: 'Protocol Launcher',
  url: 'https://www.example.com/',
})

在 Buchen 中添加书签

添加带浏览器的书签

On-Demand

import { addBookmark } from 'protocol-launcher/buchen'

const url = addBookmark({
  name: 'Protocol Launcher',
  url: 'https://www.example.com/search?q=url scheme',
  browser: 'firefox focus',
})

在 Buchen 中添加带浏览器的书签

前往书签

On-Demand

import { goBookmarks } from 'protocol-launcher/buchen'

const url = goBookmarks()

前往 Buchen 书签

前往标签

On-Demand

import { goTags } from 'protocol-launcher/buchen'

const url = goTags()

前往 Buchen 标签

前往文件夹

On-Demand

import { goFolders } from 'protocol-launcher/buchen'

const url = goFolders()

前往 Buchen 文件夹

生成的 URL

addTag({
  name: 'reading list',
})
// => 'buchen://add-tag?name=reading%20list'

addBookmark({
  name: 'Protocol Launcher',
  url: 'https://www.example.com/',
})
// => 'buchen://add?name=Protocol%20Launcher&url=https%3A%2F%2Fwww.example.com%2F'

addBookmark({
  name: 'Protocol Launcher',
  url: 'https://www.example.com/search?q=url scheme',
  browser: 'firefox focus',
})
// => 'buchen://add?name=Protocol%20Launcher&url=https%3A%2F%2Fwww.example.com%2Fsearch%3Fq%3Durl%20scheme&browser=firefox%20focus'

goBookmarks()
// => 'buchen://go-bookmarks'

goTags()
// => 'buchen://go-tags'

goFolders()
// => 'buchen://go-folders'

官方文档

• Buchen Supported URL Schemes