VS Reader - VS Code 电子书阅读器

一款强大的 VS Code 扩展，支持在编辑器中直接阅读多种电子书格式，并自动记录阅读位置。

功能特点

📚 多格式支持：TXT、EPUB、MOBI、PDF 四种格式
📖 阅读位置记录：自动保存阅读进度，下次打开自动跳转
📑 目录导航：自动识别章节结构，快速跳转
📊 阅读进度条：直观显示当前阅读进度
🔤 字体调节：支持字体大小调整
🌓 主题切换：支持亮色/暗色/跟随系统主题
⌨️ 快捷键支持：键盘快速导航
📱 响应式设计：适配不同窗口大小

使用方法

安装

在 VS Code 扩展商店搜索 "VS Reader" 并安装
或手动安装 VSIX 包

支持的文件格式

格式	扩展名	说明
TXT	`.txt`	纯文本文件，支持按章节标记分割
EPUB	`.epub`	标准电子书格式，支持目录和元数据
MOBI	`.mobi`	Amazon Kindle 格式
PDF	`.pdf`	Adobe PDF 格式，支持文本提取

打开文件

直接在 VS Code 中双击 .txt/.epub/.mobi/.pdf 文件
扩展会自动以阅读器模式打开，显示友好的阅读界面

阅读控制

操作	方式
翻页	点击"上一章/下一章"按钮
键盘翻页	←/→ 方向键或 PageUp/PageDown
跳转章节	点击左侧目录中的章节
首章/末章	Home / End 键
切换目录	点击工具栏"进度"按钮或按 T 键
字体放大	点击 A+ 按钮
字体缩小	点击 A- 按钮
主题切换	点击 🌙/☀️ 按钮

命令

VS Reader: 显示阅读进度 - 查看所有书籍的阅读记录
VS Reader: 重置阅读进度 - 重置当前文件的阅读进度

阅读位置存储

阅读位置自动保存在 VS Code 的全局状态中
关闭文件后重新打开会自动跳转到上次阅读位置
支持多本书籍的阅读历史

开发

# 克隆项目
git clone https://github.com/your-username/vsreader.git

# 安装依赖
cd vsreader
npm install

# 构建
npm run build

# 调试
按 F5 启动扩展开发模式

项目结构

vsreader/
├── src/
│   ├── extension.ts          # 扩展入口
│   ├── readerDocument.ts     # 文档模型
│   ├── readerProvider.ts     # 自定义编辑器提供者
│   ├── storage.ts            # 阅读位置存储
│   ├── readers/
│   │   ├── txtReader.ts      # TXT 读取器
│   │   ├── epubReader.ts     # EPUB 读取器
│   │   ├── mobiReader.ts     # MOBI 读取器
│   │   └── pdfReader.ts      # PDF 读取器
│   └── webview/
│       ├── readerView.ts     # Webview 视图管理器
│       ├── reader.js         # 前端阅读器逻辑
│       └── styles.css        # 阅读器样式
├── dist/                     # 构建输出
├── package.json
├── tsconfig.json
└── esbuild.js                # 构建配置

技术栈

TypeScript - 开发语言
VS Code Extension API - 自定义编辑器、Webview
pdfjs-dist - PDF 解析
jszip - EPUB (ZIP) 解析
esbuild - 构建工具

许可

MIT