# @erykkozyra/terminalhinter 中文文档

规范地址：https://npmcn.com/package/%40erykkozyra/terminalhinter/

版本：1\.2\.2
npm 元数据更新时间：2026-11-13T07:52:37.740Z
中文译文更新时间：2026-11-14T16:27:51.084Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40erykkozyra/terminalhinter
原文对照：https://npmcn.com/package/%40erykkozyra/terminalhinter/?lang=original
项目主页：https://erykkozyra.github.io/terminalhinter/
源码仓库：https://github.com/ErykKozyra/terminalhinter

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

- 包体积（解压后）：20.2 kB，4 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-11-04T00:12:39.302Z
- 最新版本发布：2026-11-13T07:52:37.251Z
- 近 30 天下载量：1980（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

Zsh, bash, fish and PowerShell 的开源终端自动完成 : 文件夹、 git 分支、 npm 脚本和 700+ CLI 等的下拉

## 安装

```sh
npm install @erykkozyra/terminalhinter
```

也可以使用：`pnpm add @erykkozyra/terminalhinter`、`yarn add @erykkozyra/terminalhinter`、`bun add @erykkozyra/terminalhinter`

## README

# 终端时钟

[![npm](https://img.shields.io/npm/v/%40erykkozyra%2Fterminalhinter?color=2F5FD0)](https://www.npmjs.com/package/@erykkozyra/terminalhinter) [![license](https://img.shields.io/badge/license-MIT-2F5FD0)](https://npmcn.com/package/%40erykkozyra/terminalhinter/LICENSE)

**类型 三字母。 得到整个指挥部.** Zsh、bash、fish和PowerShell 的开源自动完成 macOS, Linux 和 Windows (英语). 它完成700+命令行工具 当你键入命令失败时, 将修正交给你, 并标出危险的红色.

![terminalhinter completing a branch, fixing a typo and marking --force red](https://npmcn.com/package/%40erykkozyra/terminalhinter/docs/demo.gif)

**[观看每个功能播放,并在浏览器中尝试](https://erykkozyra.github.io/terminalhinter/)**没有安装 需要帮助.

## 安装

```bash
npm i -g @erykkozyra/terminalhinter
thint init
```

然后打开一个新的终端标签和类型 `git` 或者说 `cd`。 。 。 . `thint init` 找到你的贝壳 把它们全部装起来 每个配置的备份.

## 你为什么会喜欢

-   **一个失败的命令又被修复了.** 在打字或缺失上游后,空行会提供固定和 Tab 拿着.
-   **红色之前你强迫-推.** 删除或覆盖的条目为红色并说原因. Ctrl+G 解释每个词 连线.
-   **它读到你的项目.** 您的脚本, Makefile 目标,分支 与他们的最后一次承诺的年龄 在您的端口上进行处理.
-   **输入文件夹 .** 少数压力将你带入一个项目深处,名单会一直打开.
-   **没有允许,没有注册.** 没有访问权限, 菜单栏里没有应用程序, 没有账户, 没有 遥测.

是来自Fig还是Kiro CLI, 它的自动完成在3.0? `thint migrate` 让你在一个命令中移动.

## 目录

-   [它运行的地方](https://npmcn.com/package/%40erykkozyra/terminalhinter/#readme-where-it-runs)
-   [做的一切都一样](https://npmcn.com/package/%40erykkozyra/terminalhinter/#readme-everything-it-does)
-   [密钥](https://npmcn.com/package/%40erykkozyra/terminalhinter/#readme-keys) 财务报告和审定财务报表 [命令](https://npmcn.com/package/%40erykkozyra/terminalhinter/#readme-commands)
-   [来自基罗CLI或Fig](https://npmcn.com/package/%40erykkozyra/terminalhinter/#readme-coming-from-kiro-cli-or-fig)
-   [你自己的建议](https://npmcn.com/package/%40erykkozyra/terminalhinter/#readme-your-own-suggestions) 财务报告和审定财务报表 [片断](https://npmcn.com/package/%40erykkozyra/terminalhinter/#readme-snippets)
-   [窗口](https://npmcn.com/package/%40erykkozyra/terminalhinter/#readme-windows) 财务报告和审定财务报表 [VS 代码](https://npmcn.com/package/%40erykkozyra/terminalhinter/#readme-vs-code)
-   [更新和注销](https://npmcn.com/package/%40erykkozyra/terminalhinter/#readme-updating-and-uninstalling)
-   [解决问题](https://npmcn.com/package/%40erykkozyra/terminalhinter/#readme-troubleshooting)
-   [东西存放的地方,什么上线](https://npmcn.com/package/%40erykkozyra/terminalhinter/#readme-where-things-are-kept)

## 它运行的地方

| 系统 | 贝壳 |
| --- | --- |
| macOS, Linux | zsh,出击,出击,出击,出击 PowerShell 7 |
| 窗口 | PowerShell 7, Windows PowerShell 5.1, Git Bash; cmd 由手动开始(`thint -s cmd`(中文(简体) ) |

任何终端应用作品:iTerm2,终端.app,Ghostty,WezTerm,Kitty,Alacritty,VS代码,Cursor,Windows终端, 和Tmux或屏幕在他们内部。 zsh和bash on macOS 和 Linux 的时间最长;鱼和Windows是 新来的,所以如果有东西看那边, [打开一个问题](https://github.com/ErykKozyra/terminalhinter/issues)。 。 。 . nushell和xonsh来自上游项目,没有经过测试.

## 做的一切都一样

### 当出事时

-   **它为刚刚失败的指令提供了修正.** 类型( E)`gti` → `git`),缺少上游分支,a 分支或脚本,带有近名,需要文件夹 `-p`,一个被带走的港口。 Tab 把它放在线上; 没有什么是自己运行.
-   **Ctrl+G 在运行前解释一行**每一个字,用它的意思, 通过管道, `&&`,方向调整和 `sudo`,对删除或覆盖事物的部分发出警告.
-   **危险条目标记为红色** 并说为什么: `--force`, (中文(简体) ), `reset --hard`, (中文(简体) ), `rm -r`目标标记 `[prod]`, (中文(简体) ), 调用 ssh 主机 `PROD`。 。 。 .

### 你的项目

-   **您的任务 :** 使用其 `##` 描述和章节, 仅是配方, 任务文件, 插件 编写服务、 mise 和 deno 任务、 package.json 脚本、 turbo 任务、 工作空间包 `--filter`。 。 。 .
-   **带有上下文 :** 每支树枝旁边的末行的年龄和消息, 后反转 `git reset`,你的别名会像他们后面的命令一样完整.
-   **端口 :** `kill` 起始于在端口上监听的进程,并带有其文件夹(`:3000 next dev · ~/Dev/shop`) (中文(简体) ).
-   **软件包版本 :** `npm i react@` 列出标签和最新发布(pnpm、纱线和包子也).
-   **云居语:** 每个 `aws` 以命令和选项服务,以及 `gcloud` 组合和命令。 您的 S3 密码 桶,IAM角色和简介来自你拥有的aws CLI,有你自己的登录.
-   **ku:** 上下文,命名空间 `-n`,以及舱名,部署和其余的 组合,用于组合 `--context` 财务报告和审定财务报表 `-n` 在线上。 之后 `kubectl config use-context` 下一个列表是新的 组合的.
-   **你跑到这里的是:** 输入第一个单词会带回您在这个文件夹中运行的全部命令, 以及那些命令 你跑到其他地方 在同一个仓库。 看起来像持有密码或信使的行从不存储.

### 绕来绕去

-   **输入文件夹 .** 清单与内在内容保持开放 `↪` 条目运行命令 对. `cd` 也可以通过您的书签和正氧化物从任何地方找到文件夹.
-   **在你承诺之前先看一个文件夹.** 它将文件夹放入线上并列出里面的内容; QQ 继续往上 行走后直接输入突出显示的文件夹 .

### 清单本身

-   **它能学会你用什么**,和 Shift+上/ Shift+ 组合键 把名单按顺序排列.
-   **字母顺序足够了.** `chkt` 发现 `checkout`。 。 。 .
-   **在空格之后, 空格没有选择**,因此 Enter 只运行命令。 一个字你打满了,没有 条目从输入的运行开始.
-   **输入可以一次运行 :** `thint config set enterRuns true` 让 Enter 接受条目并运行行.

![The list after typing pnpm d](https://npmcn.com/package/%40erykkozyra/terminalhinter/docs/preview.png)

## 密钥

| 密钥 | 它会做什么 |
| --- | --- |
| 输入 | 接受、走入文件夹或运行命令 `↪` |
| → | 在行尾突出显示的文件夹上: 查看里面, 回上去 |
| 标签 | 接受所选条目 |
| ↑ | 移动选中区域; 没有选择的%%%\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\ |
| 移动QQQQ | 移动列表中选定的条目 |
| 英格兰 | 隐藏列表直到再次输入 |
| 缩写+ 空间 | 再来一次 |
| Ctrl+G 数据 | 每一句话都做什么 |
| 在空行上设置标签 | 在命令失败后, 接受指定的修复 |

在Mac上,Ctrl是控制键 (QQ),而不是命令.

## 图标

| 命令 | 它会做什么 |
| --- | --- |
| `thint init` | 引导设置 |
| `thint theme` | 选择一个主题: 薄、 浅、 淡、 淡或地拉 |
| `thint config` | 显示或更改设置( E)[所有人,他们](https://npmcn.com/package/%40erykkozyra/terminalhinter/docs/configuration.md)(中文(简体) ) |
| `thint bookmark add` | 书签文件夹,所以 `cd` 随时随地提供 |
| `thint specs new` | 启动您对命令的建议 |
| `thint order reset` | 忘了你和Shift QQ 设定的命令 |
| `thint snippets new` | 启动您的片段: 有字段要填写的命令 |
| `thint migrate` | 从Kiro CLI、Amazon Q 或 Fig 移动过来 |
| `thint update` | 安装最新版本 |
| `thint doctor` | 检查安装,告诉你如何修复 |
| `thint debug keys` | 记录您的终端发送的密钥稀释用途 |

## 来自基罗CLI或Fig

Kiro CLI 3.0 放弃了自动完成,而Fig也不见了. 终端发报器在本地和 没有账户. `thint migrate` 从您 shell 文件中取出 KIRO CLI、 Amazon Q 或 Fig 线条( 保留 ) 每个文件的复制件),以及您自己在 `~/.fig/autocomplete/build` 可以装入原样.

## 你自己的建议

对于内部脚本和工具,请输入一个 YAML 文件 `~/.config/terminalhinter/specs`数字 :

```yaml
name: deploy
subcommands:
  - name: staging
    args: { name: app, suggestions: [web, admin] }
  - name: logs
    args: { name: service, script: "ls services" } # every line of the output is a suggestion
options:
  - name: [--force, -f]
    description: Skip the checks
```

`thint specs check` 指出错误。 一个被损坏的文件被跳过,其余的继续工作.

## 片断

您经常输入的有要填入的字段的图标 `~/.config/terminalhinter/snippets.yaml` (单位:千美元)`thint snippets new` 启动文件 :

```yaml
- name: release
  command: "git tag v{{version}} && git push --tags"
```

键入名称,填入字段,完成的指令上线地.

## 窗口

运行 `npm i -g @erykkozyra/terminalhinter` 财务报告和审定财务报表 `thint init` 在"PowerShell 7"或"Windows PowerShell"中. 设置 并输入 `~/.bashrc` 为了吉特·巴什.

Windows PowerShell 5.1会随着脚本的关闭而来,因此它会跳过它的剖面,列表从不从那里开始. `thint init` 仅允许您的用户使用脚本 (单位:千美元)`Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`从一开始 PowerShell 7就有什么 若为 `thint` 或者说 `npm` 本身不会在 Windows PowerShell 中以同样的理由开始,使用 `thint.cmd init` 财务报告和审定财务报表 `npm.cmd`。 。 。 .

cmd 没有启动文件可以将行放入其中, 因此您用 `thint -s cmd`。 。 。 .

## VS 代码

列表在这些设置中看起来最好:

```json
"terminal.integrated.lineHeight": 1.3,
"terminal.integrated.minimumContrastRatio": 1,
"terminal.integrated.gpuAcceleration": "on"
```

`minimumContrastRatio: 1` 停止更改列表的颜色。 任意一空间字体有效 .

## 更新和注销

**更新.** `thint update`。一个新的标签会告诉你,当新版本出来时; `thint config set updateCheck false` 关掉它。 更新方式 `npm i -g @erykkozyra/terminalhinter@latest` 工作也一样:下个新标签会把它捡起来.

**没有.** 您标签中的列表从不取决于您的节点版本, 因为瘦子带有自己的运行时间 。 只有 `thint` 命令您输入的是全局 npm 软件包: 在您切换默认节点后, 运行 `npm i -g @erykkozyra/terminalhinter` 再说一遍,这个版本也有命令.

**从源** (需要"节点"18+和"出""出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出""出"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

```bash
git clone https://github.com/ErykKozyra/terminalhinter.git
cd terminalhinter
./scripts/install-from-source.sh
```

单个二进制 `~/.local/bin/thint` 这根本不取决于节点.

**完全没有.**

```bash
thint uninstall
npm rm -g @erykkozyra/terminalhinter
```

`thint uninstall` 从每个 shell 配置中取出启动行并删除瘦文件. `thint init --remove` 只取出启动行.

## 解决问题

开始 `thint doctor`它检查安装、每个外壳的起动线以及您的配置,并说如何 修复它找到的东西.

**新标签没有列表 .** 启动线不见了 或者有东西阻止了它们 运行 `thint init` ;它取代了旧行,而不是 添加了第二个副本. `thint -c` 告诉你当前外壳是否在终端中运行 .

**Windows PowerShell:"运行的脚本在此系统中被禁用".** 脚本默认在 Windows PowerShell 5.1 中关闭,它同时停止 `thint` (没有) `thint.ps1`)和简介. 运行 `thint.cmd init` 并说是 当它要求允许脚本,或运行 `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` 你自己来 您公司制定的政策胜过它; 然后使用 PowerShell 7或"吉特·巴什".

**标签以“ 无法启动 ” 打开 .** 薄片失败了, 给你留下了平板外壳, 而不是关闭标签 。 信息说为什么; `thint reinit` 无包装 瘦子的文件又被修复了 大部分都是这样.

**在用 pnpm 更新后,新标签仍然启动旧版本.** 运行 `thint reinit` 一次 一次吗 仅从1.1.3及更年长的 `pnpm add -g` 手持; `thint update` 为了你.

**缩写+ 空格无所事事,或者切换键盘布局.** macOS 使用控制+ 当您有多个输入源时可切换空间: 关闭系统中的快捷键 设置QQ键盘QQ键盘快捷键QQ输入源. 在另一个终端, `thint debug keys` 记录它是什么 发送; 将文件附加到一个问题上.

**接受我贝壳的灰色建议 而不是查看文件夹.** zsh-自摄取,鱼和PowerShell在光标后显示自己的灰色猜测. 薄薄的只需要... 在一个 在行尾突出显示文件夹; 要将 ~ 总是保留在您的外壳上, 运行 `thint config set folderArrows false`。 。 。 .

**输入运行命令而不是取入.** 在一个空格没有选择之后, Enter 运行您输入的内容 。 按 QQ 或 Tab 输入 . `thint config set enterRuns true` 使 Enter 立即接受条目并运行行.

**列表的颜色在 VS 代码中被冲出 .** 设定 `"terminal.integrated.minimumContrastRatio": 1`; VS 代码 否则会改变它绘制的颜色 .

**新的标签打开缓慢, 或者在我的配置中的东西运行两次.** 薄点在内部开始一个新鲜的外壳,所以起动线上方的任何东西会负载两次. `thint doctor` 计数这些 线条; `thint init` 将启动行移回顶部.

**老基罗CLI,亚马逊Q或Fig线仍然在我的外壳配置中.** `thint migrate` 把它们取出来,并保存每个文件的副本.

**还有一件事.** 例如, 在登录时手动启动标签 `thint -s zsh -V`,做错事,并附加 `~/.local/share/terminalhinter/log/terminalhinter.log` (关于窗口) `~\.terminalhinter\log\terminalhinter.log`改为: [问题](https://github.com/ErykKozyra/terminalhinter/issues),其中输出 `thint doctor`。 。 。 .

## 保存着的东西

| 什麽 | 何处 |
| --- | --- |
| 设置 | `~/.terminalhinterrc` 或者说 `~/.config/terminalhinter/rc.toml` (单位:千美元)[所有设置](https://npmcn.com/package/%40erykkozyra/terminalhinter/docs/configuration.md)(中文(简体) ) |
| 您的规格和片段 | `~/.config/terminalhinter/specs/`, (中文(简体) ), `~/.config/terminalhinter/snippets.yaml` |
| 它学到了什么,日志,自己的文件 | `~/.local/share/terminalhinter` (单位:千美元)`~/.terminalhinter` 在Windows和旧安装上) |
| 启动线 | 顶端 `~/.zshrc`, (中文(简体) ), `~/.bashrc`, (中文(简体) ), `config.fish` 或您的动力壳 `$PROFILE`间 `# >>> terminalhinter >>>` 财务报告和审定财务报表 `# <<< terminalhinter <<<` |

没有遥测。 你所输入的和所学到的都留在这些文件夹里。 上线只为了抬头看 软件包:一天一次,它要求npm提供它自己最新的版本编号(`updateCheck = false` 关掉它,当你 键入软件包名称或 `react@` 它要求npm注册和npms.io包搜索匹配,只发送该词. 一些列表来自您安装的工具,运行在您的机器上: git分支, `docker ps`, (中文(简体) ), `kubectl get pods`, (中文(简体) ), `aws s3 ls` 给桶名。 仅能达到工具本身所达到的,有你自己的登录.

## 贷项

一个叉子 [微软/微软](https://github.com/microsoft/inshellisense),带有命令规格 [有图片/自动完成](https://github.com/withfig/autocomplete). . . . 没有 隶属于微软,亚马逊或Fig.

由艾里克·克兹拉(英语:Eryk Kozyra)所制造. X新闻和新节目: [@ erykkozyradev (英语)](https://x.com/erykkozyradev)。 。 。 .

[MIT 许可证](https://npmcn.com/package/%40erykkozyra/terminalhinter/LICENSE)

## 常见问题

### @erykkozyra/terminalhinter 是什么？

Zsh, bash, fish and PowerShell 的开源终端自动完成 : 文件夹、 git 分支、 npm 脚本和 700\+ CLI 等的下拉

### 如何安装 @erykkozyra/terminalhinter？

在项目目录运行 npm install @erykkozyra/terminalhinter，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 thint、terminalhinter，可以用 npx thint 直接运行。

### @erykkozyra/terminalhinter 支持 TypeScript 吗？

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

### @erykkozyra/terminalhinter 可以商用吗？

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

### @erykkozyra/terminalhinter 的下载量有多少？

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

### @erykkozyra/terminalhinter 还在维护吗？

最新版本 1\.2\.2 发布于 2026/11/13（1 天前）；至今共发布 12 个版本，其中过去 12 个月发布了 12 个；首次发布于 2026/11/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。