黑客新闻终端 heartleo/hn-cli

hn

Hacker News 的终端客户端。

demo

功能

- 📰 帖子浏览器 —— Top、New、Best、Ask HN、Show HN，支持标签页切换
- 💬 评论树 —— 用 j/k 导航，折叠/展开，回复树懒加载
- 🌐 翻译 —— 按 t 翻译标题，按 T 翻译所有可见标题，或翻译选中的评论
- 🔄 软刷新 —— 刷新帖子或评论，无需重启
- 🎨 主题 —— hn、mocha、dracula、tokyo、nord、gruvbox
- ⚡ 渐进式加载 —— 先加载可见范围，滚动时再拉取更多内容

安装

Homebrew（macOS / Linux）：

$ brew install heartleo/tap/hn

winget（Windows）：

$ winget install heartleo.hn

curl（macOS / Linux）：

$ curl -fsSL https://raw.githubusercontent.com/heartleo/hn-cli/main/install.sh | sh

不需要 sudo —— 二进制文件会装到你的主目录下。安装目录按下面顺序取第一个已设置的值：

| 来源 | 取值 |
| HN_INSTALL_DIR | 原样使用 |
| XDG_BIN_HOME | 原样使用 |
| XDG_DATA_HOME | $XDG_DATA_HOME/../bin |
| （默认） | $HOME/.local/bin |

想装到别处：

$ curl -fsSL https://raw.githubusercontent.com/heartleo/hn-cli/main/install.sh | HN_INSTALL_DIR=~/bin sh

如果安装目录不在 $PATH 里，脚本会给出警告，并打印要加到 shell 配置档里的 export PATH=... 那一行。

脚本绝不会调用 sudo。想装到系统全局，你自己用 root 跑：

$ curl -fsSL https://raw.githubusercontent.com/heartleo/hn-cli/main/install.sh -o install.sh
$ sudo env HN_INSTALL_DIR=/usr/local/bin sh install.sh

预编译二进制 —— 从 GitHub Releases 下载

Go install（需要 Go 1.25+）：

$ go install github.com/heartleo/hn-cli/cmd/hn@latest

从源码构建：

$ git clone https://github.com/heartleo/hn-cli
$ cd hn
$ go build -o hn ./cmd/hn

Claude Code 插件

这个仓库还附带 hn，一个 Claude Code 插件，把 Hacker News 带进 Claude。

/plugin marketplace add heartleo/hn-cli
/plugin install hn@hn-cli

| 技能 | 作用 |
| hn-digest | 扫描首页——今日主题、热门讨论、行业分布 |

然后直接问：what's on HN today。用任何语言提问，摘要就用那种语言返回。详见插件 README。

摘要也会每天发布在 hndigest.heartleo.dev。

DeepSeek Harness 插件

针对 DeepSeek Harness 有 hacker-news，一个纯 ESM 插件，直接读取公开的 Hacker News API。它既不需要 HN API key，也不需要本地终端客户端。

从 npm 安装

已发布的包是 dsh-hacker-news。它也收录在 awesome-dsh-plugin 社区注册表中。DSH 配置档是 pnpm workspace 根，所以要保留 -w 参数：

dsh plugin --profile <name> add -w dsh-hacker-news

如果你的 npm 镜像还没索引最新版本，就对着公共 registry 执行安装：

$env:npm_config_registry = 'https://registry.npmjs.org/'
dsh plugin --profile <name> add -w dsh-hacker-news

启动或重启同一个配置档，然后确认组合后的配置里包含 dsh-hacker-news：

dsh --profile <name>
dsh --profile <name> --dump-config

从源码安装

这种形式跟随仓库的 main 分支，用于开发或试用未发布的改动：

dsh plugin --profile <name> add -w github:heartleo/hn-cli#path:/plugins/hacker-news

安装后，自然地提问即可，例如：what's popular on HN?、search HN for sqlite，或者 read HN item 49322107 and summarize the discussion。

| 工具 | 作用 |
| hn_stories | 排名信息流——top / new / best / ask / show / job |
| hn_item | 一条内容加上它的回复树，按阅读顺序排列 |
| hn_search | Algolia 搜索，按相关度或日期 |
| hn_user | Karma、账号年龄、简介、投稿数 |

配置见插件 README。

快速开始

$ hn # top stories
$ hn new # new stories
$ hn best # best stories

命令

浏览

browse demo

打开交互式 TUI。默认显示 Top stories；用 ←/→ 切换标签页。

$ hn # top stories (default)
$ hn top
$ hn new
$ hn best
$ hn ask
$ hn show

评论

comments demo

在任意故事上按 Enter 打开它的评论串。

- 用 ↑/↓ 或 k/j 导航
- 按 Enter 展开或折叠回复树
- 按 Space 折叠或展开选中的评论
- 按 C / E 折叠或展开全部
- 按 r 跳到根评论
- 按 R 软刷新
- 按 Esc 返回

Translation

通过任何兼容 OpenAI 的 chat completions API 翻译。设置 API key 见 Configuration。

t 翻译选中的故事标题（切换缓存翻译） T 批量翻译所有可见标题 t 翻译选中的评论（在评论视图中）

theme

$ hn theme # show current
$ hn theme nord # set globally

可选：hn · mocha · dracula · tokyo · nord · gruvbox

Keys

Story List

| Key | Action |
| Enter | Open comment thread |
| o | Open in browser |
| t | Translate selected title |
| T | Translate all visible titles |
| ← / → | Switch tab |
| r | Refresh |
| ? | Toggle help |
| q / Ctrl+C | Quit |

Comment Thread

| Key | Action |
| j / ↓ | Next comment |
| k / ↑ | Previous comment |
| gg | Back to top |
| r | Jump to root comment |
| Enter | Expand / collapse replies |
| Space | Fold / unfold selected comment |
| C / E | Fold / unfold all |
| t | Translate selected comment |
| R | Soft refresh |
| o | Open story in browser |
| Esc | Back to list |
| ? | Toggle help |
| Q / Ctrl+C | Quit |

Configuration

hn 读取 ~/.config/hn/config.json。工作目录下的 .env 文件也会自动加载；环境变量优先于配置文件。

Translation

| Variable | Default | Description |
| HN_TRANSLATE_API_URL | https://api.openai.com/v1 | API base URL |
| HN_TRANSLATE_API_KEY | — | API key |
| HN_TRANSLATE_MODEL | gpt-4o-mini | Model name |
| HN_TRANSLATE_LANG | Chinese | Target language |

.env 示例：

HN_TRANSLATE_API_KEY=sk-...
HN_TRANSLATE_LANG=Chinese

Theme

| Variable | Description |
| HN_THEME | Override theme without editing config |

~/.config/hn/config.json 示例：

{
"theme": "mocha",
"translate": {
"api_url": "https://api.openai.com/v1",
"api_key": "sk-...",
"model": "gpt-4o-mini",
"language": "Chinese"
}
}

参与贡献

非常欢迎提交 issue、反馈 bug、提出功能建议，也欢迎任何一般性意见：

- 🐛 反馈 bug
- 💡 提出功能建议

[!NOTE]
这个项目是我利用业余时间维护的，目前精力有限，没法认真审查外部 pull request。详情见 CONTRIBUTING.md。感谢理解！