让键盘上最没用的键，成为你最强大的工具。
Capslock2 是一个 AutoHotkey v2 脚本，将 CapsLock 变成一个修饰键层——在不离开主键区的情况下完成光标导航、窗口管理、文本翻译、Python 脚本、剪贴板操作。
和其他 AHK 脚本不同，Capslock2 没有硬编码任何一个按键。每个按键都是 Settings.ini 中的一行。想让 Caps+E 打开 Edge 而不是 DOpus？改一行。想让 Caps+A 发送自定义按键而不是启动应用？改一行。不需要翻代码。
- 键位-函数分离 — 所有按键绑定都在 INI 里，增删改不需要碰代码
- 3 个修饰平面 — Caps、Caps+Alt、Caps+Win，一个键三层快捷键
- 应用级键位覆盖 — 不同应用里同一个按键可以做不同的事
- 内置 GUI 编辑器 — 5 个标签页的设置窗口，带窗口选择器（点击目标窗口自动填入
ahk_exe/ahk_class） - 暗色主题 UI — 通知和翻译弹窗风格统一，简洁现代
- 翻译功能 — 选中文本按
Caps+T，弹出可拖动、可复制的翻译结果。使用 MyMemory API，国内可用无需代理 - Python 集成 —
Caps+Alt+S测试，然后把 Python 脚本绑到任意按键 - 智能窗口切换 — 启动/激活/最小化，精确的
ahk_exe/ahk_class匹配
| Capslock2 | capslock+ | CapsLockX | Capslock-Plus-Lite | |
|---|---|---|---|---|
| 按键-函数分离 | ✅ INI 完全分离 | ❌ 硬编码 | ||
| 多修饰平面 | ✅ 3 层（Caps/Alt/Win 组合） | ❌ 1 层 | ❌ 1 层 | |
| 应用级键位覆盖 | ✅ [Keymap_app] |
❌ | ❌ | ❌ |
| GUI 设置编辑器 | ✅ 5 标签页 + Pick Window | ❌ | ❌ | ❌ |
| 翻译 | ✅ 国内可用，暗色弹窗 | ✅ 有道/谷歌 | ❌ | ❌ |
| Python 集成 | ✅ 任意键调用 | ❌ | ❌ | ❌ |
| 多线程支持 | ✅ SetTimer 分发，不阻塞 | ❌ 直接调用 | ✅ Rust 异步 | ❌ |
| CapsLock 防卡死 | ✅ 500ms 自检恢复 | ❌ | — | ❌ |
| 短按切换大小写 | ✅ <250ms 判定 | ✅ | ✅ | ❌ |
| 文件变更监控 | ✅ 自动检测，提示重载 | ✅ | — | ❌ |
| 窗口匹配方式 | ahk_exe+ahk_class 精确 |
窗口 ID（易失效） | 基本操作 | ❌ |
| 暗色 UI 主题 | ✅ 通知 + 翻译弹窗 | ❌ | ❌ | ❌ |
| 代理管理 | ✅ 注册表级系统代理 | ❌ | ❌ | ❌ |
| 后台进程管理 | ✅ 托盘一键启停 | ❌ | ❌ | ❌ |
| 代码量 | ~1700 行 | ~5000+ 行 | ~10000+ 行 | ~80 行 |
| 额外依赖 | 零（纯 AHK v2） | 零 | Rust 运行时 | 零 |
Capslock2 = capslock+ 的现代化替代 + CapsLockX 没有的 GUI 配置 + 多线程、防卡死、多平面、Python 集成。
# 1. 安装 AutoHotkey v2
winget install AutoHotkey.AutoHotkey
# 2. 下载或 clone
git clone https://github.com/matrix1001/capslock2
# 3. 双击 capslock2.ahk托盘出现黄色闪电图标即可使用。Settings.ini 自动生成，带合理默认值。按住 CapsLock 试试任何绑定键。
右键托盘图标 → Edit Settings，打开 5 标签页的设置编辑器：
| 标签页 | 功能 |
|---|---|
| Basic | 管理员模式、开机启动、全屏禁用、Python 路径、代理模式、消息级别 |
| Keymap | 按键 → 函数绑定列表，支持增删改 |
| Switch | 命名窗口定义，含 Pick Window 工具（点目标窗口自动填入匹配条件） |
| Background | 后台进程管理列表 |
| Trans | 翻译源语言 / 目标语言 / MyMemory API Key |
Keymap 标签页：
| Key | Function |
|---|---|
1 |
QWindow(1) |
h |
Send({Left}) |
t |
TranslateSelected |
e |
Window(DirectoryOpus) |
esc |
ToggleSuspend |
| ... | ... |
按钮：Edit Delete Add
Switch 标签页：
| Name | Path / Match |
|---|---|
| Terminal | wt.exe ahk_exe WindowsTerminal.exe ahk_class CASCADIA_HOSTING_WINDOW_CLASS |
| VSCode | Code.exe ahk_exe Code.exe ahk_class Chrome_WidgetWin_1 |
| ... | ... |
按钮：Pick Window Edit Delete Test
Pick Window：点击按钮 → 界面隐藏 → 点击任意窗口 → 自动填入进程路径、
ahk_exe、ahk_class。再也不用猜窗口类名了。
选中文本，按 Caps+T，弹出暗色主题翻译窗口：
┌─ TRANSLATION ──────────── COPY ✕ ─┐
│ │
│ 明天天气预计晴转多云，气温 18 到 │
│ 26 度，适合户外活动。出门记得带 │
│ 一件薄外套，早晚温差较大。 │
│ │
└──────────────────────────────────────┘
- 拖动 — 按住
TRANSLATION区域可拖动窗口 - 复制 — 点击
COPY一键复制译文 - 关闭 —
Esc或✕
使用 MyMemory API —— 免费，无需 API Key，国内可用。
| 按键 | 功能 |
|---|---|
h j k l |
光标 ← ↓ ↑ → |
i o |
Home / End |
u p |
Page Up / Down |
left right |
上一个 / 下一个虚拟桌面 |
| 按键 | 功能 |
|---|---|
1–5 |
切换快速绑定窗口 |
Alt+1–5 |
绑定当前窗口到数字键 |
tab |
同应用窗口间切换（如多个 VS Code 窗口之间） |
g |
关闭当前窗口 |
space |
窗口置顶开关 |
| 按键 | 功能 |
|---|---|
t |
翻译选中文本 |
c / v |
复制 / 粘贴（Ctrl+Ins / Shift+Ins） |
up / down / 滚轮 |
音量控制 |
| 按键 | 功能 |
|---|---|
Alt+R |
重载配置/脚本 |
Alt+P |
系统代理开关 |
Alt+S |
测试 Python 集成 |
Esc |
暂停/恢复 Capslock2 |
短按 CapsLock（<250ms，不按其他键）切换大小写状态。
键位格式：按键=函数名(参数)。支持以下几种写法：
[Keymap]
; --- 发送按键（AHK 内置 Send）---
h=Send({Left}) ; 单键：光标左移
q=Send("^+{Esc}") ; 组合键：Ctrl+Shift+Esc（任务管理器）
x=Send("^{x}") ; 剪切
; --- 启动程序（AHK 内置 Run）---
n=Run("notepad.exe") ; 启动记事本
m=Run("explorer.exe") ; 打开资源管理器
; --- Capslock2 内置函数 ---
t=TranslateSelected ; 翻译选中文本
g=WindowKill ; 关闭当前窗口
space=WindowToggleOnTop ; 窗口置顶开关
tab=SameWindowSwitch ; 同应用窗口切换
esc=ToggleSuspend ; 暂停/恢复
alt_p=ToggleProxy ; 系统代理开关
alt_r=ReloadScript ; 重载配置
; --- 窗口切换 ---
e=Window(DirectoryOpus) ; 启动/激活 DOpus
r=Window(WindowsTerminal) ; 启动/激活 Terminal
a=Window(Edge) ; 启动/激活 Edge
; --- 快速窗口 ---
1=QWindow(1) ; 切换到数字键 1 绑定的窗口
alt_1=QWindowBind(1) ; 将当前窗口绑定到数字 1
; --- 后台进程 ---
alt_o=ToggleBackground(MyServer) ; 启动/关闭后台服务
; --- 自定义函数 ---
alt_w=CheckWeather ; 调用你自己写的函数（无参数）
alt_n=MyFunction(hello, 42) ; 调用你自己写的函数（带参数）| 函数 | 说明 | 示例 |
|---|---|---|
Window(name) |
启动/激活/最小化命名窗口 | e=Window(VSCode) |
QWindow(idx) |
切换到数字键绑定的窗口 | 1=QWindow(1) |
QWindowBind(idx) |
绑定当前窗口到数字键 | alt_1=QWindowBind(1) |
WindowKill() |
关闭当前活动窗口 | g=WindowKill |
WindowToggleOnTop() |
切换窗口置顶状态 | space=WindowToggleOnTop |
SameWindowSwitch() |
同应用多窗口间循环（如多个 VS Code、多个记事本） | tab=SameWindowSwitch |
TranslateSelected() |
翻译选中文本（MyMemory API） | t=TranslateSelected |
ToggleProxy() |
开关系统代理 | alt_p=ToggleProxy |
ToggleSuspend() |
暂停/恢复 Capslock2 | esc=ToggleSuspend |
ReloadScript() |
重载配置 / 脚本变更后完整重启 | alt_r=ReloadScript |
ToggleBackground(name) |
启动/关闭 [Background] 中定义的后台程序 |
alt_o=ToggleBackground(MyServer) |
Send(keys) |
AHK 内置：发送按键序列 | h=Send({Left}) |
Run(target) |
AHK 内置：运行程序或打开文件 | n=Run("notepad.exe") |
PythonRunner.Run(code) |
执行 Python 代码，返回输出字符串 | 见下方 Python 章节 |
- 打开
lib/functions.ahk - 定义一个全局函数：
MyFunction(name, num) {
Engine.Instance.notify.Info(name . " called with " . num)
}- 在
Settings.ini的[Keymap]中添加：
alt_m=MyFunction(test, 123)- 按
Caps+Alt+R重载，搞定。
函数可以写在 lib/ 或 script/ 目录下任意 .ahk 文件中。Capslock2 会自动监控这些文件的变化并提示重载。函数内可以通过 Engine.Instance 访问所有模块（config、notify、window、translate 等）。
每个条目定义如何匹配一个应用窗口：
[Switch]
; 简单程序（exe 在 PATH 中）
Notepad=notepad.exe
Taskmgr=C:\Windows\System32\taskmgr.exe
; 需要精确匹配（exe + class，避免找错窗口）
Edge=msedge.exe ahk_exe msedge.exe ahk_class Chrome_WidgetWin_1
Terminal=WindowsTerminal.exe ahk_exe WindowsTerminal.exe ahk_class CASCADIA_HOSTING_WINDOW_CLASS
VSCode=Code.exe ahk_exe Code.exe ahk_class Chrome_WidgetWin_1
; 完整路径 + 精确匹配（推荐写法，最稳妥）
DOpus=C:\Program Files\GPSoftware\Directory Opus\dopus.exe ahk_exe dopus.exe ahk_class dopus.lister格式：启动路径 ahk_exe 进程名 ahk_class 窗口类名
启动路径：用于启动程序（支持完整路径或 PATH 中的名称）ahk_exe：精确匹配进程名（如msedge.exe）ahk_class：精确匹配窗口类名（防止匹配到不可见窗口）
用 Settings GUI → Switch 标签页 → Pick Window 按钮，点一下目标窗口就能自动填入全部三项，不用手写。
不同应用里同一个按键做不同的事：
[Keymap]
t=TranslateSelected ; 默认：翻译
[Keymap_firefox]
t=Send(^{t}) ; Firefox 里：新建标签页
w=Send(^{w}) ; 关闭标签页
[Keymap_windowsterminal]
t=Send(^+{t}) ; Terminal 里：新建标签页
[Keymap_vscode]
t=Send(^`{``}) ; VSCode 里：切换终端段名是 Keymap_ + 进程名（去掉 .exe，小写）。覆盖的键会替换基础键位，未覆盖的键继续使用 [Keymap]。
注意： Python 集成是可选功能，不配置不影响日常使用。目前仅提供基础设施，后续版本会基于此构建更多功能。
[Basic]
Python=C:\path\to\python.exe ; 可选，不填则不启用 Python 功能[Keymap]
alt_w=CheckWeather; 在 lib/functions.ahk 中
CheckWeather() {
code := "
(
import requests
r = requests.get('https://wttr.in/Beijing?format=3')
print(r.text)
)"
result := PythonRunner.Run(code)
Engine.Instance.notify.Info(result)
}按 Caps+Alt+S 验证 Python 环境是否正常。
右键托盘图标：
- Message Level — 调试 / 正常 / 仅警告 / 禁用
- Disable On Full Screen — 全屏时自动暂停（游戏、演示）
- Utils — 系统代理开关、后台进程启停
- Reload — 配置变更后热重载，不用重启
托盘图标灰色表示已暂停，悬停显示运行状态、代理、后台进程等信息。
capslock2.ahk 入口文件
Settings.ini 用户配置（首次运行自动生成）
lib/
engine.ahk 应用组装 & 生命周期
config.ahk INI 读写、默认值、文件监控
input.ahk CapsLock 状态机 & 按键分发
functions.ahk 键位适配函数（被 keymap 调用）
window.ahk 窗口启动/激活/切换
translate.ahk 翻译服务 & UI
notify.ahk 暗色通知弹窗
helpers.ahk HTTP、代理、剪贴板工具
tray.ahk 系统托盘图标 & 菜单
settings_gui.ahk 5 标签页配置编辑器
python.ahk Python 代码执行器
json.ahk JSON 解析（cocobelgica/AutoHotkey-JSON）
icon/
capslock2.ico 托盘图标（黄色闪电 — 运行中）
capslock2-suspend.ico 托盘图标（灰色闪电 — 已暂停）
- Windows 10 或 11
- AutoHotkey v2.0+
- Python 3.x（可选 —— 用于
PythonRunner）
个人、教育用途免费使用。禁止商用（包括但不限于销售、付费服务、嵌入商业产品）。
lib/json.ahk 来自 cocobelgica/AutoHotkey-JSON，遵循其原始许可。