用法与快捷键
ReadShell 的命令入口是 novel（安装时也会注册等价的
readshell）。典型流程是：先
novel import 把书导入书库，之后每次只要
novel resume 就回到上次读到的位置。
常用流程是什么？
novel import ~/books/ # 导入整个书籍目录
novel list # 看看书库里有什么
novel resume # 回到上次的位置继续读
阅读位置精确到字节，退出（q）或老板键
（b / Esc）都会自动保存。
有哪些命令？
运行 novel --help 可随时查看：
| 命令 | 说明 |
|---|---|
novel import <path> | 导入书籍：支持 txt / epub / md；传入目录时递归扫描所有支持的文件 |
novel list | 列出书库中的所有书 |
novel open <id|书名> | 打开指定书籍 |
novel resume | 从上次位置继续阅读（精确到字节） |
novel remove <id|书名> | 从书库移除一本书 |
novel lang zh|en | 切换界面语言（中文 / English） |
novel config <key> <value> | 修改配置，见下方配置项 |
novel update | 检查并更新到最新版本 |
novel bookmarks export [--format json|md] [--out file] | 导出书签为 JSON 或 Markdown |
novel stats | 终端热力图：近一年阅读天数、总时长、读完本数、当前连续天数 |
novel sync --dir <path> [--with-books] | 设置同步文件夹并立即同步（--with-books 连书籍文件一起同步） |
novel sync | 用已保存的文件夹再同步一次 |
novel sync --off | 关闭文件夹同步 |
阅读器里有哪些快捷键？
| 按键 | 操作 |
|---|---|
| Space / j / ↓ / f | 下一页 / 向下滚动 |
| k / ↑ | 上一页 / 向上滚动 |
| g / G | 跳到开头 / 结尾 |
| c | 章节列表与书签 |
| Tab | 切换目录 / 书签 |
| m | 添加书签 |
| b / Esc | 老板键：清除滚动历史并打印一段假的报错日志后退出，novel resume 精确回来 |
| q | 退出并保存进度 |
| ? | 显示帮助 |
有哪些配置项？
用 novel config <key> <value> 修改：
| key | 取值 | 说明 |
|---|---|---|
language | zh | en | 界面语言 |
line-spacing | 数字 | 行距 |
reading-mode | 阅读模式 | 翻页 / 滚动等阅读模式 |
boss-key-lang | nodejs | python | java | c | go | 老板键伪装成哪种语言的报错 |
novel config language zh
novel config boss-key-lang go多设备怎么同步进度？
ReadShell 没有自己的服务器。同步的原理很简单：把数据文件放进一个
已经被云盘同步的文件夹，剩下的交给 iCloud / Dropbox / OneDrive / 坚果云 / Syncthing。
每台设备把自己的快照写进 <同步目录>/readshell-sync/devices/，
再合并其他设备的文件（进度 last-write-wins、书签墓碑、会话并集）。
打开阅读器时自动拉取，退出时自动推送；同步最多等待约 2 秒，失败静默处理，绝不打断阅读。
设置一次即可：
# iCloud Drive（macOS）
novel sync --dir "~/Library/Mobile Documents/com~apple~CloudDocs/readshell"
# Dropbox
novel sync --dir ~/Dropbox/readshell
# OneDrive
novel sync --dir ~/OneDrive/readshell
# 坚果云
novel sync --dir ~/Nutstore/readshell
# Syncthing：指向你同步的任意本地文件夹
novel sync --dir ~/Sync/readshell· 加 --with-books 可以把书籍文件也一起同步（默认只同步进度、书签和统计，书籍按文件 hash 匹配）。
· 之后随时运行 novel sync 手动同步一次。
· novel sync --off 关闭同步，本地数据不受影响。
下一步
更新于 2026-10-10