VSReader

VSReader 是一款运行在 VS Code 中的小说阅读扩展。你可以直接打开本地 TXT，也可以导入兼容的 Legado JSON 书源，在编辑器里完成搜索、加入书架、章节阅读和进度保存。

它适合希望把阅读集中在 VS Code 内完成的用户：无需额外启动独立阅读器，书架、书源、搜索和正文都在同一个阅读中心里管理。

主要功能

• 本地 TXT 阅读：支持 UTF-8、UTF-16 BOM 和 GB18030 编码，并自动识别常见章节标题生成目录。
• Legado 书源：支持导入单个书源、书源数组，以及 sources / bookSources 包装格式的 JSON。
• URL 导入：可以直接通过 HTTP(S) JSON 地址添加书源。
• 多书源搜索：在已启用的书源中按书名或作者搜索，并可选择参与搜索的书源。
• 书架与进度：搜索到的小说可加入书架，阅读章节与进度会自动保存。
• 章节阅读：支持目录选择、上一章 / 下一章、阅读宽度、字号、行高与主题设置。
• 书源账号与 Cookie：支持兼容书源提供的账号动作、Cookie 和源变量，并使用 VS Code SecretStorage 保存敏感信息。
• 连接设置：支持自动代理、直接连接和指定 HTTP(S) 代理，并提供请求记录用于排查连接问题。

开始使用

安装扩展后，点击 VS Code 左侧活动栏中的 VSReader 图标即可打开阅读中心。

阅读本地小说

进入 书架，点击 打开本地 TXT 并选择小说文件。VSReader 会解析章节目录，并在后续阅读时保存进度。原始 TXT 文件不会被修改。

导入书源

进入 书源 页面，可以：

• 选择 导入 JSON 文件 导入本地 Legado 书源；
• 选择 从 URL 导入，粘贴 HTTP(S) JSON 地址。

导入后可以单独启用或停用书源，并根据书源能力使用账号、Cookie、源变量或设置功能。

搜索与阅读

进入 搜索 页面，输入书名或作者。搜索结果可以直接打开，也可以加入书架。阅读界面提供目录、上一章、下一章等常用操作。

默认快捷键：

• Ctrl+Alt+R：打开 VSReader
• Ctrl+Alt+←：上一章
• Ctrl+Alt+→：下一章

macOS 对应使用 Cmd+Option 组合键。

阅读设置

在 设置 页面可以调整：

• 正文字号
• 行高
• 阅读区域宽度
• 跟随 VS Code / 纸张 / 夜间主题
• 请求超时
• 同时搜索书源数量
• 网络连接方式

书源兼容性

VSReader 面向小说文本阅读，兼容常见的 Legado JSON 书源规则，并实现了 JSONPath、常用 CSS 选择器、正则替换、模板和部分 JavaScript 规则支持。

由于不同书源可能依赖 Android / Java 专用接口、复杂 JSoup 对象、XPath、网页验证或特定运行环境，无法保证所有 Legado 书源都能完整运行。听书、漫画、短剧播放器以及部分高度依赖原 App 环境的功能不属于当前版本的主要支持范围。

隐私与安全

账号密码、Cookie 和代理凭据会通过 VS Code SecretStorage 保存，不会以明文写入普通扩展状态文件。书架、书源规则和阅读设置保存在 VS Code 的扩展数据目录中。

书源本身可能包含脚本并访问其声明的网络地址，因此请只导入你信任的书源。

系统要求

• VS Code 1.95.0 或更高版本
• Windows、macOS 或 Linux 桌面版 VS Code

当前不支持网页版 vscode.dev。

许可

VSReader 使用 MIT License。第三方运行组件及其许可信息见 THIRD_PARTY_NOTICES.md。