X Reader 小说阅读器

在 VS Code 中阅读与创作小说，并与 Copilot 共创写作。 Read and write novels right inside VS Code, co-created with Copilot.

导入本地 txt 小说，自动解析为 Markdown 章节书库；内置书架、章节目录、摘要、世界书、角色卡与笔记视图，全程 Git 快照可回溯，并向 Copilot 暴露完整的语言模型工具，实现"边读边写"的共创体验。

✨ 功能特性

• 导入与新建：导入本地 txt 小说（自动识别 UTF-8 / UTF-16 / GB18030 编码），或新建空小说从零写作。
• 卷/章自动解析：识别「第 X 卷 / 第 X 章」两级目录，支持中文数字、阿拉伯数字及「序章 / 楔子 / 番外」等特殊章节名。
• 书架与章节目录：活动栏六视图——书架、章节目录、摘要、世界书、角色卡、笔记，各视图随当前书联动。
• 阅读进度：自动记录阅读位置，重新打开即恢复；状态栏显示当前书与进度，点击一键回到上次章节。
• 章节 / 区间摘要：每章一份摘要，每 10 章一份区间摘要，点击即建、边读边回顾。
• 世界书与角色卡：维护世界观设定与角色档案，写作时随手可查。
• 笔记系统：支持分类目录与章节关联，阅读批注与创作大纲一网打尽。
• 章节改名级联同步：右键重命名或直接改章节标题保存，文件名、前后章导航、摘要、关联笔记与阅读进度全部自动同步，绝不留下死链。
• Git 快照：每一次导入、新建、重命名、删除都自动提交快照，随时回溯任何版本。
• 与 Copilot 共创：注册 30 个语言模型工具，Copilot 可直接读写你的书库。
• 中英文本地化：界面自动跟随 VS Code 显示语言（中文 / English）。

🚀 快速开始

1. 在 VS Code 扩展商店安装 X Reader（或命令行 code --install-extension）。
2. 点击活动栏「小说阅读」进入书架。
3. 点击「导入小说」选择本地 txt，或「新建小说」从零开始。
4. 点击书名打开第一章开始阅读；编辑器标题栏的「上一章 / 下一章」随手翻章。

界面导览

🤖 与 Copilot 共创

在 Copilot Chat 中直接操作你的书库，例如：

• 「我上次读到哪了？」——自动定位当前书与进度
• 「根据前五章帮我写下一章」——自动新建章节、重排全书导航
• 「整理第 1–10 章的摘要」——读取章节并撰写区间摘要
• 「新建角色卡：林晚，外冷内热的医者」——建卡并打开供完善

扩展注册了 30 个结构化工具（列书 / 列卷 / 列章、读摘要、设置进度、新建 / 重命名 / 删除 卷章书与条目），章节正文的读写搜索直接用内置文件工具即可。所有写操作自动落在 Git 快照中，放心交给 Copilot。

⚙️ 设置

❓ 常见问题

导入后章节目录不准确？ 编码或排版格式特殊的 txt 可能解析不完整。可在章节目录中手动重命名章节，或改正文首行 # 标题 保存，两处会自动级联同步。

支持哪些编码？ UTF-8（含 BOM）、UTF-16 LE/BE、GB18030。

章节改名后前后章的跳转链接没变？ 直接用章节目录右键「重命名章节」，或改章节正文首行标题后保存，两者效果一致，会同步更新文件名、导航链接、摘要镜像、关联笔记与阅读进度。不要用文件管理器直接改文件名，否则导航会留下死链。

📝 发布说明

详细变更记录见 CHANGELOG.md。

0.1.0

• 导入 / 新建小说，卷章自动解析；
• 书架、章节目录、摘要（章节 / 区间）、世界书、角色卡、笔记六视图；
• 阅读进度自动记录与恢复；
• 章节改名级联同步（右键 ↔ 改首行，效果一致）；
• 30 个 Copilot 语言模型工具，共创写作；
• 全链路 Git 快照；
• 中英文本地化。

📄 许可证

MIT