Stealth Novel Reader (摸鱼小说阅读器)

极简、轻量、隐蔽高效的 VS Code 摸鱼小说阅读插件。小说以 // 伪装注释的形式直接在当前光标处呈现，支持智能标点断句、原位锁定、快捷翻页与实时进度记忆。

✨ 核心特性

• 🎭 极致伪装，不留痕迹
  • 采用 VS Code 原生虚拟文本装饰机制（Virtual Text Decoration）。
  • 绝不修改源码文件、不产生 Git Diff / 更改小圆点、不污染撤销栈（Ctrl+Z）、不影响代码编译与运行。
• 🧠 智能标点断句分页 (±20% 冗余)
  • 告别生硬机械的固定字数截断！在设定的字数（如默认 50 字）基础上，自动在 40 ~ 60 字区间内寻找最自然的标点断句位置。
  • 优先在句末符号（。、！、？、…）断句，次选停顿符号（，、；、、、：）。
  • 标点后的闭合引号（如 。”）自动完整纳入，阅读如同自然段落。
• 📊 末尾页码指示
  • 智能断句后自动留出空隙显示 当前页/总页数（例如：// 小说正文内容，停在逗号， 4/64053），进度一目了然。
• 📌 原位锁定，光标自由
  • 首次按下 Alt+E 后，小说文本牢牢锚定在首次触发的位置。
  • 鼠标可随意点击、光标可在任意函数间穿梭编辑，小说绝不随光标乱跑；翻页在原位刷新；再次按下 Alt+E 隐藏。
• ⚡ 毫秒级性能与多编码自适应
  • 插件打包体积仅约 15 KB，冷启动零延迟。
  • 针对上千万字的大型 TXT 小说秒级加载与流式清洗。
  • 自动识别兼容 UTF-8、UTF-8 BOM 与 GBK / GB2312 / GB18030 编码，中文阅读告别乱码。
• 💾 实时记忆与换书热重载
  • 翻页与跳转实时持久化保存进度，关闭或重启 VS Code 依然记住。
  • 更换小说文件路径后，按下 Alt+E 自动检测并重载最新内容与对应小说的历史进度。

⌨️ 快捷键说明

⚙️ 扩展配置项

在 VS Code 设置 (Ctrl+,) 中搜索 novelReader，或直接在 settings.json 中配置：

{
  // 小说 txt 文件的绝对路径（支持 Windows 路径与正反斜杠）
  "novelReader.filePath": "D:\\NOV\\WDHC.txt",

  // 每页基准字数（默认 50 字，智能断句算法会自动在 ±20% 范围内截断）
  "novelReader.pageSize": 50,

  // 是否在小说末尾显示页码进度（默认 true）
  "novelReader.showProgress": true,

  // 正文与页码之间的间隔空格（默认 4 个空格 "    "）
  "novelReader.progressGap": "    ",

  // 注释文本颜色（留空自动跟随编辑器默认行内文本颜色，也可指定如 "#6A9955"、"#8a8f86"）
  "novelReader.color": "",

  // 注释前缀（默认为 "// "）
  "novelReader.prefix": "// ",

  // 字体样式（"normal" 正常，或 "italic" 斜体）
  "novelReader.fontStyle": "normal"
}

💡 使用小技巧

1. 寻找最佳摸鱼位置：建议将光标放在两个函数之间的空行，或某个结构体声明下方，按下 Alt+E 开启阅读，伪装度极高！
2. 主题颜色完美融合：如果你希望小说颜色与当前主题的代码注释 100% 相同，可以把 novelReader.color 填入你主题的注释颜色代码（例如 #8a8f86 或 #6A9955）。

📄 License

MIT License