我用 Mayoi 换掉了 VSCode、SourceTree、Obsidian 和 Herdr
Source: https://x.com/i/article/2122862965364002816
上个月写过一篇,讲我为什么给自己写了 Mayoi。这一个多月每天都在用,记一下我自己的用法,一共 11 条,配置能贴的都贴上了,照着抄就行。版本是 v0.22.3。
1/ 11 款主题,我用 Witch's Brew
每款都打磨过几轮。Witch's Brew 是万圣节三套里的一套,一直是深色,欢迎页上有一口冒泡的坩埚。View → Theme 换,或者在 Settings → Appearance 里点预览图。
Witch's Brew 主题
2/ 把 keybindings.json 配好
配好以后,大部分功能都能用快捷键做。File → Open Keyboard Shortcuts (JSON) 打开它,格式和 VS Code 一样,原来的文件可以直接粘过来。
我用 ctrl+. 当前缀键,再接一个键。
- n 在编辑区开一个终端
- v 开关 vim mode
- l 锁定 column,锁住的那列专门放终端,之后从文件树、⌘P、Source Control 打开的文件都不会挤进去
- s 切换项目(Open Recent)
- c 复制当前文件路径
- o f 在 Finder 里显示当前文件
还有两组最常用。g 加一个字母,一键切到常用项目,比如 g n 是 notes,g m 是 mayoi。o 加一个字母,一键打开常用文件,比如 o k 打开 keybindings.json 自己,o z 打开 ~/.zshrc。
json
[
// 终端:n 在编辑区开一个终端 tab,t 开关底部面板的终端
{ "key": "ctrl+. n", "command": "workbench.action.createTerminalEditor" },
{ "key": "ctrl+. t", "command": "workbench.action.terminal.toggleTerminal" },
// 侧边栏:1 文件树,2 搜索,3 Source Control,4 Sessions
{ "key": "ctrl+. 1", "command": "workbench.view.explorer" },
{ "key": "ctrl+. 2", "command": "workbench.view.search" },
{ "key": "ctrl+. 3", "command": "workbench.view.scm" },
{ "key": "ctrl+. 4", "command": "view.sessions" },
// 编辑区:v 开关 vim mode,l 锁定当前列,m l / m r 把当前 tab 挪到左边 / 右边那列
{ "key": "ctrl+. v", "command": "view.vim" },
{ "key": "ctrl+. l", "command": "view.lockColumn" },
{ "key": "ctrl+. m l", "command": "view.moveTabPrev" },
{ "key": "ctrl+. m r", "command": "view.moveTabNext" },
// 当前文件:复制路径、重命名、在 Finder 里显示、在 GitHub 上打开
{ "key": "ctrl+. c", "command": "workbench.action.files.copyPathOfActiveFile" },
{ "key": "ctrl+. r", "command": "file.rename" },
{ "key": "ctrl+. o f", "command": "revealFileInOS" },
{ "key": "ctrl+. o g", "command": "git.openFileOnRemote" },
// 切项目:s 从最近打开的里挑,g 加字母直达常用项目
{ "key": "ctrl+. s", "command": "file.openRecent" },
{ "key": "ctrl+. g n", "command": "file.openFolder", "args": "~/Projects/notes" },
{ "key": "ctrl+. g m", "command": "file.openFolder", "args": "~/Projects/mayoi" },
// 按自己的项目往下加
// 打开常用文件:k 是这份 keybindings.json 自己,z 是 ~/.zshrc
{
"key": "ctrl+. o k",
"command": "vscode.open",
"args": "~/Library/Application Support/Mayoi/keybindings.json"
},
{ "key": "ctrl+. o z", "command": "vscode.open", "args": "~/.zshrc" },
]
我的自定义快捷键全挂在 ctrl+. 下面,第二个键按用途分,g 跳项目,o 打开东西,m 挪 tab,数字切侧边栏。按下 ctrl+. 以后,状态栏会显示已经按了哪些键,按错了 Esc 退出。不想手写 JSON 的话,File → Keyboard Shortcuts… 有图形界面,改完一样写回这个文件。
3/ 打开 Project Tabs
View → Project Tabs。多个项目放进一个窗口,左边一条竖栏,一个项目一个方块,切起来方便。
方块上可以拖一张图片当图标,PNG、SVG、ICO 都行。项目一多,看图标认比看两个字母的缩写快。不拖的话,Mayoi 会自己去项目里找 favicon 或 logo。
Project Tabs,每个方块换成自己的图标
4/ 终端后端换成 hc
settings.json 里加一行。
"terminalBackend": "hc"
hc 就是 herdr-core。本机没装的话,第一次开终端会问要不要装,也可以走 View → Install hc…。
配好以后终端就和编辑器分开了。shell 跑在 herdr-core 里,关掉 Mayoi、重启、升级,终端都还在,下次打开自动接回原来的 tab,滚动记录也在。真要结束,就把那个终端关掉。
跑 code agent 还有个好处。agent 会用 OSC 7501 报告自己在干什么,Mayoi 认这个协议,终端 tab 上和侧边栏的 Sessions 里都能看到状态,working、waiting、done、failed。开了 hc,别的窗口和 Herdr app 里跑着的 session 也带这个状态。

GIF
终端 tab 和右上角的状态从 working 变成 waiting,再到 done
5/ 一个小 tip,Sessions 选 All Projects
切到 Sessions 面板,选 All Projects。之后再切项目,它会一直停在 All Projects,面板也不会被换走。
这时 Mayoi 基本可以当 herdr client 用。所有项目的 agent 在一个列表里,选中按回车,还在 herdr-core 里跑的,直接显示那个终端;已经停了的,就开个终端 resume 它。

GIF
Sessions 选 All Projects 后切项目,列表不变
6/ 登录,同步配置
Mayoi → Sign In…,GitHub 或 Google 登录。settings.json 和 keybindings.json 会跟着账号走,换一台电脑登录,主题、快捷键、hc 这些都在。项目图标和 hc 的路径不同步,它们跟机器走。
登录后状态栏的云图标打开同步面板
7/ 装上 mayoi 命令
File → Install 'mayoi' Command。之后在任意目录敲 mayoi . 就打开当前项目,开着 Project Tabs 的话,它会作为一个新方块加进来。
8/ 远程电脑也连上
Mayoi 支持 Remote SSH,我会把远程电脑也连上来,用起来和本地一样(上一篇写过,不展开)。
配了 hc 以后远程也生效。远程目录的终端跑在那台机器的 hc 上,远程的终端也一样保留。第一次连会问要不要把这台机器加进 hc,可能会顺手把 hc 拷过去。
远程机器第一次开终端,问要不要加进 hc
9/ 在里面管 GitHub issue 和 PR
仓库有 GitHub remote,侧边栏就会多一个 GitHub 按钮,上面的数字是等我 review 的 PR。PR 点开是一个 tab,conversation、changes、commits、checks 都在里面,review 和 merge 也在这做。issue 一样在 tab 里看、回复、关掉。数据是用 gh 读的,没登录的话它会帮你在终端里跑 gh auth login。
侧边栏的 GitHub 视图,空格看 PR 卡片
10/ 当 Obsidian 用
settings.json 里设 "markdownMode": "live",打开 md 就是 Live Preview,边看边改,Markdown 标记只在光标所在的地方露出来。
大部分 Obsidian 的能力都有。[[ 补全笔记,wiki link 在整个 vault 里找,callout,
胶囊,==高亮==,嵌入笔记。
Live Preview 里的 callout、tag、高亮和嵌入笔记
11/ Source Control 替掉了 SourceTree
我之前用 SourceTree,现在已经完全换掉了。stage、commit、amend、pull、push、切分支、切 worktree、看 commit graph、blame,平时要的都在一个侧边栏里。
Source Control 的 commit graph 和单个 commit 的 diff