常见问题

关于 ReadShell 最常被问到的问题。所有回答都只描述产品的真实行为：MIT 开源、完全免费、本地优先、无服务器。

终端里怎么看小说？

用 ReadShell：npm install -g readshell 安装后，novel import ~/books/ 导入 txt / epub / md 文件，novel resume 开始阅读。阅读器是纯文本终端界面，支持翻页/滚动、章节跳转、书签；按 b 或 Esc 是老板键，屏幕瞬间变成一段报错日志。详见「终端看小说与老板键」指南。

ReadShell 真的完全免费吗？

是的。ReadShell 1.0 起全部功能以 MIT 协议开源，没有付费版、没有账号、没有内购。旧版付费包 readshell-pro 已停用并并入免费的 readshell 包。

在终端看小说，会被发现吗？

ReadShell 能做的只是伪装屏幕本身：按下 b 或 Esc，终端立刻变成一段看起来正在运行的报错日志（可选 Node.js / Python / Java / C / Go 风格），并清除滚动历史；阅读界面没有任何花哨元素，就是一个普通终端窗口。需要说明的是，它伪装不了屏幕之外的东西：公司电脑的进程监控、屏幕截图审计、背后的摄像头都可能暴露你，是否合适由你自己判断。

ReadShell 会不会偷偷联网、上传数据？

不会。ReadShell 没有服务器：书库、进度、书签和统计全部保存在本机的一个 SQLite 文件里，没有任何账号体系，也不存在可上传的目标。源码在 GitHub 上公开（MIT），可自行验证。

离线能用吗？

能。导入书籍、阅读、书签、统计全部在本地完成，不需要网络；唯一需要联网的场景是自己选择的文件夹同步——那也是经由你自己的 iCloud / Dropbox / OneDrive / 坚果云 / Syncthing，不经过 ReadShell 的服务器。

我的数据存在哪里？

全部在本机数据目录的 SQLite 文件里：macOS 在 ~/Library/Application Support/readshell/，Linux 在 ~/.config/readshell/，Windows 在 %APPDATA%/readshell/。

多设备怎么同步进度？

用 novel sync --dir 指向一个被 iCloud / Dropbox / OneDrive / 坚果云 / Syncthing 同步的文件夹即可。打开阅读器时自动拉取，退出时自动推送，进度按 last-write-wins 合并，失败静默不打扰。详见「用法与快捷键」的同步一节。

老板键安全吗？

按下 b 或 Esc 后屏幕立刻变成一段逼真的报错日志，日志里不含任何你的个人路径；安全后运行 novel resume 精确回到原位。它能遮住屏幕上的内容，但不能对抗系统层面的监控手段。

支持哪些格式？

txt、epub、md 三种。txt 自动检测编码并切分章节；epub 读取元数据和目录；md 按纯文本导入。pdf、mobi、azw3 等暂不支持。详见「支持的格式」。

为什么命令叫 novel 而不是 readshell？

novel 和 readshell 在安装时都会被注册，两个命令完全等价，用哪个都行。文档统一使用更短的 novel。

以前装的 readshell-pro 怎么办？

旧版 readshell-pro 已停用，功能并入完全免费的 MIT 版 readshell 包：npm uninstall -g readshell-pro 后 npm install -g readshell 即可。书库、进度、书签保存在本机数据目录中，切换包名不会丢失。详见「安装」页。

没找到答案？

更新于 2026-10-13