neohtop-cli：把 neohtop 的全部能力搬进终端——Go …

一、neohtop-cli 是什么

（一）它要解决什么

neohtop-cli 由 Abdenasser 开发，仓库全名 Abdenasser/neohtop-cli，目前约 93 Star、5 个 fork、4 个未关闭 issue，采用 MIT 协议，语言是 Go，创建于 2026 年 3 月。它要解决的是「想在终端里也有 neohtop 那种体验」——很多场景你人就在 SSH 里、或就想要一个不占桌面的轻量监视器，这时候图形版用不上，而传统 htop 又缺了火花线、主题和 JSON 这类现代便利。neohtop-cli 把桌面版的实时可视化与交互，原样搬进一个纯终端 TUI。

（二）技术栈：Go + Charm

它用纯 Go 写成，直接调用各系统原生 API 取指标——没有 FFI、没有外部运行时依赖。UI 层建立在 Charm 生态之上：Bubble Tea v2 做 TUI 框架、Lip Gloss v2 做样式。因为纯 Go 且原生取数，最终是一个单文件二进制，macOS / Linux / Windows 通吃，拷过去就能跑。架构上清晰分成两层：上层 Go TUI（状态栏、工具栏、进程表、火花线、盲文进度条、各类浮层），下层原生 Go Monitor（按系统分 process_darwin.go / system_linux.go 等）。

（三）和桌面版的关系

二者共享同一套能力，但形态互补。README 专门列了对比表：桌面版 12 套主题，CLI 版给到 15 套；而进程树视图、JSON 脚本化、运行在终端、单文件分发，这几项是 CLI 版独有。简单说，桌面版适合本机窗口盯机，CLI 版适合远程、脚本与极简环境——你甚至可以两个都装，各取所需。

二、主要功能特点

（一）实时可视化监控

CLI 版的可视化不输桌面：CPU 每核火花线、内存、磁盘 I/O、网络统计，都用盲文点阵（braille-dot）画出来，在纯文本终端里也有「图形感」。下图是官方 demo，能看到 TUI 里 CPU 占用、内存条与进程表同屏跳动。

（二）正则搜索与进程管理

搜索支持完整正则，命中处黄色高亮：chrome 匹配名字含 chrome 的进程，^sys 匹配以 sys 开头的，\.log$ 匹配命令以 .log 结尾的，node|deno 匹配两者之一，1234 直接定位 PID。进程管理也很全：查看详情、kill（带确认）、钉选到顶部、切换树视图。键位上 s / / 搜、Space 暂停、i/Enter 看详情、k/x 杀、p 钉、T 树视图、t 换主题、r 切刷新率，鼠标也支持。

（三）15 套主题与 JSON 输出

主题按 t 打开选择器，实时预览色板，共 15 套：Charm（默认）、Catppuccin Mocha/Latte、Dracula、Tokyo Night、Gruvbox Dark、Nord、One Dark、Rosé Pine、Synthwave、Solarized Dark、Monokai Pro、High Contrast、Green Terminal、Amber Terminal。更实用的是 –json：输出一份系统统计与全部进程的快照，可直接喂给 jq 做脚本或看板，这是桌面版没有的能力。配置持久化在 ~/.config/neohtop-cli/config.json，可调列、刷新率（默认 1s，循环 1→2→3→5→0.5s）与主题。

举个实用组合：你一边跑训练、一边想盯 GPU 进程的波动，直接 neohtop-cli 进去，^python 过滤出训练进程，p 钉住，再按 T 切成树视图看父子关系——整个过程不离开终端、不碰鼠标。等要出报表时，–json 抓一份快照给 jq，内存占用、每核 CPU 一目了然。这种「看得爽」和「能导出」兼顾，正是它比裸 htop 更适合现代工作流的地方。

三、如何安装与运行

（一）一行装好

最省事的是 npm 全局安装，一条命令搞定：

npm install -g neohtop-cli

装完直接 neohtop-cli 启动 TUI，neohtop-cli –json 输出一次 JSON 快照，neohtop-cli –help 看全部参数；TUI 内按 ? 看完整键位。

（二）预编译二进制

不想碰 npm，可以从 Releases 拉预编译包：macOS 有 arm64 / amd64 的 tar.gz，Linux 有 x86_64 / arm64，Windows 是 zip（解压后把目录加进 PATH）。各平台都有对应的一行 curl -LO + 解包 + mv 到 /usr/local/bin 的示例，适合没有 Node 的环境。

（三）从源码构建

需要 Go 1.25+，macOS 上因 CGo 还要一个 C 编译器。构建很简单：

git clone https://github.com/Abdenasser/neohtop-cli.git
cd neohtop-cli
make build
make install          # 可选，复制到 /usr/local/bin/

四、官方地址与获取方式

• 代码仓库：github.com/Abdenasser/neohtop-cli
• npm 包：npmjs.com/package/neohtop-cli
• 下载：GitHub Releases 提供 macOS / Linux / Windows 预编译单文件
• 桌面版：同作者 neohtop（Rust + Tauri + Svelte）

五、与同类方案对比

（一）对比 htop / btop

htop 是终端老牌，btop 也好看但仍是 ASCII 画图。neohtop-cli 的优势在「现代 TUI 体验」：盲文火花线、15 套主题、正则高亮搜索、进程树，以及独有的 –json。代价是要装一个 Go 二进制（或通过 npm）——但它本就是单文件、零运行时依赖，体积与启动都不比它们差。如果你要的是「终端里最潮的监视器 + 能脚本化」，neohtop-cli 更合拍。

（二）对比桌面版 neohtop

能力基本同源，但 CLI 版多了进程树、JSON 输出与单文件分发，主题还多 3 套；桌面版胜在原生窗口与鼠标交互的自然度。二者不是替代关系：本地桌面开窗口用 neohtop，远程或脚本用 neohtop-cli。

（三）定位差异

一句话：htop/btop 是「终端里的监视器」，neohtop-cli 是「带现代 TUI 与 JSON 的终端监视器」，neohtop 是「原生桌面窗口版」。CLI 版补齐了终端场景下的可视化与脚本化短板。

六、核心机制深度解析

从按键到屏幕，数据走的是「原生取数 → TUI 渲染 → 交互回写」一圈：

底层 Monitor 按操作系统分成 Darwin / Linux / Windows 三套文件，直接读本系统 API，保证无 FFI、无外部依赖；上层 TUI 由 Bubble Tea v2 驱动一个 update 循环，Lip Gloss v2 负责把 CPU 占用、内存画成盲文点阵与火花线。因为全程纯 Go，最终二进制自包含——这也是它能在三平台都给「单文件」的原因。–json 则是同一份 model 状态的一次快照导出，天然适合接 jq。

七、实用技巧

• 正则搜索抓进程：^chrome、name|pid、\.log$ 比手翻列表快得多，命中处黄色高亮。
• 接 jq 做脚本：neohtop-cli –json | jq ‘.processes[] | {name, cpu: .cpu_usage}’ | sort_by(.cpu) | reverse[:10] 直接拿 CPU 前十。
• watch 模式做看板：watch -n2 ‘neohtop-cli –json | jq .system.cpu_usage_per_core’ 周期性看每核占用。
• 换主题：TUI 里按 t 实时预览 15 套，挑顺眼的；想固定就写进 config.json 的 theme 字段。
• 钉住关键进程：p 把数据库、主服务钉到顶部，一眼可见存活。
• 调刷新率：r 在 1/2/3/5/0.5s 间循环，低配机用慢一点更省。

还有一个少有人提但很实用的点：因为 TUI 是 Bubble Tea 驱动的状态循环，它在高延迟的远程终端里也比很多靠异步刷屏的工具稳。配合 –json 与 watch，你既能交互式盯、也能非交互式采，两种用法互不打架。对既要「现场看」又要「留数据」的运维场景，这套组合基本一步到位。

八、最新更新动态

• 正式发布：作为 neohtop 的终端 companion 推出，README 用醒目位置宣布「NeoHtop CLI is here!」。
• 多平台单文件：macOS / Linux / Windows 预编译包齐备，并上架 npm 全局安装。
• 15 套主题：主题数已多于桌面版（12 套），含 Catppuccin、Dracula、Tokyo Night 等热门配色。
• 早期迭代：仓库创建于 2026 年 3 月，issue 数保持在个位数，整体处于刚起步、快速补能力的阶段。

九、常见问题 FAQ

十、总结

neohtop-cli 把「桌面级的好看与好用」带进了终端，又用 –json 补上了脚本化这块 htop 类工具长期缺的拼图。它纯 Go、单文件、零依赖，三平台通吃，装一条命令、跑一条命令。对常在终端里盯机、又想要火花线与主题的人，它是 htop 之外一个更现代的选择；对做监控看板的人，它的 JSON 输出更是直接好用。配合同款桌面版，neohtop 这套「窗口 + 终端」组合已经相当完整。

也要说清它的阶段：仓库刚创建于 2026 年 3 月，issue 数还是个位数，属于快速补能力的早期项目。主题、键位、JSON 输出都已可用，但自定义配色、插件机制等更进阶的玩法可能还要等后续。把它当「日常够用、且会持续变好」的终端监视器来看最合适——现在装一条命令就能用，将来升级也基本是无感。对于想摆脱裸 htop 又不想引入重运行时的终端用户，它是目前最省心的新选择之一。

在撰写本文的过程中，我主要参考了以下来源：GitHub 仓库 Abdenasser/neohtop-cli 的 README、官方 demo 截图与 npm 包信息。文中数据（Star 数、主题数、键位等）以仓库公开信息为准，可能随版本更新而变化。