quickread
VSCode 状态栏书籍阅读插件——在编辑器底部状态栏隐蔽地阅读本地 .txt 书籍。
功能特性
- 状态栏阅读:默认每页 50 字,由两个相邻文字块各显示约 25 字,从左向右阅读;页码、进度和速度放在悬停提示中
- 自动编码检测:UTF-8(BOM)、GBK、GB2312、UTF-16 LE/BE 自动识别,无需手动转码
- 书籍选择器:
Ctrl+Shift+P → quickread: 打开书籍,文件对话框选书,路径自动写入设置
- 快捷键翻页:
[ 上一页、] 下一页(翻页与实际配置的显示字数一致,连续衔接)
- 关键词跳转:设置中填写
quickread.keyword 自动跳转
- 阅读速度统计:实时显示 行/时(最近 30 分钟滑动窗口)
- 进度显示:页码 + 百分比
- 老板键:
Ctrl+M(Mac: Cmd+Shift+M)一键伪装成伪代码日志,再按恢复
- 颜色自定义:
quickread.textColor(hex)> quickread.useProminentColor(主题强调色)> 默认
- 书架与进度:每本书分别保存阅读位置,侧栏显示阅读百分比和页码,重启后自动恢复,不再限于 10 本
使用方式
Ctrl+Shift+P → quickread: 打开书籍 → 选择 .txt 文件(默认打开下载目录)
- 编辑器中输入
[ / ] 翻页
- 需要伪装:
Ctrl+M(Mac Cmd+Shift+M)切换;伪装态下 [ ] 恢复正常输入
- 换书:
quickread: 打开书架,点击书名从各自的上次位置继续;也可使用“最近书籍”快速选择
书架
Ctrl+Shift+P → quickread: 打开书架,会展开资源管理器里的 quickread 书架。
- 打开或通过插件下载的书籍自动入架;旧版已经保存的阅读记录会继续保留。
- 点击书架右上角的 + 可批量添加本地 TXT。添加不会切换正在阅读的书,重复添加也不会重置进度。
- 点击书名继续阅读,在书架或编辑器中按
[、] 翻页即可自动保存位置。切换书籍、重启编辑器或修改每页字数后仍从该字符位置继续。
- 已打开过的书显示阅读百分比和页码;旧记录在再次打开前显示保存的页码,新添加的书显示“未开始阅读”。进度保存在当前 VSCode 用户资料中。
- 文件被移动或删除后,书架会标记文件缺失。从书架右键移除会在确认后清除该书的阅读记录,保留磁盘上的 TXT 文件。
- 老板键会同时隐藏书架中的书名和进度,恢复阅读时重新显示。
用浏览器下载的 TXT,需要通过书架 + 添加,或用“打开书籍”选择一次。书架不会自动扫描下载目录。
设置项
| 设置 |
默认 |
说明 |
| quickread.bookPath |
"" |
书籍路径 |
| quickread.downloadDir |
"" |
下载保存目录,留空使用当前用户主目录下的 Documents/quickread |
| quickread.pageSize |
50 |
每页原文字符数,整页分到两个文字块显示 |
| quickread.statusBarMaxChars |
25 |
每个文字块的字数上限,两块合计最多 50 字 |
| quickread.showDetails |
false |
正文旁显示页码、进度和速度,关闭时仍可悬停查看 |
| quickread.keyword |
"" |
跳转关键词 |
| quickread.textColor |
"" |
文字颜色 hex |
| quickread.useProminentColor |
false |
跟随主题强调色 |
| quickread.showBody |
true |
是否显示当前页正文 |
快捷键
| 键 |
功能 |
[ |
上一页 |
] |
下一页 |
Ctrl+M(Mac Cmd+Shift+M) |
老板键 Toggle |
编辑器或书架获得焦点时可用 [、] 翻页;伪装态下不生效(保持 [ ] 正常输入)。
每页正文分到两个相邻的状态栏文字块,左边是前半页,右边是后半页;默认每块约 25 字,合计 50 字。按 ] 时整页一起更新,不会把后半页跳过。两个文字块点击均可触发老板键,伪装时后半页立即隐藏。
两块正文优先使用 VSCode 自带的紧凑分组,减少中间留白。仍会保留少量按钮内边距,无法与同一文字块内部的字距完全一致。紧凑分组通过兼容适配访问宿主内部优先级字段,编辑器更新后可能恢复标准间距;不会修改 VSCode 安装文件或全局样式。
实际每页字数为 pageSize 和 statusBarMaxChars × 2 的较小值,显示与翻页共用同一长度。更改字数会保留当前字符位置,页码及总页数会随之变化。悬停任一文字块可查看当前页完整内容、页码和速度。
两个文字块可以减轻单个文字块过长时被裁掉的问题,但仍共用窗口的状态栏总空间。VSCode 不向插件提供可用宽度,插件无法自动判断文字是否被裁掉。如果窗口太窄,运行 quickread: 调整阅读宽度 缩短每块字数。开启 quickread.showDetails 会占用更多状态栏空间。
联网书源
quickread: 下载书籍 使用 quickread.bookSourceUrls 中的站点搜索并下载,默认包含速读谷 https://www.suduguu.com 和 UU看书 https://www.uukan.org。如果已有自定义书源列表,请把 UU看书地址加入列表。
速读谷直接下载并合并分卷。UU看书使用本机安装的 Microsoft Edge 打开书籍页面,点击网站的 TXT 下载按钮,等待网站自动检查及文件生成,再自动解压 ZIP 中的 TXT 并打开阅读。首次使用会打开独立的 Edge 窗口,后续保留该窗口的会话;请等待下载完成。如果网站要求人工验证,插件会提示,不能保证每次都能自动完成。
下载内容以书源实际提供的版本为准,网站标注“全本”也可能没有番外。同名文件会另存,不覆盖已有书籍。旧地址 https://www.shudugu.org 会自动转换到速读谷新地址;其他自定义站点仍需兼容速读谷的接口与页面结构。
请求失败时会显示具体站点和错误;请求成功但没有匹配结果时会显示“未找到”。
下载目录默认使用当前用户主目录下的 Documents/quickread(例如 C:\Users\13804\Documents\quickread)。可通过 quickread.downloadDir 自定义保存目录;旧版本的 C:\Users\Administrator\Downloads\txt\txt 默认值会自动转换到当前用户目录。遇到目录权限错误时,请将该设置改为有写入权限的目录。
兼容性
VSCode 1.98+ 与 VSCode Insiders;Windows / macOS / Linux。