📚 X Reader 小说阅读器
在 VS Code 中阅读与创作小说，并与 Copilot 共创写作。
导入本地 txt，自动解析为 Markdown 章节书库；内置书架、章节目录、卷/章节/区间摘要（含计划摘要）、世界书、角色卡与笔记视图；全程 Git 快照可回溯，并向 Copilot 暴露完整的语言模型工具，实现「边读边写」的共创体验。
功能特性
- 导入与新建：导入本地 txt（自动识别 UTF-8 / UTF-16 / GB18030 编码），或新建空白书从零写作。
- 卷/章自动解析：识别「第 X 卷 / 第 X 章」两级目录，支持中文数字、阿拉伯数字及「序章 / 楔子 / 番外」等特殊章节。
- 书架与章节目录：活动栏七视图——书架、元数据、章节目录、摘要、世界书、角色卡、笔记，随当前书联动。
- 子书架：在书架视图中自建分组，分类可任意层级（如
题材/同人/XXX），书以链接形式收录（不复制），改名 / 删除自动级联同步。
- 阅读进度：自动记录阅读位置，打开即恢复；状态栏显示当前书与进度，点击一键回到上次章节。
- 卷 / 章节 / 区间摘要：每卷一份卷摘要（含「章节范围」与「摘要」两节，不写计划），每章一份章节摘要，区间摘要起止任意（默认可按每 10 章一块建，也可自定义长度、互相重叠），点击即建，边读边回顾；摘要跟不上正文改动时标 ⚠ 提醒维护。
- 计划摘要：摘要可以先于正文存在——为尚未创建的章节写
序号-标题 的计划摘要（还能插到已有章节中间，其后的序号自动顺延），为还没写到的章节写区间计划；摘要视图里点 ✎ 计划节点的「按计划写正文」即可就地落成正文，正文创建时摘要自动接手并转为 ⚠ 提醒按正文核对。卷摘要不写计划：卷内还有计划章节时它标 ✎ 计划，否则只按修改时间标 ✓ / ⚠。
- 章节多版本：为同一章保留多个备选草稿，随时把任意版本设为主版本，原主版本自动存档。
- 世界书与角色卡：维护世界观设定与角色档案，写作时随手可查。
- 条目分类：世界书、角色卡、笔记三处一致——子目录即分类，支持多级嵌套（如
地理/城邦），视图内折叠展开；分类可新建子分类、重命名、删除，条目可归入任意层级、可移动到其它分类（笔记的章节关联链接自动重算），也可直接放在根目录。
- 笔记系统：支持分类目录与章节关联，阅读批注与创作大纲尽收其中。
- 任意位置插章：新建章节时可选接在全书末尾，或插在任意章节之前 / 之后（按标题或序号搜索定位）；插到中间时其后章节序号自动顺延，前后导航、摘要、关联笔记与阅读进度一并同步。
- 章节改名级联同步：右键重命名或直接修改章节标题，文件名、前后章导航、摘要、关联笔记与阅读进度全部自动同步，不留死链。
- Git 快照：每次导入、新建、重命名、删除均自动提交快照，可随时回溯；也可一键清除历史、以当前文件重建仓库。
- 朗读联动 x-audio：与 x-audio 朗读助手 联动，一键朗读当前章节（普通 / 分角色），无需离开阅读界面。
- 与 Copilot 共创：注册 13 个语言模型工具，Copilot 可直接读写书库。
- 中英文本地化：界面自动跟随 VS Code 显示语言（中文 / English）。
快速开始
- 在 VS Code 扩展商店安装 X Reader（或命令行
code --install-extension）。
- 点击活动栏「小说阅读」进入书架。
- 点击「导入小说」选择本地 txt，或「新建书籍」从零开始。
- 点击书名打开第一章开始阅读；编辑器标题栏的「上一章 / 下一章」随手翻章。
界面导览
| 视图 |
用途 |
| 书架 |
子书架（多级分类）→ 书，导入、新建、打开、删除书籍 |
| 元数据 |
当前书 元数据.md 的字段与小节，点击跳到对应行编辑 |
| 章节目录 |
卷 → 章两级目录，自动跟随阅读进度 |
| 摘要 |
卷摘要 / 章节摘要 / 区间摘要（起止任意、可改可删），点击即建（✓ 最新 / ⚠ 待维护 / ✎ 计划） |
| 世界书 |
世界观设定条目（支持多级分类） |
| 角色卡 |
角色档案（支持多级分类） |
| 笔记 |
分类笔记，可关联章节 |
朗读联动（x-audio）
安装 x-audio 朗读助手 并配置好 TTS 密钥后，可在阅读界面直接朗读：
| 入口 |
说明 |
| 章节页签标题栏 🔊「朗读本章」 |
普通朗读当前章节正文（自动去掉 Markdown 标记与底部导航） |
| 章节页签标题栏 👥「分角色朗读本章」 |
由 x-audio 自动识别角色与对白，逐角色分配音色朗读 |
| 章节目录右键「朗读本章 / 分角色朗读本章」 |
对指定章节朗读，无需先打开 |
| 章节编辑器右键「朗读选中文本」 |
只朗读选中的片段 |
- 长章节超过单次合成上限时，x-audio 会自动分块合成并顺序播放。
- 分角色朗读会从本书的角色卡读取角色音色：在角色卡里写一行
- 音色：female-yujie（或 音色: xxx、frontmatter voice: xxx / voiceId: xxx），即为该角色固定音色；可选 - 类型：男/女/少女/少年/幼童/老人/旁白 把音色同时映射到角色类型；名为「旁白」的卡片自动作为旁白音色。没有卡片带音色时回退到章节目录向上查找 .ttsvoices.json。
- 未安装 x-audio 时点击朗读入口会弹出安装引导。
与 Copilot 共创
在 Copilot Chat 中直接操作你的书库，例如：
- 「我上次读到哪了？」——自动定位当前书与进度
- 「根据前五章帮我写下一章」——自动新建章节、重排全书导航
- 「整理第 1–10 章的摘要」——读取章节并撰写区间摘要
- 「先规划第二卷的走向」——给第二卷的章节写计划摘要（
xReader_manageChapter 的 plan=true）或写区间计划
- 「把第 21 章的计划插在第 5 章之后」——顺延其后的章节序号并生成计划摘要
- 「新建角色卡：林晚，外冷内热的医者」——建卡并打开供完善
扩展注册了 14 个结构化工具：读类（获取当前上下文、列书 / 卷 / 章 / 条目、读卷 / 章节 / 区间摘要与计划摘要、设置进度）与写类（书籍 / 分卷 / 章节 / 章节版本 / 区间摘要 / 条目 / 分类的新建、重命名、移动、插入、改区间与删除）。条目与分类用 kind 参数区分世界书 / 角色卡 / 笔记，写操作再用 action 参数区分具体动作，因此同类能力只需一个工具。章节正文的读写搜索直接用内置文件工具即可。所有写操作自动落在 Git 快照中，放心交给 Copilot。
设置
| 设置项 |
说明 |
xReader.libraryPath |
书库目录路径（每本书一个文件夹）。留空时，下次导入或新建书籍会弹窗选择目录。 |
常见问题
导入后章节目录不准确？
编码或排版格式特殊的 txt 可能解析不完整。可在章节目录中手动重命名章节，或改正文首行 # 标题 保存，两处会自动级联同步。
支持哪些编码？
UTF-8（含 BOM）、UTF-16 LE/BE、GB18030。
章节改名后前后章的跳转链接没变？
直接用章节目录右键「重命名章节」，或改章节正文首行标题后保存，两者效果一致，会同步更新文件名、导航链接、摘要镜像、关联笔记与阅读进度。不要用文件管理器直接改文件名，否则导航会留下死链。
发布说明
详细变更记录见 CHANGELOG.md。
许可证
MIT
| |
