Novel Reader - VSCode小说阅读器
A powerful and comfortable TXT novel reader extension for Visual Studio Code. Perfect for reading novels during coding breaks!
一个强大舒适的VSCode小说阅读器扩展，让你在编程之余轻松阅读小说！
功能特性
📚 核心功能
- TXT文件阅读：支持UTF-8和GBK编码自动检测
- 章节智能识别：自动识别并解析章节结构
- 双阅读模式：
- 滚动模式：连续滚动阅读
- 翻页模式：分页阅读，支持翻页动画
- 阅读进度保存：自动保存并恢复阅读位置
- 文件历史记录：快速访问最近阅读的文件
- 书签功能：在重要位置添加书签标记
🎨 个性化设置
- 字体调整：实时调整字体大小（12px-32px）
- 主题切换：支持亮色/暗色主题，可跟随VSCode主题
- 自定义布局：可调整页面宽度、内边距、行高
- 章节模式配置：支持自定义章节识别正则表达式
安装与使用
安装方法
- 在VSCode扩展商店搜索"Novel Reader"
- 点击安装
- 重启VSCode
快速开始
- 使用快捷键
Ctrl+Alt+R (Mac: Cmd+Alt+R) 打开阅读器
- 选择要阅读的TXT文件
- 开始阅读！
快捷键
| 功能 |
Windows/Linux |
Mac |
| 打开阅读器 |
Ctrl+Alt+R |
Cmd+Alt+R |
| 下一章 |
Ctrl+→ |
Cmd+→ |
| 上一章 |
Ctrl+← |
Cmd+← |
| 增大字体 |
Ctrl+= |
Cmd+= |
| 减小字体 |
Ctrl+- |
Cmd+- |
| 添加书签 |
Ctrl+B |
Cmd+B |
| 切换阅读模式 |
Ctrl+M |
Cmd+M |
| 切换到资源管理器 |
Ctrl+E |
Cmd+E |
| 全屏模式 |
F11 |
F11 |
| 翻页（翻页模式） |
PageDown/PageUp |
PageDown/PageUp |
界面说明
活动栏
侧边栏视图
- 章节列表：显示所有章节，点击跳转
- 历史记录：最近打开的文件列表
- 书签：已保存的书签位置
阅读视图
- 顶部工具栏：
- 菜单按钮：显示/隐藏章节列表
- 章节标题和进度显示
- 字体大小调整按钮
- 主题切换按钮
- 阅读模式切换按钮
- 全屏按钮
- 内容区域：文本显示区
- 底部状态栏：字数统计和预估阅读时间
配置选项
在VSCode设置中搜索"novel-reader"可以找到所有配置项：
基础设置
novel-reader.fontSize：默认字体大小（默认：16）novel-reader.fontFamily：字体类型novel-reader.lineHeight：行高（默认：1.8）novel-reader.theme：主题模式（light/dark/auto）
布局设置
novel-reader.pageWidth：页面最大宽度（默认：800）novel-reader.padding：内容内边距（默认：40）
阅读设置
novel-reader.readingMode：默认阅读模式（scroll/page）novel-reader.pageAnimation：翻页动画（none/slide/fade）novel-reader.scrollSpeed：滚动速度倍数
功能设置
novel-reader.chapterPattern：章节识别正则表达式novel-reader.autoSaveProgress：自动保存阅读进度novel-reader.historyLimit：历史记录数量限制novel-reader.enableBookmarks：启用书签功能
章节识别
默认支持以下章节格式：
- 中文章节：第X章、第X回、第X节
- 英文章节：Chapter X
- 数字章节：1. 2. 3.
可通过设置自定义章节识别规则。
常见问题
Q: 如何处理乱码？
A: 插件会自动检测文件编码（UTF-8/GBK），如仍有乱码，请确保文件编码正确。
Q: 阅读进度丢失？
A: 确保"自动保存进度"选项已开启，进度会每30秒自动保存。
Q: 章节识别不准确？
A: 可以在设置中自定义章节识别正则表达式。
Q: 如何清除历史记录？
A: 目前需要通过命令面板执行清除命令。
开发
构建项目
npm install
npm run compile
调试
- 在VSCode中打开项目
- 按
F5 启动调试
- 在新窗口中测试扩展
打包
npm install -g vsce
vsce package
贡献
欢迎提交Issue和Pull Request！
许可证
MIT
更新日志
v1.0.3
- 修复：移除外部依赖(iconv-lite, chardet)避免打包问题
- 修复：解决市场版本无法正常运行的问题
- 改进：添加详细的调试日志
- 改进：简化文件编码检测逻辑
v1.0.2
- 修复：解决webview初始化时内容不显示的问题
- 改进：优化webview加载时序，使用ready事件确保正确初始化
v1.0.1
- 修复：解决扩展激活问题
- 修复：修复showMenu命令未找到的错误
- 改进：优化菜单系统为VSCode风格的可展开菜单
- 改进：彻底解决章节开头间距过大的问题
- 改进：实现类似资源管理器的子菜单展开效果
v1.0.0
- 初始版本发布
- 支持TXT文件阅读
- 章节自动识别
- 滚动和翻页两种阅读模式
- 阅读进度保存
- 历史记录功能
- 书签功能
- 主题切换
- 字体调整
| |
