本地小说阅读器

在 VS Code 中阅读本地 EPUB、TXT 小说。书架和章节目录位于活动栏的“本地小说”视图，正文在编辑器标签页打开；阅读进度会自动保存，重新打开同一本书时自动续读。

安装与运行

开发调试：

1. 安装 Node.js 和 VS Code。
2. 在项目根目录运行 npm install 和 npm run build。
3. 用 VS Code 打开项目，按 F5 启动“运行本地小说阅读器”开发宿主。

本地安装：运行 npm run package 生成 local-novel-reader-0.1.7.vsix。在 VS Code 扩展视图右上角菜单选择“从 VSIX 安装”，选中生成的文件。

使用

1. 点击活动栏的书本图标，打开“本地小说”书架。
2. 点击“选择小说目录”，或在设置中填写 localNovelReader.folder。插件只扫描该目录顶层的 .epub 和 .txt 文件，不扫描子目录。
3. 点击书籍名称在编辑器标签页阅读；将鼠标移到书名上，可点击行末的“继续阅读”按钮直接续读。展开书籍可以查看章节目录。点击章节即可跳转，也可以使用正文底部的上一章、下一章按钮。
4. 添加、删除或重命名文件后，点击书架标题栏的刷新按钮。

书架标题栏的齿轮按钮用于调整阅读样式。可以设置正文的字体、字号、行距和最大宽度，也可以恢复默认样式。输入有效值时，已打开的阅读页会实时预览；按回车保存，按 Esc 取消并恢复原样。保存后的样式在重启 VS Code 后仍会保留。

每本书的阅读位置分别保存。滚动后短暂停顿即会自动保存；关闭阅读页或正常退出时也会保存。再次打开未变化的书籍时，会自动回到接近上次可见的正文位置。如果文件内容发生变化，插件会把它视为新版本并从开头阅读；仅文件时间戳变化不会清空进度。

格式与限制

• EPUB 优先使用书内目录；缺失时按 H1-H6 标题生成目录，最后回退到书脊分节。可显示书内的常见位图，但不会运行书内脚本或加载远程内容。
• TXT 优先按 UTF-8（含 BOM）解码，失败后尝试 GB18030。自动识别“第一章”“第12章”等独立成行的章节标题；没有标题时整本书作为一个分节。
• 大型书籍首次打开会显示加载状态；EPUB 正文与图片按分节读取。损坏文件会在阅读标签页显示错误。本插件只读取小说文件，不修改原文。阅读进度保存在本机的 VS Code 扩展存储中，不会同步到其他设备。

验证

运行 npm test 检查文件筛选、TXT 解码与章节、EPUB 目录与内容安全、内容版本身份及进度存储。运行 npm run package 检查 VSIX 打包。