v1.2.1 · macOS 13+ · Apple Silicon 与 Intel

让修音插件的基调
跟着歌一起动。

Guckey 检测当前播放歌曲的基调,编码成三条 MIDI CC,推给 Studio One 的宏控制器旋钮, 再由宏旋钮写进插件里的 Key / Scale。 它是独立 App —— 不加载 VST3 / AU / AAX,不实例化 AVAudioUnit, 完全不参与音频渲染链路。

手动 > 云端 > AI 三级决策 虚拟 MIDI 源 · CoreMIDI 音频只在本地分析
控制台 · 实时
Guckey 控制台界面:当前基调 G Major,来源为手动,右侧为 MIDI 事件日志
Guckey 悬浮窗:基调与电音强度旋钮
01 · 读
拿到现在在放什么MediaRemote / AppleScript / 窗口标题
02 · 判
三级基调决策手动 → 云端曲库 → AI 实时分析
03 · 发
三条 MIDI CCRoot #20 · Scale #22 · Speed #24
04 · 落
写进插件参数外部设备 → 宏旋钮 → Key / Scale

Decision Engine

一个基调,只认一个来源。

同一个歌名可能同时被手动记录、云端曲库和实时分析命中。Guckey 用固定优先级裁决, 并且一旦锁定,就不再让后面的结果改写它 —— 这是「CC 不再乱跳」的关键。

CC♯DD♯EF F♯GG♯AA♯B
01

手动更正

本地 SQLite 里的 manual_keys。命中即强制锁定,无视云端与 AI,只发一次锁定的值。

最高优先 · 命中即锁
02

云端曲库

云端曲库同步下来的 cloud_keys。先精准匹配,失败再走 Levenshtein 模糊匹配(容差随长度放宽)。

精准 → 模糊
03

AI 实时分析

音频进自研 DSP(YIN + FFT 色度 + Krumhansl 剖面),但必须通过稳定化模块才允许输出。

稳定后才发
实现点 一旦 lockedSource != nil,引擎会直接丢弃后续所有 AI 结果。 所以你在 Studio One 里看到的旋钮是「钉住的」,而不是每秒抖一次的。

Stabilizer

AI 那一级的每一帧,都要先过关。

调性估计本身不做防抖,抖动全部交给稳定化模块处理。以下参数都能在 App 里调。

参数默认作用
置信度下限0.70Krumhansl 相关系数低于此值的单帧直接丢弃
滑动窗口10 s窗口内某一调占比 > 60% 才允许输出
首次锁定最少样本6防止 2–3 帧就抢锁导致占比虚高
迟滞保持时长3 s新调性连续保持这么久才允许切换
迟滞置信度优势0.15需高出 locked + 0.15 × (1 − locked),按剩余余量折算以保证可达
启动静默6 s切歌后这段时间内不发任何 CC
分析频段60–500 Hz频域带通,聚焦和弦与贝斯

12 音级逐级校准

默认把 Root 的 12 档等分到插件低 / 高档之间,取区间正中;档位能逐音级覆盖,也能用「扫动 CC#20」让宿主自己学一遍。

按插件自动匹配调式表

内置 Auto-Tune Pro、Auto-Tune Advanced、Auto-Tune (2026)、Waves Tune Realtime、topline 的调式表;不在列表里的插件选「自定义」,填一下调式总数即可。

只读云端,切歌零请求

云端曲库每次同步整体覆盖本地缓存,并顺带清理已删除的行。查询只读本地 SQLite,播放中不发任何网络请求。

悬浮窗 · 全局快捷键

无边框常驻面板,顶边锚定、悬停展开,位置会记住。⌥⌘K 随时叫出来看一眼当前基调,或者顺手改掉。

Download

下载

同一份安装包同时支持 Apple Silicon 与 Intel 两种芯片,已签名。macOS 13.0 或更新。

Guckey 图标
Guckey
v1.2.1 · macOS

基调检测 + 三级决策 + 三条 MIDI CC 输出,控制台与悬浮窗共用一个状态源。

macOS 13.0 或更新 Apple Silicon + Intel 2.3 MB .dmg
下载 .dmg 已签名 · 未公证
SHA-256 · BA3499F8 CED699B6 644C00C4 4AAB06F8 D78718E3 4199E1E6 9DA17DF3 512AF8FC
首次打开 应用未经 Apple 公证,系统会提示「无法验证开发者」。打开「访达」→ 右键点 App → 选「打开」,或到 系统设置 → 隐私与安全性点「仍要打开」,之后就能正常双击启动。
会申请的权限 屏幕录制(系统音频模式首次运行)、麦克风(麦克风 / 线路输入模式)、自动化(从 Music / Spotify 读取曲目)。 音频只进 DSP,不录制、不上传、不进入输出链路。

FAQ

常见问题

为什么不直接连插件的 MIDI 输入?
Studio One 7 的插入效果器收不到 MIDI(真机实测)。宏旋钮是宿主参数,能被外部控制器学习,所以链路走 CC → 外部设备 → 宏旋钮 → 插件参数,绕开插件本身。
宿主收不到 CC 值怎么办?
先在「MIDI 映射」确认发送通道。默认单通道(1),Studio One 的外部设备里 MIDI 通道也要只勾 1;确认无误仍收不到,再打开 16 通道广播(副作用是 MIDI 学习里会冒出 16 个重复旋钮)。另外每条 CC 默认连发 2 次、间隔 25 ms,对「同值 CC 不响应」的链路更稳。
纯音乐、强打击乐识别不准?
这类编曲的置信度天然偏低。可以调大稳定化里的「窗口长度」,或降低「置信度下限」;配上贝斯的歌曲通常一眼就准。实在不行,手动改一次就永久修正了。
我的音频会被上传吗?
不会。音频只进本地 DSP(Accelerate 框架),不录制、不上传、不进入输出链路。唯一联网的动作是启动时同步一次云端曲库,而且只读。
支持哪些修音插件?
Auto-Tune Pro、Auto-Tune Advanced、Auto-Tune (2026)、Waves Tune Realtime、topline。不在列表里的插件选「自定义」,填一下调式总数即可。

Contact

遇到问题,或者想提需求。

崩溃日志、截图、需求、吐槽都可以直接发。加微信时备注一下「Guckey」,通过得更快。

微信
YX-CJ_6120
加好友请备注「Guckey」
邮箱
2297773622@qq.com
崩溃日志与截图可以发这里