Pincase

Pincase 是一款 iOS Pinboard.in 客户端。Protocol Launcher 允许您生成 Pincase x-callback-url 链接。

使用方式

有两种使用此库的方式：

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

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

选择安装方式

按需加载

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

全量导入

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

注意事项

Pincase 官方 API 页面只记录了以下 URL scheme action：

• pincaseapp://x-callback-url/add
• pincaseapp://x-callback-url/open

对于 add，官方参数表列出了 url、title、private、toread、noui、x-success、x-error 和 x-cancel。同一个官方页面的添加书签示例使用了 later=yes；addBookmark() 只会序列化您传入的 toread 或 later key，不会在二者之间推断或转换。

对于 open，Pincase 记录了 mode、tag 和 username。官方也说明 x-source、x-success、x-error、x-cancel 对此 action 不生效，因此 open 相关 helper 不接受 callback 选项。官方 mode 值为 menu、personal_unread、personal_recent、personal_tag、public_popular、public_recent、public_japanese、public_wikipedia、public_fandom、public_favorite_stream、public_tag 和 public_username。官方参数行说明 tag 与 mode=personal_tag 或 mode=public_tag 一起使用；openTag() 也只限定为这两个值。

添加书签

On-Demand

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

const url = addBookmark({
  url: 'http://pincaseapp.com/',
  title: 'Pincase - A simple, elegant and powerful Pinboard.in client for iOS',
  noui: 'yes',
  later: 'yes',
})

在 Pincase 中添加书签

添加带回调的书签

On-Demand

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

const url = addBookmark({
  url: 'https://www.example.com/article?ref=url scheme',
  title: 'Example Article',
  private: 'no',
  toread: 'no',
  noui: 'no',
  xSuccess: 'myapp://success',
  xError: 'myapp://error',
  xCancel: 'myapp://cancel',
})

在 Pincase 中添加带回调的书签

打开公开标签

On-Demand

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

const url = open({
  mode: 'public_tag',
  tag: 'iOS',
})

在 Pincase 中打开公开标签

打开未读

On-Demand

import { openUnread } from 'protocol-launcher/pincase'

const url = openUnread()

在 Pincase 中打开未读

打开最近书签

On-Demand

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

const url = openRecent()

在 Pincase 中打开最近书签

打开标签

On-Demand

import { openTag } from 'protocol-launcher/pincase'

const url = openTag({
  mode: 'personal_tag',
  tag: 'reading list',
})

在 Pincase 中打开标签

生成的 URL

addBookmark({
  url: 'http://pincaseapp.com/',
  title: 'Pincase - A simple, elegant and powerful Pinboard.in client for iOS',
  noui: 'yes',
  later: 'yes',
})
// => 'pincaseapp://x-callback-url/add?url=http%3A%2F%2Fpincaseapp.com%2F&title=Pincase%20-%20A%20simple%2C%20elegant%20and%20powerful%20Pinboard.in%20client%20for%20iOS&noui=yes&later=yes'

addBookmark({
  url: 'https://www.example.com/article?ref=url scheme',
  title: 'Example Article',
  private: 'no',
  toread: 'no',
  noui: 'no',
  xSuccess: 'myapp://success',
  xError: 'myapp://error',
  xCancel: 'myapp://cancel',
})
// => 'pincaseapp://x-callback-url/add?url=https%3A%2F%2Fwww.example.com%2Farticle%3Fref%3Durl%20scheme&title=Example%20Article&private=no&toread=no&noui=no&x-success=myapp%3A%2F%2Fsuccess&x-error=myapp%3A%2F%2Ferror&x-cancel=myapp%3A%2F%2Fcancel'

open({ mode: 'public_tag', tag: 'iOS' })
// => 'pincaseapp://x-callback-url/open?mode=public_tag&tag=iOS'

openUnread()
// => 'pincaseapp://x-callback-url/open?mode=personal_unread'

openRecent()
// => 'pincaseapp://x-callback-url/open?mode=personal_recent'

openTag({ mode: 'personal_tag', tag: 'reading list' })
// => 'pincaseapp://x-callback-url/open?mode=personal_tag&tag=reading%20list'

官方文档

• Pincase URL Schemes