文档

ReadShell 是终端里的书架：一个为开发者设计的命令行阅读工具，支持 txt / epub / md，本地优先、无需账号，完全免费开源（MIT 协议）。

一分钟上手

npm install -g readshell

novel import ~/books/
novel resume

装好后导入书库，一条 novel resume 回到上次读到的位置。

Node.js ≥ 20 环境下用 npm 全局安装 readshell，验证安装、升级与数据目录位置。

novel 全部子命令、阅读器按键、配置项与文件夹同步的完整用法。

txt、epub、md 三种格式的解析细节：编码自动检测、章节切分、元数据读取。

免费吗？数据存哪？上班看小说会不会被发现？离线能用吗？readshell-pro 怎么迁移？

ReadShell 与 epr、epy、goreader 等开源终端阅读器在格式、安装、协议上的对比。

在终端看小说的完整指南：老板键（b / Esc）伪装屏幕、伪装语言切换、恢复阅读。

ReadShell 适合整天待在终端里的开发者：等编译、等部署、等 CI 的空隙，不用拿起手机，一条命令就能在终端里继续读上次没读完的书。

它也适合需要在工位上低调阅读的场景：按下 b 或 Esc 老板键，屏幕立刻变成一段逼真的报错日志，novel resume 精确回来。