# @harshakatta/termnav 中文文档

规范地址：https://npmcn.com/package/%40harshakatta/termnav/

版本：1\.3\.1
npm 元数据更新时间：2026-07-29T04:29:50.588Z
中文译文更新时间：2026-11-17T12:49:11.868Z
软件包许可：ISC

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40harshakatta/termnav
原文对照：https://npmcn.com/package/%40harshakatta/termnav/?lang=original
项目主页：https://github.com/Harsha754-ml/termnav#readme
源码仓库：https://github.com/Harsha754-ml/termnav

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：30.5 kB，10 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=16\.0\.0
- 运行依赖：0 个
- 首次发布：2026-06-01T17:05:03.891Z
- 最新版本发布：2026-07-29T04:29:50.435Z
- 近 30 天下载量：7095（2026-10-18 至 2026-11-16，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

Windows PowerShell 交互式终端目录导航

## 安装

```sh
npm install @harshakatta/termnav
```

也可以使用：`pnpm add @harshakatta/termnav`、`yarn add @harshakatta/termnav`、`bun add @harshakatta/termnav`

## README

# 术语Nav

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

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

## 特征

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

## 安装

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

```powershell
npm install -g @harshakatta/termnav
```

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

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

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

## 使用量

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

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

```powershell
tn C:\code\myapp
```

### 选项 :

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

### 控件 :

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

## 常见问题

### @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 和提交记录判断。

