Config For Hammerspoon
Made By MiPoNianYou
Inspiration From twricu

⚙️ 为 macOS 注入更高效的工作流与个性化体验 ⚙️
让每一次操作都如丝般顺滑 让每一次切换都且恰到好处

✨ 功能全景

🪄 核心特性概览

• 💡 大写键超级进化 - 将不常用的 Caps Lock 键转变为强大的功能修饰键 重映射为 F13 释放无限快捷可能
• 🚀 应用快速启动器 - 使用 ⇪ + 特定字母 快速启动或聚焦常用应用程序
• ⌨️ 循环切换输入法 - 告别复杂的组合键 只需轻点 Shift ⇧ 键 即可轻松在输入法间流畅循环切换 且不影响长按或其他组合快捷键
• ☕️ 系统防休眠守护 - 通过 ⇪ + ⌃ + P 快捷键 一键切换系统休眠状态 菜单栏将同步显示 ☕️ 图标作为提示
• 🔊 输出设备切换器 - 通过 ⇪ + ⌃ + A 快捷键 在已连接的音频输出设备间即时循环切换 无论是内置输出 / 蓝牙耳机还是外接音响 一键流转
• 📑 软件标签页导航 - 在支持上下页的软件中 使用 ⇪ + ← 和 ⇪ + → 在软件内标签页间自如穿梭
• ✍️ Markdown模式 - 组合 ⇪ + ⌥ + 特定按键 让 Markdown 书写行云流水 无需再为中英文切换所扰 无论是 强调重点 / 轻盈斜体 / 划去旧痕 / 抑或嵌入代码片段与构建链接锚点 皆能轻松实现 一切尽在指尖 一气呵成
• 🎵 菜单栏乐曲随行 - 在菜单栏即时捕获并显示 Spotify/Apple Music 正在播放的曲目与艺人信息 通过 ⇪ + ⌃ + S 快捷键 随心控制其显隐
• 🔄 配置档自动更新 - 配置启动时及每隔24小时 脚本将自动静默检查云端上的最新版本 若有更新将通过通知提醒 亦可通过 ⌘ + ⌥ + ⌃ 手动触发检查 时刻保持最新体验
• 🔃 配置即时热重载 - 使用 ⌘ + ⌥ + ⌃ + R 快捷键 无需手动点击 Hammerspoon 即可即时应用配置更改
• 🧰 个性化功能定制 - 随心定制专属体验 无论是快捷键绑定 还是各项增强功能 均可轻松调整或禁用 打造最适合个人的工作流

⌨️ 快捷按键指南

⌨️ 按键组合	⚡️ 功能描述
Shift ⇧	循环切换 输入法
⇪ + I	启动/聚焦 系统设置
⇪ + F	启动/聚焦 访达
⇪ + T	启动/聚焦 终端
⇪ + A	启动/聚焦 Arc 浏览器
⇪ + S	启动/聚焦 Spotify
⇪ + V	启动/聚焦 VS Code
⇪ + G	启动/聚焦 Telegram
⇪ + ⌃ + P	开启/关闭 系统防休眠 模式
⇪ + ⌃ + A	循环切换 音频输出设备
⇪ + ←	切换到 上一个 标签页（需软件支持）
⇪ + →	切换到 下一个 标签页（需软件支持）
⇪ + ⌥ + Q	Markdown 格式化 - 套引用块
⇪ + ⌥ + B	Markdown 格式化 - 加粗文本
⇪ + ⌥ + I	Markdown 格式化 - 斜体文本
⇪ + ⌥ + S	Markdown 格式化 - 删除文本
⇪ + ⌥ + K	Markdown 格式化 - 代码语法
⇪ + ⌥ + L	Markdown 格式化 - 链接语法
⇪ + ⌃ + S	开启/关闭 菜单栏乐曲随行
⌘ + ⌥ + ⌃ + U	手动检查 配置更新
⌘ + ⌥ + ⌃ + R	重载 Hammerspoon 配置

📖 使用教程

1. 使用配置

• 前往 Hammerspoon 官方网站 下载并安装
• 安装后 Hammerspoon 🔨 图标会出现在菜单栏中 标志着一切准备就绪

2. 导入配置

选择任一方式以运用配置文件

• 通过菜单

  • 点按菜单栏中的 🔨 图标
  • 选择 「Open Config」
  • 将提供的 init.lua 内容拷贝粘贴到打开的配置文件中并存储

• 通过访达

  • 打开 Finder
  • 选择「前往」菜单中的「前往文件夹」/ 或使用快捷键 Command + Shift + G
  • 输入路径 ~/.hammerspoon/ 并点击前往
  • 将下载的 init.lua 文件直接拖入此文件夹内

1. 激活配置

• 完成配置后 再次点按菜单栏中的 🔨 图标 并选择 「Reload Config」
• Hammerspoon 会弹出配置加载成功通知 各种增强功能随之生效

4. 修改配置

• 定制启动

  • 在配置文件中查找 CAPSLOCK_APP_SHORTCUTS 配置表 即可自定个人偏爱的快捷键与应用程式 打造专属于自己的个性化捷径
  • key - 定义按下 ⇪ 后 希望激活应用的快捷键
  • appName - 指定个人所需的应用程式名称

• 调整功能

  • 导航至 配置初始化与快捷键绑定 模块 各项功能均有清晰的功能标注
  • 通过在相应调用代码行前添加/移除 -- > 即可便携地禁用或重新启用特定功能

📮 投递反馈

😡 脚本寄了 → 飞到Issues开骂

🌠 功能许愿 → 飞到Discussions祈祷

Copyright © 2025 念柚