番茄阅读（fanqieReader）

在 VS Code 侧边栏浏览番茄小说书架，在底部 fanqieReader Panel 内以终端风格阅读章节。

本扩展通过番茄小说官网读取章节。“番茄小说”等名称、标识和内容归其权利人所有。

功能

• 通过书籍 ID、详情页链接或章节链接直接打开公开内容。
• 仅通过官网读取正文；公开章节直接阅读，受限章节使用扩展中保存的账号会话重试。
• 章节显示在 Problems、Output、Terminal 同一区域的 fanqieReader Tab，不占用编辑器标签页。
• 阅读区模拟终端输出，顶部提示符和三行 [INFO] 状态在滚动时固定。
• 底部上一章、下一章按钮常显，阅读面板标题栏也提供左右箭头；无相邻章节时禁用对应按钮。
• Alt+PageUp / Alt+PageDown 切换上一章 / 下一章。
• 默认访客阅读；点击“登录并同步书架”才显示登录面板，支持官网扫码、短信验证码和官方小窗口登录。
• 已有账号时，受限章节会自动以该账号重试一次，按服务端返回的阅读权限显示内容。
• 登录后载入个人书架，后台限流补全并缓存书名与作者，支持按卷浏览目录、继续阅读和一键全部折叠。
• 自动适配 VS Code 深色/浅色主题，可调整字号、行高和正文宽度。
• 不绕过付费、锁定章节或账号权限。

安装

从 VS Code Marketplace

发布后，在 VS Code 扩展视图中搜索“番茄阅读”，选择发布者与仓库信息匹配的版本安装。

从 GitHub Release 的 VSIX

1. 下载网页阅读版 VSIX；扩展包不含移动端运行组件。
2. 在 VS Code 中运行 Extensions: Install from VSIX...。
3. 选择下载的 VSIX，安装后按提示重新加载窗口。

如果曾安装发布者为 local 的早期测试版，请先卸载 local.fanqie-reader，只保留发布者为 Zo1Xu 的版本。两个扩展 ID 同时存在会重复注册侧栏命令，并且登录数据无法互通。

也可使用命令行：

code --install-extension .\fanqie-reader-0.7.12.vsix

使用

1. 在活动栏打开番茄图标。
2. 未登录时可粘贴书籍 ID、详情页链接或章节链接直接阅读公开内容。
3. 需要个人书架或使用已有账号阅读权限时，点击“登录并同步书架”。可选择扫码、短信验证码或官方小窗口登录，也可点击“暂不登录”关闭面板。
4. 选择书籍和章节后，底部 fanqieReader Panel 会自动打开。
5. 使用目录、悬浮控制区或快捷键切换章节。

推荐扫码登录： 使用番茄小说 App 扫描二维码，无需在扩展中输入手机号、验证码或密码，登录流程更直接。

扫码和侧边栏登录支持 Chrome、Edge、Brave、Vivaldi、Opera、Arc、Firefox、Chromium，以及 macOS 自带的 Safari，覆盖 Windows、macOS 和 Linux 常见安装位置。二维码默认只显示在侧边栏；若直接扫描不成功，可点击二维码下方的提示打开纯白大图页。若浏览器位于自定义路径，请设置 fanqieReader.browserPath；macOS 可直接填写 /Applications 或 ~/Applications 下的 .app 路径。

Firefox 使用隔离的 WebDriver 临时会话，不读取日常浏览数据。若系统尚未安装 geckodriver，首次使用时 Selenium Manager 会联网解析并缓存匹配版本；受代理或防火墙限制时，可自行安装 geckodriver 并加入 PATH。

仅使用 Safari 时，需要先允许 WebDriver 自动化：在 Safari 的“开发”菜单中打开“开发者设置”，勾选“允许远程自动化”；也可以在终端运行 safaridriver --enable。扩展使用 Safari 独立的临时自动化窗口，不读取日常浏览记录或已有 Cookie。Safari 扫码时会同时显示侧边栏二维码和官方 Safari 二维码窗口；若侧边栏识别困难，可直接扫描 Safari 窗口，但无需点击窗口。Safari 会阻止用户操作 WebDriver 自动化窗口，因此短信登录一旦触发手动滑块，扩展会结束该会话并提示改用扫码登录、Chromium 系浏览器或 Firefox；点击系统弹窗中的“Continue Session”只会继续自动化，不会允许手动拖动。

登录与数据

• 二维码和验证码使用后台创建的番茄官方登录会话。
• 仅在番茄触发交互式风控时打开受控的官方验证窗口；扩展不会破解或绕过验证。
• 手机号和短信验证码只存在于当前登录会话内，不写入设置、工作区文件或日志。
• 密码只在番茄官方页面中输入，扩展不读取或保存密码。
• 登录 Cookie 保存到 VS Code SecretStorage。
• 公开章节优先匿名读取；受限章节才尝试已保存的账号会话。登录成功后自动重试当前可见的受限章节。
• 阅读正文不启动浏览器；浏览器仅用于用户主动发起的登录流程。
• 阅读进度保存在 VS Code 本地，不同步回番茄账号。
• 执行“番茄阅读：退出登录”会清除登录 Cookie，但保留本地阅读进度。

详细内容见 PRIVACY.md 和 SECURITY.md。

设置

常用命令

• 番茄阅读：通过 ID 或链接打开
• 番茄阅读：显示底部阅读区
• 番茄阅读：上一章 / 下一章
• 番茄阅读：侧边栏登录（扫码 / 验证码）
• 番茄阅读：在官方小窗口中登录
• 番茄阅读：手动导入 Cookie（高级）
• 番茄阅读：退出登录
• 番茄阅读：刷新书架
• 番茄阅读：复制阅读诊断（读取失败时用于排查，不包含账号、设备标识或正文）

已知限制

• 试读范围外的章节需要账号具有官网网页阅读权限；在浏览器登录后，还需在扩展中登录同一账号。
• 官网仍返回试读或请求失败时会显示原因，不把试读内容标记为全文。
• 网页结构或接口变化可能导致功能失效。
• 密码输入和交互式风控必须在番茄官方窗口中完成；Safari 无法手动操作 WebDriver 窗口中的滑块，此时请使用扫码登录、Chromium 系浏览器或 Firefox。
• 首个公开版本不把进度同步回番茄账号。
• 请遵守番茄小说服务条款和内容版权要求，不要用于批量抓取或内容再分发。

许可证

扩展源码按 GNU Affero General Public License v3.0 only 发布。小说正文、网站内容、商标及第三方资源不属于本许可证授权范围。