🚀 Alfred 5 Awesome Workflow

精选的 Alfred 5 Workflow 集合，提升你的 macOS 工作效率

---

📑 目录

• ✨ 特性
• 📦 包含的 Workflow
• 🚀 快速开始
• 📋 系统要求
• 🔧 开发指南
• 🤝 贡献
• 📄 许可证

---

✨ 特性

• 🎯 即插即用 - 一键打包，快速安装
• 🔄 自动化工具 - 智能生成配置文件，无需手动编写
• 🧩 模块化设计 - 每个 workflow 独立管理，互不干扰
• 📝 文档完善 - 每个 workflow 都有详细的使用说明
• 🎨 图标支持 - 自动检测和配置图标资源
• 🔌 支持多种类型 - Python 脚本、AppleScript 原生等
• 🛠️ 易于扩展 - 标准化的开发框架，快速创建新 workflow

---

📦 包含的 Workflow

Workflow	关键字	功能描述
🔍 GitHub Search	ghs	快速搜索 GitHub 仓库并打开 • 支持 GitHub Token 配置 • 可访问私有仓库
🦊 GitLab Search	gls	快速搜索 GitLab 项目并打开 • 支持 GitLab Token 配置 • 支持自建 GitLab 实例
🌐 Google Translate	gt	Google 翻译工具 • 多语言翻译支持 • 快速翻译剪贴板内容
📚 Youdao Translate	yd	有道翻译工具 • 支持中英互译 • 提供详细释义
🔐 Hash Tools	hash	各种哈希算法工具 • 支持 MD5、SHA1、SHA256 等 • 适用于密码学、数据校验
🌍 IP Address Info	ipinfo	IP 地址查询工具 • 查询 IP 地理位置 • 网络调试与安全分析
📜 Browser History	bh	浏览器历史记录搜索 • 快速查找访问过的网页 • 支持多浏览器
💻 Terminal Finder	ft tf fi if	终端与访达快速切换 • Terminal/iTerm ↔ Finder/Path Finder • 支持当前目录同步
✍️ Sublime Text	subl	快速打开 Sublime Text 项目 • 在 Sublime 中打开文件和项目 • 提升编辑器使用效率

---

🚀 快速开始

步骤 1️⃣: 打包所有 Workflow

使用 install.py 脚本自动生成配置文件并打包所有 workflow：

python3 install.py

该脚本会自动完成：

• ✅ 扫描所有包含 workflow 子目录的目录
• ✅ 为 Python 脚本型 workflow 生成标准的 info.plist 和 README.md
• ✅ 对 AppleScript 原生型 workflow 直接打包现有文件
• ✅ 自动检测并配置图标
• ✅ 将所有文件打包为 .alfredworkflow 文件
• ✅ 输出到 .workflows 目录

步骤 2️⃣: 验证打包结果（可选）

python3 test_workflows.py

检查所有打包文件的完整性和正确性。

步骤 3️⃣: 安装 Workflow

🎯 方法 1：快速安装脚本（推荐）

chmod +x quick_install.sh
./quick_install.sh

提供交互式菜单：

• 一键安装所有 workflow
• 选择性安装特定 workflow
• 直接打开 .workflows 目录

🎯 方法 2：命令行安装

# 安装所有 workflow
open .workflows/*.alfredworkflow

# 或安装单个 workflow
open .workflows/github-search.alfredworkflow

🎯 方法 3：手动安装

双击 .workflows/ 目录中的 .alfredworkflow 文件，或直接拖入 Alfred Preferences。

---

📋 系统要求

组件	版本要求
🖥️ macOS	10.15+ (Catalina 或更高)
🎩 Alfred	5.0+ (需要 Powerpack)
🐍 Python	3.7+ (用于 Python 脚本型 workflow)

---

🔧 开发指南

项目结构说明

每个 workflow 都组织在独立的目录中，遵循标准结构：

workflow-name/
├── workflow/              # workflow 主目录
│   ├── info.plist        # Alfred workflow 配置文件
│   ├── README.md         # 使用说明文档
│   ├── icon.png          # workflow 图标（可选）
│   └── scripts/          # 脚本文件目录
│       ├── info_meta.py  # workflow 元数据配置
│       └── main_script.py # 主脚本文件

创建新的 Workflow

步骤 1：创建目录结构

mkdir -p my-workflow/workflow/scripts
cd my-workflow/workflow

步骤 2：添加脚本和资源

# 创建主脚本
touch scripts/my_script.py

# 添加图标（可选）
cp /path/to/icon.png icon.png

# 创建元数据配置
touch scripts/info_meta.py

步骤 3：配置元数据

编辑 scripts/info_meta.py：

info_metadata = {
    'name': 'My Workflow',
    'description': 'My awesome workflow description',
    'version': '1.0.0',
    'bundleid': 'com.alfred.my-workflow',
    'category': 'Tools',
    'keyword': 'mykey',
    # 更多配置...
}

步骤 4：自动打包

# 返回项目根目录
cd ../..
# 运行打包脚本
python3 install.py

打包后的文件将输出到 .workflows/my-workflow.alfredworkflow

目录结构示例

开发时：

my-workflow/
└── workflow/
    ├── icon.png
    └── scripts/
        ├── info_meta.py
        └── my_script.py

打包后：

my-workflow/
└── workflow/
    ├── info.plist       # ✨ 自动生成
    ├── README.md        # ✨ 自动生成
    ├── icon.png
    └── scripts/
        ├── info_meta.py
        └── my_script.py

.workflows/
└── my-workflow.alfredworkflow  # ✨ 自动打包

高级配置

详细的开发指南和高级配置选项，请参阅项目中的其他文档：

• 📖 USAGE.md - 详细使用说明
• 📖 各个 workflow 目录下的 README.md - 具体 workflow 的使用方法

---

🤝 贡献

欢迎贡献新的 workflow 或改进现有功能！

贡献方式

1. Fork 本仓库
2. 创建你的 Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit 你的改动 (git commit -m 'Add some AmazingFeature')
4. Push 到分支 (git push origin feature/AmazingFeature)
5. 提交 Pull Request

贡献指南

• 📝 确保代码符合项目的结构规范
• 🧪 测试你的 workflow 在不同场景下的表现
• 📄 为新的 workflow 编写清晰的文档
• 💬 在 Pull Request 中详细描述你的改动

---

📄 许可证

本项目采用 MIT License 开源协议。

---

如果这个项目对你有帮助，请给个 ⭐️ Star 吧！

Made with ❤️ for Alfred users