Sidecar - AI 助手小说阅读器
一个伪装成 AI 助手的 VSCode 插件，实际上是一个小说阅读/编码摸鱼工具。
功能特性
- 🤖 伪装界面：看起来像在写 TypeScript 代码和与 AI 对话
- 📖 小说阅读：支持多章节阅读，内容以代码形式展示
- 🔍 搜索功能：支持多网站搜索书籍和章节内容（支持 Ctrl+F）
- 📑 章节导航：快速切换章节（上一章/下一章/跳转）
- ⏹️ 可中断渲染：支持停止当前渲染过程
- 🌊 伪 AI 日志流：模拟 AI 助手的流式输出效果
- 🎨 代码风格：使用 VSCode 深色主题，完美融入开发环境
- 📍 左侧 Sidebar：在资源管理器中显示，方便随时访问
- 💾 本地缓存：自动缓存已下载的书籍，支持离线阅读
- 📚 书籍管理：支持搜索、下载、更新、阅读、删除书籍
- 📝 阅读记录：自动保存阅读进度，下次打开自动续读
- 📂 目录浏览：支持浏览预设的书籍目录，快速发现新书
- 🔗 URL 导入：支持通过书籍 URL 直接导入书籍
- 🖱️ 编辑器右键菜单：在编辑器中右键即可快速访问阅读功能（v0.0.4+）
安装
- 克隆或下载此项目
- 在项目目录运行：
npm install
npm run compile
- 按
F5 启动调试，或使用 vsce package 打包安装
使用方法
打开面板
- 安装插件后，在左侧活动栏找到 Sidecar 图标（💬 图标）
- 点击图标打开 "AI Assistant" 侧边栏面板
- 面板默认显示日志模式，展示操作历史记录
搜索书籍
在输入框中输入以下命令来搜索书籍：
搜索完成后，会显示搜索结果列表，包含书籍的：
- 书名、作者、状态、更新时间、最新章节
- 封面图片
- 操作按钮（下载/阅读）
注意：
- 搜索会从多个网站同时搜索，每个网站返回前 5 条结果
- 搜索超时时间为 15 秒，如果超时会显示错误提示
查看已缓存的书籍
在输入框中输入以下命令之一：
会显示所有已下载并缓存的书籍列表，每个书籍显示：
- 书名、作者、状态、更新时间、最新章节
- 当前阅读进度（第 X 章 / 共 Y 章）
- 操作按钮（更新/阅读/删除）
通过 URL 导入书籍
如果你有书籍的目录页面 URL，可以：
- 在书籍列表中找到 "打开 URL" 按钮（如果支持）
- 或者直接粘贴书籍 URL 到输入框（需要前端支持）
系统会自动识别 URL 并创建书籍信息，然后开始下载。
下载书籍
- 从搜索结果、书籍列表或目录中，点击书籍卡片上的 "下载" 按钮
- 下载过程会在日志中显示进度：
[1/100] 正在下载: 章节标题
- 下载完成后，书籍会被保存到本地缓存目录
- 新书籍下载第一章后会自动打开阅读
- 下载过程中可以继续使用其他功能（如阅读其他书籍）
注意：
- 同时只能下载一本书籍
- 如果书籍已存在，下载会跳过已有章节
- 下载过程中不会打断正在进行的阅读
更新书籍
- 从书籍列表中，点击书籍卡片上的 "更新" 按钮
- 系统会检查并只下载缺失的章节（增量更新）
- 更新过程会在日志中显示进度
注意：
- 同时只能更新一本书籍
- 更新过程中不会打断正在进行的阅读
- 更新只会下载新章节，不会重新下载已有章节
阅读书籍
开始阅读
- 从搜索结果、书籍列表或目录中，点击书籍卡片上的 "阅读" 按钮
- 如果书籍已缓存，会直接打开并显示章节内容
- 如果书籍未缓存，会提示先下载
- 系统会自动跳转到上次阅读的章节
阅读模式功能
进入阅读模式后，面板会切换到阅读界面，提供以下功能：
章节导航：
- ← 上一章：跳转到上一章节
- 下一章 →：跳转到下一章节
- 章节列表：点击章节信息（如"第 5 / 100 章"）可打开章节列表，快速跳转到指定章节
搜索章节内容：
- 在搜索框中输入关键词，按
Enter 或点击搜索按钮
- 支持在当前书籍的所有章节中搜索关键词
- 搜索结果会高亮显示匹配的内容
- 支持使用
Ctrl+F 进行浏览器原生搜索
停止渲染：
退出阅读模式：
- 点击 "清空" 按钮可退出阅读模式，返回日志模式
- 或者执行其他命令（如搜索、查看列表）也会自动退出阅读模式
阅读记录
- 系统会自动保存你的阅读进度
- 下次打开同一本书时，会自动跳转到上次阅读的章节
- 阅读进度会显示在书籍列表中的书籍信息里
删除书籍
- 从书籍列表中，点击书籍卡片上的 "删除" 按钮
- 系统会删除该书籍的所有缓存数据
- 如果正在阅读该书籍，会先关闭阅读模式
注意：
- 删除操作不可恢复，请谨慎操作
- 正在下载的书籍无法删除
日志模式
日志模式会显示所有操作的历史记录，包括：
- 用户输入的命令
- 搜索操作和结果
- 下载/更新进度
- 系统消息和错误提示
日志按时间倒序显示，最新的操作在最上方。
编辑器右键菜单（v0.0.4+）
在编辑器中右键点击，可以看到三个快捷命令：
- 阅读：显示所有已缓存的书籍列表，选择后打开最近阅读的章节
- 上一章：如果当前打开的是章节文件，快速跳转到上一章
- 下一章：如果当前打开的是章节文件，快速跳转到下一章
使用场景：
- 在编辑器中工作时，想快速切换到阅读模式，可以右键选择"阅读"
- 正在阅读章节文件时，可以使用"上一章"和"下一章"快速切换
- 系统会自动识别当前文件是否为章节文件，并自动更新阅读进度
快捷键
Ctrl+F：在阅读模式下搜索章节内容（浏览器原生搜索）Enter：在搜索框中提交搜索或提交命令
常见问题
Q: 搜索书籍时提示超时怎么办？
A: 搜索超时时间为 15 秒。如果网络较慢，可以：
Q: 下载的书籍保存在哪里？
A: 书籍缓存保存在 VSCode 的全局存储目录中，具体路径可以通过日志查看。
Q: 如何清除缓存？
A: 可以手动删除 VSCode 的全局存储目录中对应的缓存文件夹，或者使用删除功能删除不需要的书籍。
Q: 阅读时如何快速跳转到指定章节？
A: 在阅读模式下，点击章节信息（如"第 5 / 100 章"）会打开章节列表，可以快速跳转到指定章节。
Q: 下载过程中可以阅读其他书籍吗？
A: 可以。下载是后台进行的，不会影响阅读其他已缓存的书籍。
Q: 更新书籍会重新下载所有章节吗？
A: 不会。更新功能只会下载缺失的章节，已存在的章节不会重新下载。
Q: 如何通过 URL 导入书籍？
A: 目前支持通过书籍列表中的 URL 导入功能，或者直接粘贴书籍目录页面的 URL（需要前端支持）。
Q: 可以同时下载多本书吗？
A: 不可以。同时只能下载或更新一本书籍，但可以在下载的同时阅读其他已缓存的书籍。
Q: 如何使用编辑器右键菜单功能？
A: 在编辑器中右键点击，选择"阅读"可以快速打开书籍列表；如果当前打开的是章节文件，可以使用"上一章"和"下一章"快速切换章节。
更新日志
v0.0.4 (最新)
- ✨ 新增编辑器右键菜单功能
- 添加"阅读"命令：快速打开书籍列表并选择阅读
- 添加"上一章"命令：快速跳转到上一章节
- 添加"下一章"命令：快速跳转到下一章节
- 自动识别章节文件并更新阅读进度
v0.0.3
- 初始版本发布
- 支持书籍搜索、下载、阅读、更新、删除
- 支持章节导航和内容搜索
- 支持本地缓存和阅读记录
许可证
MIT
