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 的场景。
ts
import { openCallbackUrl } from 'protocol-launcher/alter'
const url = openCallbackUrl({
url: 'alter://action/business-strategist-gpt',
})运行已生成的 Action
返回 Alter 生成的 action callback URL,并可选择添加官方记录的 input query 参数。
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'