终端里已经有了一切。
现在它有了一个书架。
ReadShell 是终端里的书架：一个为开发者设计的命令行阅读工具，支持 txt / epub / md，本地优先、无需账号，完全免费开源（MIT 协议）。
为不离开终端的开发者设计的低打断轻阅读工具。没有账号，没有服务器，数据永远留在你的机器上。
npm install -g readshell- 平台
- macOS / Linux / Windows 终端，需要 Node.js ≥ 20
- 安装
npm install -g readshell- 开源协议
- MIT
- 价格
- 完全免费，无付费版、无内购
- 支持格式
- txt / epub / md
- 界面语言
- 中文 / English
- 数据
- 本地 SQLite，无服务器、不上传
- 作者
- David Yin
- 更新于
- 2026-10-10
等编译，等部署，等 CI 跑完——你有 5 分钟。
你拿起手机。40 分钟后，你还在刷。
ReadShell 就是为这段空隙设计的。
核心功能
零摩擦续读
精确到字节地恢复阅读位置，无论上次在哪停下。
老板键
一键伪装成终端报错画面（Node.js / Python / Java / C / Go），路过的同事完全看不出来你在读书。
同步文件夹
novel sync --dir 指向任意被 iCloud / Dropbox / 坚果云 / Syncthing 同步的文件夹，多设备自动接力阅读进度。
阅读统计
novel stats 在终端里画出近一年的阅读热力图：阅读天数、总时长、读完本数、当前连续天数。
书签导出
随手标记精彩段落，novel bookmarks export 一键导出为 JSON 或 Markdown。
批量导入
novel import ~/books/ 递归扫描目录，支持 epub / txt / md。
在线演示
鲁迅《狂人日记》（公版书）开头几段，装进一个假终端里——和真实体验几乎一样。
点击后用键盘试试：j/k 翻页，m 书签，b 老板键
老板键
读书读到一半，有人走过来？按下 b 或 Esc，ReadShell 立刻切换为一屏终端报错。
看起来就像你在紧张地调试生产 bug。同事掉头离开，你再从容回来。
安全后运行 novel resume，精确回到原位。
看完整指南 →
你同事看到的样子
常见问题
终端里怎么看小说？
用 ReadShell：npm install -g readshell 装好后，novel import ~/books/ 导入小说文件或文件夹（txt / epub / md），novel resume 从上次读到的位置继续。阅读器是纯文本终端界面，支持翻页、章节、书签。
支持哪些格式？
txt、epub、md 三种。txt 自动检测编码（含 GBK）并按章节标题切分；epub 读取书名、作者和目录；md 按纯文本导入。pdf、mobi、azw3 暂不支持。
快速上手
三步，五分钟搞定
npm install -g readshellnovel import ~/books/ # 递归扫描目录
novel list # 查看书库
novel resume # 从上次位置继续novel sync --dir "~/Library/Mobile Documents/com~apple~CloudDocs/readshell"
# 指向任何被 iCloud / Dropbox / 坚果云 / Syncthing 同步的文件夹即可↑ 不设置也能完整使用所有功能，数据始终只在本地
快捷键
| 按键 | 操作 |
|---|---|
| f / Space / j / ↓ | 下一页 |
| k / ↑ | 上一页 |
| c | 章节列表与书签 |
| Tab | 切换目录 / 书签 |
| m | 添加书签 |
| g / G | 跳转到开头 / 结尾 |
| b / Esc | 老板键（伪装成报错并退出） |
| q | 退出 |
| ? | 显示帮助 |
ReadShell 以 MIT 协议开源，完全免费。
没有账号，没有付费版，没有服务器。
你的阅读数据以 SQLite 文件存储在本地，永远不会离开你的机器。 跨设备同步只通过你自己的同步文件夹（iCloud / Dropbox / 坚果云 / Syncthing）完成——ReadShell 没有任何服务器。