navi
可交互搜索、填充并执行命令行速查表的工具,支持自建 .cheat 文件、参数动态建议、仓库导入和 shell 小组件。
navi 如何工作
navi 是交互式命令行速查工具,可搜索自己编写或导入的 .cheat 文件,为占位参数动态显示候选值,并执行最终命令。它使用模糊搜索组件提供选择界面,也能作为 shell 或 Tmux 小组件、别名及脚本工具使用。
速查表属于可执行内容
速查条目不是普通说明文本,可能包含删除、网络、权限、远程连接和部署命令;动态参数候选还可以运行中间子命令。导入第三方仓库前应审查全部文件,在普通用户和测试目录中执行,并确认最终替换后的完整命令。
Windows 需要明确 PowerShell
项目安装说明提示 Windows 某些安装方式需要在用户配置中设置 shell.command 为 powershell。Unix 风格速查表中的变量、引号和管道也未必可直接复用。团队应为目标 shell 维护独立条目,避免一份命令在不同平台产生不同副作用。
维护记录
本页于 2026-08-06 根据 navi 的交互式速查、动态参数、仓库导入、shell 小组件和 Windows PowerShell 配置说明复核。归档文件为 v2.24.0 Windows x64 GNU 压缩包。
保存到自己的网盘
打开网盘后可直接获取,也可以先保存到自己的网盘,方便换设备继续使用。
夸克网盘(无需提取码)
推荐将「navi」保存到该网盘
百度网盘
将「navi」保存到该网盘
navi Windows 命令速查表使用教程
navi 的便利来自把可执行命令保存在速查表中。先创建只读、无副作用的本地条目,确认 PowerShell 配置和预览流程,再考虑导入第三方仓库。
安装前准备
- 使用普通用户 PowerShell,并准备一个没有重要文件的测试目录。
- 明确 navi 使用的 shell,Windows 环境需要检查 shell.command 是否设为 powershell。
- 将第三方 .cheat 文件视为脚本代码,运行前检查命令、变量、管道和动态建议来源。
安装步骤
- 01
解压官方预编译包
将 Windows x64 GNU 压缩包完整解压到固定目录,核对版本后通过完整路径查看帮助。
- 02
配置命令与 shell
把程序目录加入用户 PATH,并在 navi 用户配置中明确 PowerShell,避免使用不兼容的默认 shell。
- 03
建立本地速查目录
创建自己的 .cheat 文件,只加入输出版本或列出目录等无副作用命令,先验证搜索、参数选择和预览。
快速上手
- 01
搜索本地条目
运行 navi,输入标签或说明筛选命令,确认界面显示的说明、命令模板和参数候选来自预期文件。
- 02
检查完整命令
填入虚构参数后逐字符检查最终命令,特别关注路径、引号、重定向、管道和删除或网络操作。
- 03
再导入可信仓库
备份本地速查表后导入维护来源明确的仓库,先审查新增 .cheat 文件,再逐条测试并决定是否启用自动更新。
使用建议
- 为高风险命令加醒目标记并要求手动输入关键参数,不要为删除或发布任务提供危险默认值。
- 动态参数建议本身可以运行子命令,应和最终命令一样接受代码审查。
- 自动更新可能在未复核时改变可执行内容,生产运维速查表应固定版本或自行维护。
故障排查与卸载方法
Windows 中命令无法运行或变量解析错误怎么办?
检查用户配置的 shell.command 是否为 powershell,并将速查表中的 Unix 引号、环境变量和管道语法改为 PowerShell 形式。
选中的命令不是预期版本怎么办?
查看 cheatsheet 搜索路径和导入仓库优先级,检查同名条目及自动更新记录;临时只启用本地目录定位来源。
- 移除程序和速查仓库从 PATH 中删除程序目录后移除可执行文件;用户配置、本地速查表和导入仓库应先备份,再按是否包含敏感命令决定清理方式。
常见问题
navi 会自动执行选中的命令吗?
navi 可浏览速查表、填充参数并执行命令,不同调用方式也可能先把命令放入 shell 供编辑。无论哪种方式,都应在执行前检查完整命令、变量替换和当前目录。
Windows 版本为什么提示 shell 配置错误?
官方安装说明特别提示部分 Windows 安装方式需要在用户配置中把 shell.command 设为 powershell。还应确认压缩包目标、终端和依赖的模糊搜索组件兼容。
可以直接导入网上的 cheatsheet 仓库吗?
不建议未经审查直接使用。速查表可以包含删除、下载、上传、权限和远程执行命令,动态参数还可能调用子命令。导入后应先离线阅读文件,并禁用自动更新直到确认来源可信。
下载时需要提取码吗?
夸克网盘无需提取码;百度网盘所需的四位提取码会直接显示在下载入口旁。