alfy

> 编程语言

开源

轻松创建 Alfred 工作流

2.7K stars0 点赞2 次浏览

访问官网 GitHub

工具介绍

轻松创建 Alfred 工作流

轻松创建 Alfred 工作流

亮点

简单的输入↔输出。
内置配置和缓存处理。
获取远程文件，并支持可选缓存。
将你的工作流发布到 npm。
自动更新通知。
易于测试的工作流。
查找 node 二进制文件。
支持顶层 await。
将未捕获的异常和未处理的 Promise 拒绝呈现给用户。
无需手动 .catch() 顶层 Promise。

先决条件

你需要 Node.js 18+ 和 Alfred 4 或更高版本，并已购买付费的 Powerpack 升级。

安装

bash

npm install alfy

使用方法

重要提示： 你的脚本将以 ESM 方式运行。

创建一个新的空白 Alfred 工作流。
添加一个 Script Filter（右键点击画布 → Inputs → Script Filter），将 Language 设置为 /bin/bash，并添加以下脚本：

./node_modules/.bin/run-node index.js "$1"

我们无法直接调用 node，因为 macOS 上的 GUI 应用不会继承 $PATH。

提示：你可以使用 generator-alfred 来搭建一个基于 alfy 的工作流。如果是这样，你可以跳过其余步骤，直接进入 index.js 并开始编写你的代码。

设置用于调用工作流的 Keyword。
进入你的新工作流目录（右键点击侧边栏中的工作流 → Open in Finder）。
使用 npm init 初始化一个仓库。
在 package.json 中添加 "type": "module"。
使用 npm install alfy 安装 Alfy。
在工作流目录中，创建一个 index.js 文件，导入 alfy，然后做你想做的事。

示例

这里我们从占位 API 获取一些 JSON，并向用户展示匹配项：

javascript

import alfy from 'alfy';

const data = await alfy.fetch('https://jsonplaceholder.typicode.com/posts');

const items = alfy
	.inputMatches(data, 'title')
	.map(element => ({
		title: element.title,
		subtitle: element.body,
		arg: element.id
	}));

alfy.output(items);