预编译的二进制文件没有任何依赖。通过 npm 安装（或修改代码）需要 Bun 1.2 或更新版本。
独立二进制文件（推荐）
curl -fsSL https://raw.githubusercontent.com/ahmd-sh/hntui/main/install.sh | sh
该命令会将一个自包含的二进制文件安装到 ~/.local/bin。你也可以直接从 releases 页面 下载适合你平台的二进制文件。二进制文件覆盖 macOS（Apple Silicon）和 Linux（x64、arm64）——在 Intel Mac 上，请使用下面的 Bun 安装方式。
bun add -g @ahmd-sh/hntui
或者不安装直接运行一次：
bunx @ahmd-sh/hntui
运行
hntui
按 q（或 Ctrl-C）退出。
hntui update
检查最新版本，对于二进制安装方式，会原地替换自身完成更新。Bun 安装方式则使用 bun add -g @ahmd-sh/hntui 来更新（hntui update 会提示你这一点）。当有更新的版本发布时，状态栏会显示一条低调的提示。hntui --version 会打印已安装的版本。
故事列表
| 按键 | 操作 |
|---|---|
j / ↓、k / ↑ | 移动光标 |
gg、G | 跳转到第一条或最后一条 |
Ctrl-D、Ctrl-U、PgDown、PgUp | 滚动半页 |
c、Enter | 打开故事并阅读评论 |
h / ←、l / → | 上一个或下一个标签页 |
Tab、Shift-Tab | 循环切换标签页 |
1 到 6 | 跳转到特定分类 |
S | 跳转到收藏（Saved）列表 |
s | 收藏或取消收藏高亮的帖子 |
o | 在浏览器中打开故事链接 |
r | 刷新当前信息流 |
t | 切换主题 |
q、Ctrl-C | 退出 |
故事详情（评论）
| 按键 | 操作 |
|---|---|
j / ↓、k / ↑ | 移动评论光标 |
gg、G | 跳转到第一条或最后一条评论 |
Ctrl-D、Ctrl-U、PgDown、PgUp | 滚动半页 |
Space | 折叠或展开当前子讨论串 |
Enter | 打开当前评论的链接弹窗 |
s | 收藏或取消收藏该故事 |
o | 打开故事链接 |
Esc、Backspace、h / ← | 返回列表 |
t | 切换主题 |
q | 退出 |
链接弹窗
| 按键 | 操作 |
|---|---|
j、k、↑、↓ | 移动 |
gg、G | 第一个或最后一个链接 |
o、Enter | 打开高亮的链接 |
Esc、Backspace | 关闭弹窗 |
右键菜单
| 按键 | 操作 |
|---|---|
j / ↓、k / ↑ | 移动 |
Enter | 激活 |
Esc、Backspace | 关闭 |
鼠标
键盘能完成的大部分操作，鼠标同样可以完成。
由于应用会捕获鼠标事件，终端正常的点击拖拽选择文本会被拦截。要以常规方式选择文本：
按 t 切换主题。深色主题以黑色为主，配橙色点缀。浅色主题忠实还原 news.ycombinator.com 的风格：白色背景、橙色顶栏、熟悉的米色行高亮，以及 HN 经典的灰色署名文字。
在任何故事上按 s 即可收藏。已收藏的帖子标题旁会显示一个小星星，并出现在标签栏右侧的收藏（Saved）标签页中。收藏列表以一个小 JSON 文件的形式持久保存在 ~/.config/hntui/saved.json，跨会话保留。（应用早期 hackernuis 时期的配置会在首次运行时自动迁移。）再按一次 s 即可将帖子从列表中移除。