7 min read

我用 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,

#tag

胶囊,==高亮==,嵌入笔记。

图像

Live Preview 里的 callout、tag、高亮和嵌入笔记

11/ Source Control 替掉了 SourceTree

我之前用 SourceTree,现在已经完全换掉了。stage、commit、amend、pull、push、切分支、切 worktree、看 commit graph、blame,平时要的都在一个侧边栏里。

图像

Source Control 的 commit graph 和单个 commit 的 diff