Skip to content

Alter

Alter 是一款 macOS AI 自动化应用。Protocol Launcher 允许你生成用于从其他应用触发 Alter actions 的 URL。

使用

有两种方式可以使用此库:

  • 按需从子路径导入,支持 Tree Shaking 并保持包体积较小。
  • 从根包完整导入更适合快速脚本或示例,但会包含全部应用模块。

生产构建建议使用按需导入;快速演示可以使用完整导入。

选择安装方式

按需加载
推荐使用。生产环境优化。
全量导入
使用便捷。适合快速脚本。

URL 方法

Alter 官方 URL Callbacks 文档说明,可以从 Action Editor 的 URL Callback 区域复制 alter://... URL。文档还展示了 alter://action/... action callback 示例,以及可选的 input query 数据。此模块只保持这个边界:使用 Alter 生成的 URL,并且只在需要时添加官方文档中的 input 参数。

打开 Callback URL

原样返回从 Alter 复制的 callback URL。适用于 Alter 已经为 action 生成完整 URL 的场景。

On-Demand
ts
import { openCallbackUrl } from 'protocol-launcher/alter'

const url = openCallbackUrl({
  url: 'alter://action/business-strategist-gpt',
})

运行已生成的 Action

返回 Alter 生成的 action callback URL,并可选择添加官方记录的 input query 参数。

On-Demand
ts
import { runGeneratedAction } from 'protocol-launcher/alter'

const url = runGeneratedAction({
  url: 'alter://action/ask-web',
  input: 'What is Alter MacOS',
})

const urlWithoutInput = runGeneratedAction({
  url: 'alter://action/business-strategist-gpt',
})

const businessStrategistUrl = runGeneratedAction({
  url: 'alter://action/business-strategist-gpt',
  input: 'Explain Red Ocean Strategy',
})

生成的 URL

ts
openCallbackUrl({ url: 'alter://action/business-strategist-gpt' })
// => 'alter://action/business-strategist-gpt'

runGeneratedAction({ url: 'alter://action/ask-web', input: 'What is Alter MacOS' })
// => 'alter://action/ask-web?input=What+is+Alter+MacOS'

runGeneratedAction({ url: 'alter://action/business-strategist-gpt' })
// => 'alter://action/business-strategist-gpt'

runGeneratedAction({
  url: 'alter://action/business-strategist-gpt',
  input: 'Explain Red Ocean Strategy',
})
// => 'alter://action/business-strategist-gpt?input=Explain+Red+Ocean+Strategy'

官方文档