【免费下载链接】ghui
A GitHub TUI
还在在终端和浏览器之间来回跳，只为看一眼某个 Pull Request 的 diff 或 CI 结果吗？ghui 是一个面向终端的 GitHub TUI（Terminal UI），让你在一块键盘驱动的画面里完成 PR 评审、diff 审阅、评论、合并等操作。而真正让它"上头"的，是两个被很多人忽略的高级技巧：按e键直接把当前 PR 交给你的编辑器（Neovim、VS Code 等），按a键在终端内追踪该 PR 的 GitHub Actions 运行。掌握这两个快捷键，就能彻底告别频繁切屏。
一、为什么需要"不切屏"的 GitHub 工作流
传统流程是：终端里跑gh pr list，看到感兴趣的 PR，切到浏览器看 diff，再切回终端跑测试，然后切到 IDE 写代码……屏幕切来切去，上下文反复中断。
ghui 把所有 PR 收拢到一块可键盘导航的画面里，列表、详情、diff、评论、合并都在原地完成。而下面两个技巧，把"终端 ↔ 编辑器"和"终端 ↔ 浏览器"这两条最常跨的边界也打通了。
二、e键打开编辑器：一键把 PR 交给 Neovim / VS Code
在 PR 列表、详情或 diff 视图里，光标停在某个 PR 上时按e，ghui 会：
- 暂停 TUI（释放 raw mode / alt-screen）；
- 在你的真实终端里运行你配置的命令（交互式编辑器可以直接接管终端）；
- 命令退出后自动恢复 TUI 并重绘。
整个过程类似git commit调用$EDITOR的体验，无论是否使用 tmux 都能工作。
配置editorCommand与repoPaths
编辑器和仓库路径映射写在config.json（Linux 下通常是~/.config/ghui/config.json）。
editorCommand：一条 shell 命令模板；repoPaths：把owner/repo映射到本地克隆目录。
匹配顺序：精确匹配owner/repo→owner 通配符owner/*（*替换为仓库名）→通用模板:owner/:repo。路径中的~会展开为家目录。
{ "editorCommand": "tmux new-window -c {{repoPath}} 'gh pr checkout {{number}} && nvim -c \":DiffviewOpen {{baseRef}}...{{headRef}}\"'", "repoPaths": { "kitlangton/ghui": "~/code/ghui", "kitlangton/*": "~/code/repos/kitlangton/*", ":owner/:repo": "~/src/github.com/:owner/:repo" } }常用命令模板
模板支持这些占位符：{{repo}}、{{owner}}、{{name}}、{{number}}、{{headRef}}（PR 头部分支）、{{baseRef}}（基础分支）、{{author}}、{{url}}、{{repoPath}}（解析出的本地路径）。
// diffview.nvim：检出分支并与 base 做 diff "editorCommand": "tmux new-window -c {{repoPath}} 'gh pr checkout {{number}} && nvim -c \":DiffviewOpen {{baseRef}}...{{headRef}}\"'" // octo.nvim：走 GitHub API 评审（无需 checkout） "editorCommand": "tmux new-window -c {{repoPath}} 'nvim -c \":silent Octo pr edit {{number}}\"'" // VS Code：直接打开本地仓库 "editorCommand": "code {{repoPath}}"如果没配editorCommand，ghui 会回退到$VISUAL/$EDITOR打开解析出的仓库路径；若模板里用了{{repoPath}}却没匹配到repoPaths，会给出清晰报错而不是静默失败。
这套逻辑集中在纯函数模块 src/editorCommand.ts，负责repoPaths解析与模板替换；实际的"暂停 TUI → 运行命令 → 恢复"由 src/services/EditorOpener.ts 和 src/tuiSuspension.ts 协作完成——即使命令失败，也会保证终端被恢复，不会把界面搞坏。
三、a键追踪 Actions 运行：在终端里定位 CI 失败
PR 的检查（checks）红了一片，却看不到为什么红？在 PR 列表或详情上按a，ghui 会打开一个与 diff 视图平级的全屏 Runs 视图，范围锁定在该 PR 的 head commit 上：
- Runs 列表：每次 workflow 运行一行，展示状态、结论、耗时、距今时间；
- 进入运行详情：
enter打开某个 run，看到它的 jobs 和 steps；失败的 step 内联展开日志尾部； - 快速定位失败：
n/p在失败项之间跳转，enter展开 step 完整日志； o在浏览器打开该 run，r刷新，esc逐级退回。
它和 diff 视图是"同级别"的页面模式，底层由 src/keymap/runsView.ts 定义按键、src/ui/runs/RunsPane.tsx 与 src/ui/runs/runsRows.ts 负责渲染，命令入口定义在 src/commands/builtins.ts 的runs.open。与 ghui 其他部分一样，它依赖ghCLI，无需额外配置。
小提示：
a在 PR 上下文中是"打开 Actions runs"；在评论上下文里a表示"新建评论"，注意区分当前所在视图。
四、其他值得记住的快捷键（清单）
| 按键 | 作用 |
|---|---|
j/k或↑/↓ | 上下移动选择 |
gg/G | 跳到第一个 / 最后一个 PR |
enter | 展开详情（详情展开后其余动作仍可用） |
d | 查看所有改动文件的堆叠 diff |
e | 在当前编辑器中打开该 PR |
a | 查看该 PR 的 GitHub Actions 运行 |
shift-r | 评审或批准所选 PR |
s | 切换 draft / 待评审状态 |
m | 合并 |
o | 在浏览器打开 PR |
r | 刷新 |
esc | 从展开详情 / diff / 弹窗中返回 |
五、小结
e键：把"看 diff / 写代码"这件事留在编辑器里，ghui 负责暂停与恢复，你不用切屏；a键：把"为什么 CI 红了"这件事留在终端里，从 run 一路钻到失败 step 的日志；- 两者都在同一块可键盘驱动的画面内完成，配合
enter、d、shift-r、m等按键，评审一个 PR 几乎不用离开键盘和终端。
装上 ghui 后，把editorCommand和repoPaths配好，e与a这两个高级技巧就会成为你每天最顺手的习惯。
【免费下载链接】ghui
A GitHub TUI
相关推荐
Sloth SLO 快速入门：从零开始构建服务级别目标监控
Sloth SLO 快速入门：从零开始构建服务级别目标监控 Sloth 是一款基于 Prometheus 的 SLO（服务级别目标）生成工具，它能帮助开发者轻松
运维云原生后端掌握PSReadLine多行编辑：告别单行限制的7个实用技巧
掌握PSReadLine多行编辑：告别单行限制的7个实用技巧 PowerShell是Windows系统管理员和开发者的强大工具，但默认的命令行编辑体验往往受限于
开发工具Mac窗口管理神器Topit：彻底告别频繁切换的烦恼
Mac窗口管理神器Topit：彻底告别频繁切换的烦恼 还在为Mac上多个窗口来回切换而头疼吗？Topit作为一款专业的窗口置顶工具，能够将任意应用窗口固定在屏幕
桌面应用
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
