# switcher-ahk

**Repository Path**: ssuiwp/switcher-ahk

## Basic Information

- **Project Name**: switcher-ahk
- **Description**: switcher windows ahk脚本版本
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-03
- **Last Updated**: 2026-09-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# switcher-ahk

Windows 窗口切换器，基于 AutoHotkey v2，无需安装。

## 功能

- 浮动按钮始终显示在屏幕右侧，hover 弹出窗口列表
- 鼠标悬停自动选中窗口，单击即可切换
- 实时过滤：输入关键词按窗口名称或程序名筛选
- 自动读取 Windows 主题色作为背景
- 显示应用图标
- 无边框窗口可拖动
- 托盘菜单可打开设置界面修改配置

## 使用方式

### 方式一：直接运行（需要已安装 AHK v2）

双击 `switcher-ahk.ahk`

### 方式二：编译为单个 .exe（无依赖，推荐分发）

使用 AutoHotkey 官方编译器 **Ahk2Exe** 把脚本打包成单个可执行文件，目标机器无需安装 AHK 即可运行。

#### 安装 Ahk2Exe

v2 安装包自带安装脚本，双击运行即可：

```
C:\Program Files\AutoHotkey\UX\install-ahk2exe.ahk
```

运行后选择安装 Ahk2Exe（默认路径为 `C:\Program Files\AutoHotkey\v2\Ahk2Exe`），它会同时安装编译工具、`.ico` 图标资源目录和命令行 `Ahk2Exe.exe`。

#### 命令行编译

```bat
"C:\Program Files\AutoHotkey\v2\Ahk2Exe\Ahk2Exe.exe" /in "switcher-ahk.ahk" /out "switcher-ahk.exe"
```

常用参数：

| 参数 | 说明 |
|------|------|
| `/in` | 输入脚本路径 |
| `/out` | 输出 exe 路径（默认与脚本同名） |
| `/icon` | 指定图标文件 `.ico`（不指定则用默认图标） |
| `/base` | 指定编译器基础模板（默认已配置） |
| `/x64` | 编译为 64 位（默认） |
| `/compress 1` | 启用 MPRESS 压缩减小体积（需已安装） |

例如带图标的编译命令：

```bat
"C:\Program Files\AutoHotkey\v2\Ahk2Exe\Ahk2Exe.exe" /in "switcher-ahk.ahk" /out "switcher-ahk.exe" /icon "switcher-ahk.ico"
```

> 提示：编译出的 exe 与脚本一样会自动读取脚本目录下的 `switcher-ahk.ini` 配置。

## 配置

首次运行自动生成 `switcher-ahk.ini`，也可通过托盘菜单 → "设置" 打开 GUI 修改。

| 配置项 | 默认值 | 说明 |
|--------|--------|------|
| HotkeyStr | `#y` | 触发热键（Win+Y） |
| ShowBtn | 1 | 是否显示浮动按钮 |
| HoverShow | 1 | hover 按钮时弹出窗口列表 |
| MaxRows | 50 | 列表最多显示窗口数 |
| ShowIcons | 1 | 是否显示程序图标 |
| ListWidth | 560 | 列表宽度 |
| RowHeight | 30 | 每行高度 |
| BtnSize | 48 | 浮动按钮边长 |
| BtnMargin | 12 | 按钮距屏幕边缘距离 |

修改后需重新加载脚本生效（设置界面会自动重载）。

## 快捷键

| 按键 | 功能 |
|------|------|
| `Win+Y` | 唤出/隐藏切换窗口 |
| `↑↓` / `Tab` | 选择窗口 |
| `Enter` | 切换到选中窗口 |
| `Esc` | 关闭切换窗口 |
| 鼠标悬停 | 自动选中 |
| 鼠标单击 | 切换到选中窗口 |

## 环境要求

- Windows 10/11
- AutoHotkey v2.0+（源码运行方式需要，编译为 exe 后无需安装）