Kando 滑鼠手勢選單的應用場景
Kando 滑鼠手勢選單的應用場景
Kando 是什麼
Kando 是一個跨平台的**圓盤選單（pie menu / marking menu）**工具：綁一個快捷鍵後，選單會在游標位置彈出，用滑鼠往某個方向滑動或點擊就能選到項目。每個項目可以執行指令、模擬快捷鍵、開啟網址/檔案、貼上文字或串成巨集。
它最關鍵的特性是標記模式（marking mode）：選單結構固定後，可以靠肌肉記憶往某個方向「甩」一下盲選，不需要看著選單找項目。這跟「打字找東西」的啟動器（Raycast / Alfred / Spotlight）是不同的互動範式。
適用判準（先判斷再設計）
Kando 補的是一個特定空缺：手已經在滑鼠/觸控板上、不想切回鍵盤、而且動作有空間對應。它跟鍵盤快捷鍵或啟動器是並存關係，不是替代。判斷一個動作該不該交給 Kando，用以下三條：
- 動作數量超過快捷鍵好記的上限。同類動作一旦超過七八個，組合鍵就開始互相打架、記不住；圓盤選單用空間位置取代記憶。
- 當下手在滑鼠、切回鍵盤是中斷。瀏覽、看文件、看設計稿時，打字啟動器反而要先把手移開；圓盤選單原地彈出。
- 動作有方向語意，盲操作就能命中。例如「左半邊視窗」往左滑、「下一個螢幕」往外圈滑。有方向對應的動作練熟後可以完全不看選單。
三條不必同時滿足，但命中越多越適合。反過來說，低頻、無方向語意、又需要打字輸入參數的動作，留在啟動器或 CLI 比較好。
macOS 工程師的應用場景
以下幾組依「契合 Kando 的程度」排序，越前面方向語意越強、回報越快。
1. 視窗排版（最契合）
方向天然對應位置，這是 Kando 比 Rectangle 純快捷鍵更直覺的地方：
- 往左滑放左半螢幕、往右放右半、往上全螢幕、往下置中浮動
- 對角線放四分之一角落
- 外圈再包一層：丟到下一個螢幕、移到上一個 Space
底層用 simulate hotkey 去觸發 Rectangle 或 yabai。練熟後完全盲操作，不用記「左半邊是哪組三鍵組合」這種反直覺對應。
2. 瀏覽器內「當前頁面接我的工作流」
看 PR、issue、文件時手在滑鼠上，這時甩一下選單把當前頁面導進後續流程：
- 複製當前 URL 成 Markdown 連結
- 把選取文字丟進 AI（觸發 Raycast AI / ChatGPT 的 hotkey，或貼到剪貼簿）
- 存進筆記軟體
- 在編輯器開對應的 local repo
3. 開發環境一鍵啟動（巢狀選單）
用 run command，適合放每天重複開的那幾個專案：
- 外圈按專案分
- 內圈每個專案：用 IDE 開、開 terminal 到該目錄、開 PR 頁、開 CI dashboard、
docker compose up
4. 常用 snippet / 樣板貼上
用 paste text，放那些「記不得但常用」的東西：
- Email 簽名、PR 描述模板、commit message 前綴
- 常用 emoji / 符號
- 長的 shell one-liner
5. 系統狀態切換
toggle 類，平常要進設定點半天的：
- 勿擾模式、深色/淺色主題、防睡眠、切換音訊輸出裝置、螢幕錄製/截圖
6. Git / 容器 context 切換
git 日常走 CLI，但切 context 這種低頻又記不住名字的適合放選單：
kubectlcontext / namespace 切換- AWS profile 切換
- docker 清理、重啟某個 compose service
建構自己模式的起步建議
別一次設計大選單。先只做視窗排版那組，因為方向對應最直覺、回報最快、最容易養成「想到就甩一下」的習慣。等這個習慣固定了，再依「這禮拜我重複做了什麼、又懶得記快捷鍵」逐步往其他組長。一開始就塞滿，反而會因為記不住結構而棄用。
設定範例：視窗排版（Magnet 版）
底層用 hotkey 型項目去打 Magnet 的預設快捷鍵（Magnet 的修飾鍵是 Control+Option，Option 在按鍵碼裡是 AltLeft）。八個項目用 angle 釘死在八個方向，方向語意對齊位置：左滑放左半、右滑放右半、上滑最大化、下滑置中、四個對角放四分之一角落。練熟後可以盲操作。
Kando 的角度規則是 0 在正上方、順時針遞增（90 右、180 下、270 左）。每個 hotkey 都設 delayed: true，讓按鍵在選單關閉後才送出，這樣 Magnet 作用的是「開選單前那個聚焦視窗」而不是 Kando 的 overlay。
1{
2 "menus": [
3 {
4 "root": {
5 "type": "submenu",
6 "name": "視窗排版",
7 "icon": "grid_view",
8 "iconTheme": "material-symbols-rounded",
9 "children": [
10 {
11 "type": "hotkey",
12 "data": { "hotkey": "ControlLeft+AltLeft+Enter", "delayed": true },
13 "name": "最大化",
14 "icon": "fullscreen",
15 "iconTheme": "material-symbols-rounded",
16 "angle": 0
17 },
18 {
19 "type": "hotkey",
20 "data": { "hotkey": "ControlLeft+AltLeft+KeyI", "delayed": true },
21 "name": "右上",
22 "icon": "north_east",
23 "iconTheme": "material-symbols-rounded",
24 "angle": 45
25 },
26 {
27 "type": "hotkey",
28 "data": { "hotkey": "ControlLeft+AltLeft+ArrowRight", "delayed": true },
29 "name": "右半",
30 "icon": "east",
31 "iconTheme": "material-symbols-rounded",
32 "angle": 90
33 },
34 {
35 "type": "hotkey",
36 "data": { "hotkey": "ControlLeft+AltLeft+KeyK", "delayed": true },
37 "name": "右下",
38 "icon": "south_east",
39 "iconTheme": "material-symbols-rounded",
40 "angle": 135
41 },
42 {
43 "type": "hotkey",
44 "data": { "hotkey": "ControlLeft+AltLeft+KeyC", "delayed": true },
45 "name": "置中",
46 "icon": "filter_center_focus",
47 "iconTheme": "material-symbols-rounded",
48 "angle": 180
49 },
50 {
51 "type": "hotkey",
52 "data": { "hotkey": "ControlLeft+AltLeft+KeyJ", "delayed": true },
53 "name": "左下",
54 "icon": "south_west",
55 "iconTheme": "material-symbols-rounded",
56 "angle": 225
57 },
58 {
59 "type": "hotkey",
60 "data": { "hotkey": "ControlLeft+AltLeft+ArrowLeft", "delayed": true },
61 "name": "左半",
62 "icon": "west",
63 "iconTheme": "material-symbols-rounded",
64 "angle": 270
65 },
66 {
67 "type": "hotkey",
68 "data": { "hotkey": "ControlLeft+AltLeft+KeyU", "delayed": true },
69 "name": "左上",
70 "icon": "north_west",
71 "iconTheme": "material-symbols-rounded",
72 "angle": 315
73 }
74 ]
75 },
76 "shortcut": "Control+Shift+Space",
77 "shortcutID": "",
78 "centered": false,
79 "anchored": false,
80 "hoverMode": false
81 },
82 {
83 "root": {
84 "type": "submenu",
85 "name": "視窗進階",
86 "icon": "view_column",
87 "iconTheme": "material-symbols-rounded",
88 "children": [
89 {
90 "type": "hotkey",
91 "data": { "hotkey": "ControlLeft+AltLeft+KeyD", "delayed": true },
92 "name": "左三分之一",
93 "icon": "first_page",
94 "iconTheme": "material-symbols-rounded"
95 },
96 {
97 "type": "hotkey",
98 "data": { "hotkey": "ControlLeft+AltLeft+KeyF", "delayed": true },
99 "name": "中三分之一",
100 "icon": "vertical_align_center",
101 "iconTheme": "material-symbols-rounded"
102 },
103 {
104 "type": "hotkey",
105 "data": { "hotkey": "ControlLeft+AltLeft+KeyG", "delayed": true },
106 "name": "右三分之一",
107 "icon": "last_page",
108 "iconTheme": "material-symbols-rounded"
109 },
110 {
111 "type": "hotkey",
112 "data": { "hotkey": "ControlLeft+AltLeft+KeyE", "delayed": true },
113 "name": "左三分之二",
114 "icon": "align_horizontal_left",
115 "iconTheme": "material-symbols-rounded"
116 },
117 {
118 "type": "hotkey",
119 "data": { "hotkey": "ControlLeft+AltLeft+KeyT", "delayed": true },
120 "name": "右三分之二",
121 "icon": "align_horizontal_right",
122 "iconTheme": "material-symbols-rounded"
123 },
124 {
125 "type": "hotkey",
126 "data": { "hotkey": "ControlLeft+AltLeft+MetaLeft+ArrowLeft", "delayed": true },
127 "name": "上一個螢幕",
128 "icon": "arrow_circle_left",
129 "iconTheme": "material-symbols-rounded"
130 },
131 {
132 "type": "hotkey",
133 "data": { "hotkey": "ControlLeft+AltLeft+MetaLeft+ArrowRight", "delayed": true },
134 "name": "下一個螢幕",
135 "icon": "arrow_circle_right",
136 "iconTheme": "material-symbols-rounded"
137 },
138 {
139 "type": "hotkey",
140 "data": { "hotkey": "ControlLeft+AltLeft+Backspace", "delayed": true },
141 "name": "還原",
142 "icon": "settings_backup_restore",
143 "iconTheme": "material-symbols-rounded"
144 }
145 ]
146 },
147 "shortcut": "Control+Shift+Alt+Space",
148 "shortcutID": "",
149 "centered": false,
150 "anchored": false,
151 "hoverMode": false
152 }
153 ]
154}套用方式：
- 先完全結束 Kando（Kando 會在離開時把記憶體裡的設定寫回檔案、開著編輯會被覆蓋）。
- 編輯 macOS 的設定檔
~/Library/Application Support/kando/menus.json。若已有自訂選單，把menus陣列裡的兩個物件貼進去、不要整檔覆蓋。 - 重新開 Kando。觸發鍵
Control+Shift+Space（進階組Control+Shift+Alt+Space）若跟既有快捷鍵衝突，直接在 Kando 設定 GUI 改最保險。
對照表（方向 → Magnet 動作 → 快捷鍵）：
| 方向 | 動作 | Magnet 快捷鍵 |
|---|---|---|
| 上 | 最大化 | ⌃⌥↵ |
| 右 | 右半 | ⌃⌥→ |
| 下 | 置中 | ⌃⌥C |
| 左 | 左半 | ⌃⌥← |
| 右上 | 右上角 | ⌃⌥I |
| 右下 | 右下角 | ⌃⌥K |
| 左下 | 左下角 | ⌃⌥J |
| 左上 | 左上角 | ⌃⌥U |
設定範例：自訂腳本叫出 Ghostty 執行（command 型）
command 型項目直接把指令交給作業系統執行，它本身不開終端機視窗。要「叫出 Ghostty 並在裡面跑腳本」，得用 Ghostty 的 -e 旗標開一個新視窗執行指定指令。下面這組放兩個需要看畫面的磁碟工具：mole（互動式清理 TUI）跟 disk-report（印出硬碟空間報告，安裝方式見該篇）。
兩個寫法的共同骨架是 ghostty -e zsh -lc "<腳本>; exec zsh"：
zsh -lc：用 login shell 執行，載入.zprofile/.zshrc的 PATH（PATH 設定見新機基礎建設），mole跟~/.local/bin底下的腳本才解析得到。少了這層，Kando 走/bin/sh、沒有自訂 PATH，會找不到指令。; exec zsh：腳本結束後把視窗留在一個互動 shell。mole 退出或 disk-report 印完，畫面都還在，不會瞬間關掉。
1{
2 "root": {
3 "type": "submenu",
4 "name": "磁碟工具",
5 "icon": "hard_drive",
6 "iconTheme": "material-symbols-rounded",
7 "children": [
8 {
9 "type": "command",
10 "data": {
11 "command": "/Applications/Ghostty.app/Contents/MacOS/ghostty -e zsh -lc \"mole; exec zsh\"",
12 "delayed": false,
13 "isolateProcess": false
14 },
15 "name": "mole 清理",
16 "icon": "cleaning_services",
17 "iconTheme": "material-symbols-rounded"
18 },
19 {
20 "type": "command",
21 "data": {
22 "command": "/Applications/Ghostty.app/Contents/MacOS/ghostty -e zsh -lc \"disk-report; exec zsh\"",
23 "delayed": false,
24 "isolateProcess": false
25 },
26 "name": "硬碟空間報告",
27 "icon": "monitoring",
28 "iconTheme": "material-symbols-rounded"
29 }
30 ]
31 },
32 "shortcut": "Control+Shift+KeyD",
33 "shortcutID": "",
34 "centered": false,
35 "anchored": false,
36 "hoverMode": false
37}把上面這個物件加進 menus.json 的 menus 陣列（跟前面視窗那兩個並排，逗號分隔）。
兩個延伸調整：
- 純背景、不用看畫面的腳本：不必開 Ghostty，
command直接寫zsh -lc "$HOME/.local/bin/某腳本"就好，腳本在背景跑完無聲結束。 - 若
ghostty二進位路徑直接呼叫沒反應（Ghostty 已在執行時偶有此狀況）：改用open -na Ghostty --args -e zsh -lc "mole; exec zsh"，強制由open帶起一個新視窗。
我的自訂模式紀錄
（待補：實際用了一段時間後保留與淘汰的項目、其他組選單的 JSON、踩到的坑。）