@harshakatta/termnav

中文文档
1.3.1发布于 2026/07/29ISCCommonJS零依赖近 30 天下载 7095

Windows PowerShell 交互式终端目录导航

中文使用文档
文档目录5 节
  1. 特征
  2. 安装
  3. 使用量
  4. 选项 :
  5. 控件 :

术语Nav

术语Nav 是一个快速零依赖性交互终端目录导航器,用于 Windows 电源壳。 。 。 .

它提供一个有鼠标支持的 sleek,最小化交互UI 和一个嵌入式文件夹树,可以直接从您的终端中无缝地穿行目录.

特征

  • 支持编码美学:清洁,最小化的UI有严格的Unicode几何,微妙的青色口音,并有持久的状态栏.
  • 即时启动:"入去"哲学. 直接掉入您的全局 npm 路径, 以便立即执行, 而不需要 PowerShell 配置文件修改或终端重新启动 .
  • 智能视图端口滚动:不费力地处理大目录(如 node_modules 或 root 驱动器),通过动态限制渲染到您的终端可见高.
  • 强力错误处理:安全地处理拒绝权限的文件夹而不会崩溃UI.
  • 零密度自动更新:运行一个无声,脱落的背景进程来检查更新,将启动时间严格保持在0ms.
  • 完整的鼠标支持: 仅使用鼠标导航、 扩展、 崩溃和选择目录 。 以SGR鼠标模式所建,用于支持超宽终端.

安装

通过 npm 在全球安装软件包 :

npm install -g @harshakatta/termnav

从 GitHub Actions 发布版本, 需要存储在名为 npm 的寄存器密钥中的 npm 自动化令牌 NODE_AUTH_TOKEN。 。 。 .

注:TermNav目前是专门为Windows PowerShell设计的. 不支持非窗口系统.

就这样! 安装器自动配置 tn 命令。 你可以马上开始使用它.

使用量

简单类型 tn 在你的终端发射导航器.

您也可以从特定目录中开始 :

tn C:\code\myapp

选项 :

  • tn [directory] — 在指定的目录中开始
  • tn --version 或者说 tn -v — 显示版本编号
  • tn --help 或者说 tn -h — 显示帮助消息

控件 :

  • 使用 上下 要通过列表移动的箭头键.
  • 使用 左边/右边 用于扩展或崩溃文件夹的箭头键.
  • 新闻 / 打开快速文件搜索,键入过滤器,然后使用 输入 打开目录.
  • 新闻 ~ (Tilde) 立即跳回您的主目录.
  • 新闻 缩写+R 以刷新当前目录(清除 stale 缓存).
  • 使用 鼠标 以单击项目并扩展文件夹。 在列表外单击退出 .
  • 新闻 输入 打开目录或选择文件路径.
  • 新闻 q, (中文(简体) ), Q,或 逃脱 以不更改目录的方式清洁退出.

版本与发布记录

@harshakatta/termnav 共发布 30 个版本,首次发布于 2026/06/02;过去 12 个月发布了 30 个版本。

版本发布日期距今
1.3.1latest2026/07/293 个月前
1.3.02026/07/293 个月前
1.2.72026/07/014 个月前
1.2.62026/06/125 个月前
1.2.52026/06/125 个月前
1.2.42026/06/125 个月前

关于 @harshakatta/termnav 的常见问题

@harshakatta/termnav 是什么?

Windows PowerShell 交互式终端目录导航

如何安装 @harshakatta/termnav?

在项目目录运行 npm install @harshakatta/termnav,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 termnav-cli,可以用 npx termnav-cli 直接运行。

@harshakatta/termnav 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/harshakatta__termnav 是否存在。

@harshakatta/termnav 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@harshakatta/termnav 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=16.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@harshakatta/termnav 可以商用吗?

@harshakatta/termnav 使用 ISC 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@harshakatta/termnav 的下载量有多少?

根据 npm 官方下载统计,@harshakatta/termnav 在 2026/10/18 – 2026/11/16 这 30 天内被下载 7,095 次,日均约 237 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@harshakatta/termnav 还在维护吗?

最新版本 1.3.1 发布于 2026/07/29(3 个月前);至今共发布 30 个版本,其中过去 12 个月发布了 30 个;首次发布于 2026/06/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。