Read On Bush
在 VS Code 中低调摸鱼看小说——把正文伪装成 Claude CLI、构建日志、服务日志等开发输出，旁人路过只会以为你在认真工作。
支持 TXT / EPUB / PDF 三种格式，内置书架管理、章节目录、进度跳转和快捷键翻页。
📋 目录
功能概览
导入书籍 --> 书架管理 --> 选择书籍 --> 开始阅读
|
+-- 状态栏模式：正文显示在底部状态栏
+-- 终端伪装模式：正文混入伪装终端（推荐）
+-- 阅读面板模式：正文显示在侧边栏 Webview 面板
| 能力 |
说明 |
| 多格式 |
TXT / EPUB / PDF 统一书架管理，导入时自动提取目录 |
| 双模式 |
状态栏阅读 + 终端伪装 + 阅读面板，通过配置和状态栏图标一键切换 |
| 书架整理 |
分类、排序、按分类或目录分组，支持拖拽改分类、新建和重命名分类 |
| 全文搜索 |
阅读中按 f 搜索全书，跨段匹配、分页加载、跳转与返回一气呵成 |
| 自动翻页 |
按 a 启动/暂停/恢复，按字数估算或固定秒数，解放双手 |
| VS Code 窗口失焦自动隐蔽 |
VS Code 窗口切换到其他应用时自动隐藏伪装阅读内容，降低旁人看到正文的风险 |
| 最近阅读 |
书架顶部自动展示最近阅读的书籍，一键继续阅读 |
| 缓存管理 |
EPUB/PDF 缓存上限可配，LRU 自动淘汰，支持一键清除 |
| 隐私界面 |
一键隐藏书名、路径、章节和通知中的真实信息，支持隐私别名与启动配置 |
| 格式识别 |
TXT / EPUB / PDF 使用不同书架图标，打开前即可快速识别格式 |
| 编码检测 |
TXT 自动检测 BOM / UTF-16 端序 / GB18030，也支持手动指定 |
✨ 特色功能
终端伪装：把小说藏进开发日志
这是 Read On Bush 最核心的特色。小说正文被嵌入终端日志模板中，看起来就像你在正常开发：
+-- terminal: Claude Code -----------------------------------+
| |
| > Planning... |
| Read src/features/orders/OrderList.tsx |
| Read src/api/orders.ts |
| |
| 第三章 龙族崛起 |
| 他缓缓睁开双眼，发现自己躺在一间陌生 |
| 的石室之中，空气中弥漫着古老的气息。 |
| |
| Updated src/api/orders.ts |
| @@ -24,7 +24,12 @@ |
| + const params = new URLSearchParams(...) |
| |
| npm test -- 18 passed (2.4s) |
| ------------------------------------ |
| [opus-4.8] [========------] 43% | $16.17 | 305m |
+------------------------------------------------------------+
内置 6 种伪装风格，通过配置项 terminalCamouflageStyle 切换：
| 风格 |
伪装效果 |
claudeCli（默认） |
Claude Code 命令行交互界面 |
buildLog |
Webpack / tsc 等构建工具的 Watch 输出 |
serverLog |
后端服务运行时日志 |
vite |
Vite 开发服务器终端输出 |
docker |
Docker Compose 容器日志 |
custom |
自定义 JSON 模板（见自定义伪装模板） |
终端伪装窗口内的键盘操作（TXT / EPUB / PDF 通用）：
| 按键 |
功能 |
→ 或 n |
下一行 / 下一页 |
← 或 p |
上一行 / 上一页 |
j |
跳转 |
d |
切换真实内容 ↔ 模板占位（无痕切换，按一下隐藏，再按一下继续看） |
q |
快速切到模板占位（一键隐蔽） |
q q |
停止阅读 |
i |
查看 / 关闭当前页图片（仅 EPUB / PDF，见图片预览） |
f |
全文搜索当前书籍（见全文搜索） |
a |
自动翻页：启动 / 暂停 / 恢复（见自动翻页） |
一键隐蔽：0.1 秒消除证据
旁人靠近时，两个按键帮你瞬间隐蔽：
q — 一键隐蔽：正文瞬间替换为伪装占位文案，看起来就像正常的 AI 编程输出d — 无痕切换：在真实内容和占位文案之间来回切换，按一下隐藏，再按一下继续阅读
以 Claude CLI 模式为例，按 q 的前后对比：
+-- 正常阅读 ------------------------------------------------+
| |
| > Planning... |
| |
| 第三章 龙族崛起 |
| 他缓缓睁开双眼，发现自己躺在一间陌生的 |
| 石室之中，空气中弥漫着古老的气息。 |
| |
| Updated src/api/orders.ts |
| [opus-4.8] [========------] 43% | $16.17 | 305m |
+------------------------------------------------------------+
|
| 按 q 或 d (0.1 秒切换)
v
+-- 一键隐藏 ------------------------------------------------+
| |
| > Planning... |
| |
| I'll keep the terminal rendering state local to |
| the pseudoterminal and reuse the shared renderer. |
| @@ -42,7 +42,11 @@ render(state) |
| + this.panel.webview.html = renderScreen(...) |
| |
| Updated src/api/orders.ts |
| [opus-4.8] [========------] 43% | $16.17 | 305m |
+------------------------------------------------------------+
上下两段的 Header（任务规划）、Trailing（代码 diff）、底部进度条完全一致——只有中间正文被替换。再按 d 即可切回真实内容继续阅读。
VS Code 窗口失焦自动隐蔽：窗口切走也不露内容
这里的“失焦”特指 VS Code 窗口失去操作系统级窗口焦点，也就是切换到浏览器、聊天工具或其他应用；不是终端、阅读面板或编辑器之间的内部焦点切换。在 VS Code 窗口内部切换终端、阅读面板和编辑器，不会触发自动隐蔽。
当 VS Code 窗口切换到其他应用时，插件可以自动把终端、阅读面板和状态栏中的正文切换为伪装占位内容。重新回到 VS Code 后，默认保持隐蔽状态，不会擅自显示正文。
autoConcealOnFocusLoss 默认开启，控制 VS Code 窗口失去焦点 时是否自动隐蔽autoRevealOnFocus 默认关闭，开启后 VS Code 窗口重新获得焦点 时自动恢复由失焦机制隐藏的内容- 自动恢复只针对失焦触发的隐蔽，不会覆盖用户手动按
q 或 d 设置的隐蔽状态
全文搜索：快速定位情节
阅读中按 f 即可搜索当前书籍全文，支持 TXT 和 EPUB：
- 模糊匹配：支持全角/半角、NFKC 规范化，中文按字符、英文按词匹配
- 分页加载：大书搜索结果按页加载，不必等待全部匹配完成
- 跳转与返回：选中匹配项直接跳转到对应位置，搜索前位置自动入栈，可按
readOnBush.searchBack 返回
- 隐私模式兼容：搜索结果中书名和匹配上下文会自动脱敏
阅读中按 f
↓
+-- QuickPick --------------------------------+
| 🔍 输入搜索关键词... |
| |
| 第三章 龙族崛起 |
| ...他缓缓睁开双眼，发现自己在... |
| 第五章 秘境探索 |
| ...睁开双眼后，眼前是一片... |
| |
| [Enter 搜索] [Esc 取消] |
+---------------------------------------------+
也可以在书架标题栏点击搜索图标搜索书架中的书籍，快速定位并打开阅读。
自动翻页：解放双手
阅读中按 a 启动自动翻页，再按一次暂停，再按一次恢复——同一按键切换三种状态，无需记忆复杂操作：
- 按字数估算（默认）：根据当前页可见字符数和阅读速度（默认 450 字符/分钟）自动计算停留时间，钳制在 2–30 秒区间
- 固定秒数：设置
autoTurnFixedSeconds > 0 后，每页按固定秒数翻页，完全覆盖按字数计算
- 手动操作自动暂停：翻页、搜索、跳转等手动操作会立即暂停自动翻页并冻结剩余时间，恢复后从冻结处继续
- 到达末页自动停止：翻到全书最后一页后自动停止，不会循环
- TXT 与 EPUB/PDF 均支持
- 重开书籍默认关闭：关闭阅读后重新打开时自动模式默认不恢复，避免意外自动跳页
图片预览：插图随看随关
阅读 EPUB 或 PDF 时，如果当前页包含图片，进度处会显示 [图 i] 标记。按 i 即可在独立窗口中查看插图：
+-- terminal: Claude Code -------------------+
| |
| 第三章 龙族崛起 - 第 12 页 [图 i] |
| 他缓缓睁开双眼，发现自己躺在一间陌生 |
| 的石室之中，石壁上刻满了古老的符文... |
| ------------------------------ 43% |
+--------------------------------------------+
|
| 按 i
v
+-- 图片预览窗口 ----------------------------+
| |
| |
| [ 图片缩略图 ] |
| 点击图片查看大图 |
| |
| 点击空白处或按任意键关闭 |
| |
+--------------------------------------------+
隐蔽设计细节：
- 默认先以较小尺寸展示图片，点击图片后放大；再次点击图片可以缩回缩略图
- 缩略图模式下点击空白处、按
Esc 或任意普通按键立即关闭
- 可通过
imagePreviewMode 配置为打开时直接展示大图；该模式点击图片或空白处都会关闭
- 切换到模板占位模式（
q 或 d）时，已打开的图片窗口会自动关闭
- 占位模式下按
i 不会打开真实图片，不会暴露你在看什么
- 当前页有多张图片时，先在 QuickPick 中选择一张，再打开预览
- PDF 图片为纯 JS 按需解码，无需额外原生依赖
阅读面板：侧边栏 Webview 模式
除了集成终端，阅读内容还可以显示在 VS Code 侧边栏的 Webview 面板中。将 camouflageSurface 配置从 terminal 切换为 readerPanel 即可：
+-- READ ON BUSH (侧边栏面板) -----------------+
| |
| > Planning... |
| |
| 第三章 龙族崛起 |
| 他缓缓睁开双眼，发现自己躺在一间陌生 |
| 的石室之中，空气中弥漫着古老的气息。 |
| |
| Updated src/api/orders.ts |
| [opus-4.8] [========------] 43% |
+----------------------------------------------+
- 不占用终端：面板显示在活动栏侧边区域，与终端完全独立
- 完整伪装：与终端模式使用相同的伪装模板和配色
- 键盘操作：面板内支持
→ / ← / n / p / j / d / q / i / f / a 等全部操作
- 热切换：修改
camouflageSurface 后自动切换载体，无需重启
两种载体的对比：
|
集成终端（terminal） |
阅读面板（readerPanel） |
| 显示位置 |
VS Code 集成终端区域 |
活动栏侧边栏面板 |
| 终端占用 |
占用一个终端标签 |
不占用终端 |
| 键盘输入 |
Pseudoterminal handleInput |
Webview keydown 事件 |
| 适用场景 |
需要完整终端伪装效果 |
终端已被占用或偏好面板交互 |
自定义伪装模板：打造专属风格
如果 6 种内置风格都不够用，可以用可视化编辑器打造完全属于自己的伪装模板。
执行 Read On Bush: 配置自定义终端模板 打开 Webview 编辑器：
- 实时预览：左侧编辑表单，右侧终端预览，带 Header / 正文 / Trailing / Done 区段标注
- 所见即所得：修改任意字段，预览立即更新
- 一键启用：点击「保存并启用」自动写入
settings.json 并切换到 custom 风格
- 安全颜色：支持
plain / dim / red / green / yellow / blue / magenta / cyan
将 terminalCamouflageStyle 设为 custom 时也会自动打开编辑器。模板支持静态头尾日志、正文前缀、{{progress}} 进度占位符。不支持脚本、原始 ANSI 或动态底栏。
示例模板：
{
"version": 1,
"terminalName": "dev server",
"contentPrefix": "INFO ",
"header": [
{ "text": "npm run dev", "style": "blue" },
"",
{ "text": "INFO Server listening on http://localhost:3000", "style": "green" }
],
"trailing": [
"",
{ "text": "INFO Background worker heartbeat ok", "style": "green" }
],
"done": { "text": "INFO request completed{{progress}}", "style": "green" },
"debugContent": [
{ "text": "INFO GET /api/workspaces 200 14ms", "style": "green" },
{ "text": "WARN slow query detected duration=42ms", "style": "yellow" }
]
}
📖 使用指南
安装与导入
安装后点击活动栏的 Read On Bush 图标打开书架视图。点击 导入书籍 选择单本文件，或点击 导入目录 选择目录批量导入，导入后可点击 刷新书架 刷新书架。
书架管理
书籍右键菜单：重命名书籍、设置分类 / 清除分类、删除书籍。
书架标题栏：排序书架、分组方式（不分组 / 按分类 / 按文件目录）、新建分类、刷新书架、搜索书籍。
最近阅读：
书架顶部自动展示「最近阅读」分组，按最近打开时间降序排列。点击即可快速继续阅读。通过 recentBookCount 配置控制显示数量（默认 5，设为 0 禁用）。右键最近阅读中的书籍可选择「从最近阅读中移除」（不影响书籍本身）。
分类管理：
- 设置分类：右键书籍 → 设置分类，弹出已有分类列表可直接选择（带数量标注、当前分类高亮），也可底部「创建新分类…」输入新名称或「清除分类」
- 拖拽改分类：切换到「按分类分组」后，直接把书籍拖到目标分类文件夹或另一本书上即可改分类；拖到「未分类」或空白处则清除分类，支持多选拖拽
- 新建分类：点击标题栏 新建分类，输入名称后多选要加入的书籍
- 重命名分类：右键分类文件夹 → 点击编辑图标重命名，自动更新该分类下所有书籍；若新名与已有分类重名则自动合并
格式图标：
书架会根据文件格式显示不同图标：TXT 使用文本文件图标，EPUB 使用书籍图标，PDF 使用 PDF 文件图标。无需打开书籍即可快速确认格式。
隐私界面模式：书架也能一键隐藏
隐私界面模式用于隐藏书架和阅读过程中的元信息，与终端里的 q / d 内容切换互相配合：
- 一键切换：点击书架标题栏的眼睛按钮，或执行 切换隐私界面，在普通模式和隐私模式之间切换
- 隐藏书架信息：隐私模式下，书名使用隐私别名或中性名称，目录路径显示为统一的「本地文档」，Tooltip 不再暴露真实路径和书名
- 隐藏阅读信息：章节标题、页码标题、图片预览标题和通知文案同步使用中性名称
- 设置隐私别名：右键书籍 → 设置隐私别名，为某本书设置只在隐私模式下显示的名称
- 快速关闭：切换到隐私模式时，已打开的图片预览会自动关闭；隐私模式下按
i 不会打开真实图片
- 启动时开启：将
privacyDisplayOnStart 设为 true，扩展激活时自动进入隐私界面模式
状态栏阅读
选择 TXT 书籍后，正文片段显示在 VS Code 底部状态栏，点击翻页：
+-- VS Code 底部状态栏 --------------------------------------+
| |
| 第三章 龙族崛起 他缓缓睁开双眼... 43% Reading main* |
| |
+------------------------------------------------------------+
通过状态栏的 Reading / Coding 按钮切换快捷键是否生效——打开 TXT 书籍时自动激活，关闭或切换到 EPUB/PDF 后自动释放，不影响编辑器原生行首/行尾导航。
EPUB & PDF 阅读
EPUB 和 PDF 均通过专属终端伪装窗口阅读（与 TXT 伪装终端相互独立，不受 displayTarget 配置影响）。终端操作和图片预览复用上方特色功能中的说明。
通用流程：
- 点击 导入书籍 导入
.epub / .pdf（或点击 导入目录 批量导入），自动提取目录
- 首次打开解析并缓存全书（按文件修改时间失效），之后秒开
目录树与跳转：
书架中的 EPUB / PDF 书籍可展开查看目录树，直接点击任意章节或页面跳转：
- EPUB：展开后显示章节目录（如「第一章 初入江湖」「第二章 龙族崛起」…），点击章节名跳转到对应位置
- PDF：展开后显示页面目录（如「第 1 页」「第 2 页」…），点击页码跳转到对应页面；也可以在终端中按
j 输入页码跳转
展开后的目录树支持滚动浏览，几百页的书也能快速定位到想看的位置。
翻页衔接：
EPUB 和 PDF 都支持跨章 / 跨页自动流入——当一页内容不够填满终端时，会自动从下一章 / 下一页继续拼接显示，翻页体验连贯。PDF 中的空白页和纯图片页会保留页码语义（不会被跳过），遇到时单独占一屏。
格式差异：
|
EPUB |
PDF |
| 目录单位 |
章节 |
页面 |
| 进度显示 |
第 N 章 · 全书 X% |
第 N 页 · 全书 X% |
| 图片 |
按章节内位置锚定 |
按页锚定，纯 JS 按需解码 |
格式转换引导
导入 mobi / azw3 时不会静默丢弃，而是弹窗提示并提供 前往 CloudConvert 按钮一键打开 cloudconvert.com，转换完成后把生成的 .epub 重新导入即可。
快捷键
以下快捷键仅在 阅读模式开启且正在阅读 TXT 书籍 时生效（不影响 EPUB / PDF 终端内的按键操作）：
| 平台 |
上一行 |
下一行 |
| macOS |
Cmd+Left |
Cmd+Right |
| Windows / Linux |
Ctrl+Left |
Ctrl+Right |
终端伪装窗口内的完整键盘操作见终端伪装章节。
配置项
在 VS Code 设置中搜索 Read On Bush 调整以下配置。
显示与伪装
| 配置项 |
默认值 |
说明 |
displayTarget |
statusBar |
阅读内容显示位置：statusBar（状态栏）或 terminalCamouflage（终端伪装）。推荐改为 terminalCamouflage 体验伪装阅读，通过状态栏终端图标也能随时切换 |
camouflageSurface |
terminal |
伪装内容的显示载体：terminal（集成终端）或 readerPanel（侧边栏 Webview 面板）。面板模式不占用终端，适合终端已被占用的场景 |
terminalCamouflageStyle |
claudeCli |
伪装输出样式：claudeCli / buildLog / serverLog / vite / docker / custom。选择最适合你工作场景的风格 |
terminalCamouflageLineCount |
3 |
终端伪装中一次展示的正文行数。设大一点（如 5-8）可以一次多看几行，但也会占用更多终端空间 |
terminalCamouflageLineWidth |
0 |
终端伪装中每行正文的最大显示宽度。0 表示根据终端宽度自动计算，也可以手动指定固定值（如 60） |
showProgress |
true |
是否在状态栏 / 终端伪装中显示阅读进度百分比 |
showChapterTitle |
true |
是否在终端伪装的进度中显示当前章节名称（EPUB 显示章节名，PDF 显示页码） |
privacyDisplayOnStart |
false |
激活扩展时是否默认开启隐私界面模式，开启后书架、Tooltip、通知和阅读标题使用中性信息 |
autoConcealOnFocusLoss |
true |
VS Code 窗口切换到其他应用时，是否自动将阅读内容切换为伪装占位文案；窗口内部切换终端/面板不触发 |
autoRevealOnFocus |
false |
VS Code 窗口从其他应用恢复焦点时，是否自动恢复因失焦而隐藏的内容；手动 q / d 隐蔽不受影响 |
imagePreviewMode |
thumbnail |
图片预览初始模式：thumbnail（先显示小图，点击图片放大）或 large（打开时直接显示大图） |
状态栏阅读
| 配置项 |
默认值 |
说明 |
lineWidth |
45 |
状态栏每个阅读片段的最大字符数。值越大状态栏显示的正文越长，但也会挤占状态栏空间 |
statusBarPrefix |
"" |
状态栏内容前缀。可以设置一个不起眼的字符串（如 | 或 Ln ）让正文更隐蔽 |
TXT 编码
| 配置项 |
默认值 |
说明 |
txtEncoding |
auto |
TXT 文件编码。auto 自动检测 BOM / UTF-16 端序 / GB18030。如果 Windows 中文 TXT 出现乱码，手动指定为 gb18030 即可解决 |
书架与快捷键
| 配置项 |
默认值 |
说明 |
bookListGroupBy |
none |
书架分组方式：none（不分组）/ category（按分类）/ directory（按文件目录）。书多时按分类分组更整洁 |
recentBookCount |
5 |
书架顶部「最近阅读」分组显示的书籍数量。设置为 0 表示禁用 |
defaultReadingMode |
true |
是否默认启用阅读快捷键。如果不想让快捷键自动激活，设为 false 改为手动开关 |
autoRefreshBookList |
false |
是否尝试自动刷新书架 |
cacheLimitMB |
100 |
EPUB/PDF 解析缓存上限（MB）。超过后自动按 LRU 淘汰最旧缓存；设为 0 表示不限制 |
terminalCamouflageCustomTemplate |
null |
custom 样式的 JSON 模板，建议通过可视化编辑器生成，不建议手写 |
自动翻页
| 配置项 |
默认值 |
说明 |
autoTurnSpeed |
450 |
自动翻页的阅读速度（字符/分钟）。阅读中按 a 启动后，按此速度估算每页停留时间 |
autoTurnMinSeconds |
2 |
自动翻页每页最短停留秒数（按字数估算模式下生效） |
autoTurnMaxSeconds |
30 |
自动翻页每页最长停留秒数（按字数估算模式下生效） |
autoTurnFixedSeconds |
0 |
自动翻页每页固定停留秒数。设为 0 时按字数估算；大于 0 时完全覆盖按字数计算 |
命令列表
| 命令 |
说明 |
readOnBush.prev |
状态栏读书：上一行 |
readOnBush.next |
状态栏读书：下一行 |
readOnBush.jump |
状态栏读书：跳转 |
readOnBush.switchReadingMode |
激活阅读快捷键 |
readOnBush.switchCodingMode |
禁用阅读快捷键 |
readOnBush.openTerminalCamouflage |
打开终端伪装 |
readOnBush.toggleTerminalCamouflage |
切换终端伪装 |
readOnBush.openCustomTemplateEditor |
配置自定义终端模板（可视化编辑器） |
readOnBush.import |
导入单本书籍 |
readOnBush.importDirectory |
按目录导入书籍 |
readOnBush.refreshBookList |
刷新书架 |
readOnBush.sortBookList |
排序书架 |
readOnBush.switchBookListGroupBy |
切换书架分组方式 |
readOnBush.searchBook |
搜索书架书籍 |
readOnBush.searchCurrentBook |
搜索当前书籍全文（终端内按 f） |
readOnBush.searchBack |
返回搜索前位置 |
readOnBush.continueReading |
继续阅读上次打开的书 |
readOnBush.clearCache |
清除全部缓存 |
readOnBush.autoTurn.toggle |
切换自动翻页（终端内按 a） |
readOnBush.setBookCategory |
设置书籍分类 |
readOnBush.clearBookCategory |
清除书籍分类 |
readOnBush.setPrivacyAlias |
设置书籍隐私别名 |
readOnBush.togglePrivacyDisplay |
切换隐私界面模式 |
readOnBush.enablePrivacyDisplay |
开启隐私界面模式 |
readOnBush.disablePrivacyDisplay |
关闭隐私界面模式 |
readOnBush.createCategory |
新建分类 |
readOnBush.renameCategory |
重命名分类 |
readOnBush.openBookOutline |
打开书籍章节目录 |
readOnBush.epub.next |
EPUB 读书：下一页 |
readOnBush.epub.prev |
EPUB 读书：上一页 |
readOnBush.epub.jumpChapter |
EPUB 读书：跳转章节 |
readOnBush.epub.viewImage |
EPUB 读书：查看图片 |
readOnBush.epub.stop |
EPUB 读书：停止 |
readOnBush.pdf.next |
PDF 读书：下一页 |
readOnBush.pdf.prev |
PDF 读书：上一页 |
readOnBush.pdf.jumpPage |
PDF 读书：跳转页面 |
readOnBush.pdf.viewImage |
PDF 读书：查看图片 |
readOnBush.pdf.stop |
PDF 读书：停止 |
