月亮小说阅读

一个用于在 VS Code / Cursor 状态栏安静阅读本地小说的轻量插件。正文仅显示在状态栏，不打开额外编辑器，也不会上传您的书籍或阅读记录。

功能

• 添加一个或多个本地 .txt / .md 书籍
• 自动兼容 UTF-8、UTF-16 和常见的 GBK/GB18030 中文文本
• 点击状态栏书架图标添加新书或切换当前书籍
• 书架列表按已读文字量准确显示每本书的阅读进度百分比
• 在底部状态栏显示当前句子
• 状态栏不显示书名，只保留书架和阅读模式图标
• 开启阅读模式后使用键盘 ← / → 或数字键 3 / 4 翻页，关闭后恢复按键原功能
• 侧边聊天、行内聊天、终端、搜索框和命令输入框获得焦点时暂停快捷键劫持
• 长句自动连续分页，翻页不会跳过未显示的文字
• 自动保存每本书的阅读进度
• 多个 VS Code 窗口共享并实时同步同一本书的阅读进度
• 切换书籍时分别保存并恢复每本书上次阅读的位置
• 使用正文字符位置和文字锚点保存进度，重启或调整显示宽度后仍能定位原文
• 悬停正文查看完整句子和阅读进度
• 停止翻页一段时间后通过隐私模式自动隐藏正文和悬浮内容，再次翻页立即恢复
• 查询正文并通过前后按钮循环切换匹配句子，面板实时显示当前位置和匹配总数

使用

1. 打开命令面板，执行 月亮小说阅读：添加书籍。
2. 选择本地 .txt 或 .md 文件。
3. 点击状态栏眼睛图标开启阅读模式，使用 ← / 3 向前翻、→ / 4 向后翻。
4. 再次点击眼睛图标关闭阅读模式，相关按键恢复 VS Code 原功能。
5. 点击书架图标可继续添加新书或切换书籍。
6. 如需删除书架记录，执行 月亮小说阅读：移除书籍。
7. 点击状态栏搜索图标查询正文；面板内使用前后按钮切换匹配位置，标题会显示当前位置和匹配总数，也可按 Enter 跳到下一处。

状态栏正文默认固定显示 80 列，可通过设置 novelReader.maxDisplayLength 调整。隐私模式默认在停止翻页 60 秒后触发，可通过 novelReader.bossModeIdleSeconds 修改等待时间。

隐私与数据

• 插件只读取您主动选择的本地 .txt / .md 文件。
• 书架和阅读进度保存在 VS Code 的扩展全局存储中，用于跨窗口同步和恢复阅读位置。
• 插件不会收集个人信息，不包含统计、广告或网络请求，也不会上传书籍正文。
• 删除书架记录只会移除插件中的记录，不会删除原始文件。

完整说明参见 PRIVACY.md。

兼容性

• VS Code 1.90.0 及以上版本
• 支持兼容 VS Code 扩展的 Cursor
• 支持 UTF-8、UTF-16、GBK 和 GB18030 中文文本

本地开发

npm install
npm run compile
npm run package

反馈

如有问题或建议，请通过 GitHub Issues 反馈。