navi 交互式命令行速查工具

记不住命令行参数的锅，不该让工程师背

写运维脚本或调试构建任务时，最磨人的往往不是写代码本身，而是跟一堆 CLI 工具的参数较劲。tar 到底要加 z 还是 j？git commit 那个一长串可选 flag 里，哪个才是这次要用的？传统解法无非三种：反复翻 man 页、在浏览器里搜 Stack Overflow、或者去翻半年前的笔记。这三种方式都打断当前工作流——你明明是在终端里干活，却要切到另一个界面去找答案，找到之后还得手动把参数抄回命令行。

navi 想解决的就是这个「查命令 → 抄参数 → 回终端」的往返损耗。

它是怎么工作的

navi 的核心思路是把命令速查表变成终端里的交互式程序，关键能力有三个：

• 交互式浏览与填充：速查表按主题组织成一颗搜索树，你逐层选择需要的命令，navi 会以表单形式让你填各个参数的值，而不是让你背下整条命令再粘贴。这在参数多、取值固定的场景（比如编译选项、镜像构建参数）里特别顺手。
• 模糊搜索：记不清命令全名时可以直接输入关键词做模糊匹配，不必逐级翻目录。命令是 Rust 写的，本地搜索基本没有延迟。
• 社区维护的速查表仓库：命令的覆盖范围不靠作者单打独斗，而是依赖社区持续贡献的 cheatsheet 仓库，常用工具都能在里面找到现成条目，也可以自己补充或修正。

实际使用时的路径大致是：打开 navi → 输入关键词或逐层展开分类 → 选中目标命令 → 按提示逐个填写参数 → 回车，navi 把拼好的命令打印出来，你复制进终端执行即可。它不会替你执行命令，更像是一个长在终端里的参数顾问。

适用边界与注意点

几个值得留意的地方：

• 速查表质量取决于社区：仓库是社区维护的，条目是否齐全、示例是否跟当前版本匹配，都由贡献者决定。小众工具可能搜不到，这种情况需要自己写条目。
• 它不是命令执行器：navi 只负责把命令拼好给你看，不会替你运行，安全边界很清晰，但也意味着「一键执行」的自动化是做不到的。
• shell 集成需要配置：想在当前 shell 里获得较好的体验（比如别名、函数注入），需要按文档做一次性的配置，不同 shell 的配置方式不一样。
• 适合高频、参数固定的 CLI：如果只是偶尔跑一条命令，翻文档的成本也不算高；navi 的价值在那些你每周都要用、参数又总记不全的场景里才会明显体现出来。

总的来说，navi 适合那些天天泡在终端里、工具链又比较杂的工程师：把「查参数」这个动作内联到工作流里，省掉的是切换上下文的隐性成本。