# iTermFinderPluginforAlfred

**Repository Path**: XLVIP/iterm-finder-plugin-for-alfred

## Basic Information

- **Project Name**: iTermFinderPluginforAlfred
- **Description**: 这是一个 Alfred 工作流插件，实现了 iTerm 和 Finder 之间的双向跳转功能。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-09
- **Last Updated**: 2025-08-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# iTerm Finder Plugin for Alfred

这是一个 Alfred 工作流插件，实现了 iTerm 和 Finder 之间的双向跳转功能。

## 功能特点

- **if**: 在 Finder 中打开当前 iTerm 的工作目录
- **fi**: 在 iTerm 中进入当前 Finder 的路径

## 安装方法

### 方法一：使用构建脚本（推荐）
1. 运行构建脚本：
   ```bash
   ./build_workflow.sh
   ```
2. 双击生成的 `iTerm-Finder-Plugin.alfredworkflow` 文件
3. Alfred 会自动导入工作流
4. 开始使用 `if` 和 `fi` 命令

### 方法二：手动打包
1. 将项目文件夹压缩为 `.alfredworkflow` 文件
2. 双击该文件，Alfred 会自动导入工作流
3. 开始使用 `if` 和 `fi` 命令

### 方法二：手动创建工作流
1. 打开 Alfred Preferences
2. 选择 Workflows 标签
3. 点击左下角的 "+" 按钮，选择 "Import Workflow"
4. 选择 `info.plist` 文件导入

## 使用方法

### iTerm → Finder (if)
1. 在 Alfred 中输入 `if`
2. 按回车键
3. Finder 会打开当前 iTerm 会话的工作目录

### Finder → iTerm (fi)
1. 在 Alfred 中输入 `fi`
2. 按回车键
3. iTerm 会切换到当前 Finder 窗口的路径

## 技术实现

### 核心功能
- 使用 AppleScript 获取应用程序的当前路径
- 通过 shell 脚本处理路径转换和错误处理
- Alfred 工作流框架整合两个功能

### 路径获取机制
- **iTerm 路径获取**: 通过 AppleScript 执行 `pwd` 命令获取当前会话路径
- **Finder 路径获取**: 通过 AppleScript 获取前台窗口的目标文件夹路径
- **错误处理**: 当无法获取路径时，自动回退到用户主目录

## 文件结构

```
iterm-finder-plugin/
├── info.plist              # Alfred 工作流配置文件
├── iterm_to_finder.sh      # iTerm → Finder 脚本
├── finder_to_iterm.sh      # Finder → iTerm 脚本
├── build_workflow.sh       # 自动构建脚本
├── .gitignore              # Git 忽略文件
├── LICENSE                 # MIT 许可证
└── README.md               # 说明文档
```

## 兼容性

- **系统要求**: macOS 10.10 或更高版本
- **应用要求**: 
  - Alfred 4.0 或更高版本（需要 Powerpack）
  - iTerm2
  - macOS Finder

## 故障排除

### 常见问题

1. **权限问题**: 确保 Alfred 有访问系统事件的权限
   - 系统偏好设置 → 安全性与隐私 → 隐私 → 辅助功能
   - 添加 Alfred 到允许列表

2. **iTerm 路径获取失败**: 
   - 确保 iTerm 窗口处于活动状态
   - 检查 iTerm 是否正在运行

3. **Finder 路径获取失败**:
   - 确保 Finder 有打开的窗口
   - 检查当前选中的是文件夹而不是文件

### 调试方法

可以直接运行脚本文件来测试功能：

```bash
# 测试 iTerm → Finder
./iterm_to_finder.sh

# 测试 Finder → iTerm  
./finder_to_iterm.sh
```

## 自定义配置

### 修改快捷键
在 `info.plist` 文件中找到 `keyword` 字段，可以修改触发关键词：
- 将 `if` 改为其他关键词
- 将 `fi` 改为其他关键词

### 修改默认路径
在脚本文件中修改 `$HOME` 为其他默认路径。

## 许可证

MIT License

## 贡献

欢迎提交 Issue 和 Pull Request 来改进这个插件。