思阅插件版本首发

思阅 SiReader

让思源笔记变身电子书阅读器
支持智能标注、多主题切换、词典查询，打造沉浸式阅读体验
当前支持：EPUB 格式 | 未来计划：PDF、MOBI 等更多格式

📖 快速开始

🚀 安装插件

1. 在思源笔记中打开 设置 → 集市 → 插件
2. 搜索 "思阅" 或 "SiReader" 并安装
3. 启用插件后，工具栏会出现 📖 阅读器图标

📝 打开 EPUB 书籍

拖拽 EPUB 文件到思源文档中，会自动创建链接，点击链接即可打开

🎨 主要功能

📚 阅读体验

🎨 多主题切换

提供 8 款精美主题 + 自定义主题，适应不同阅读场景：

8 款预设主题：

自定义主题：

• 字体颜色：自定义文字显示颜色（支持 HEX 色值）
• 背景颜色：自定义页面背景色（支持 HEX 色值）
• 背景图片：上传自定义背景图片（支持 URL 或本地路径）
• 实时预览：修改后立即看到效果，支持导入导出配置

📱 阅读模式

• 分页模式：传统翻页体验，适合小说阅读
• 滚动模式：连续滚动，适合学术文档
• 单页显示：专注当前页面
• 双页显示：模拟纸质书阅读

⌨️ 便捷操作（待实现）

• 键盘导航：← → 方向键翻页
• 工具栏控制：上一页、下一页、目录按钮
• 快捷键支持：ESC 关闭菜单

📝 智能标注

🎨 7 色标注系统

使用 7 种颜色标记不同类型的内容：

📖 章节自动标记

• 标注时自动添加所在章节信息
• 标注格式：- R [标注文本（第三章）](链接#位置)
• 在标注面板中章节信息独立显示

📝 标注文档管理

两种管理模式：

1. 笔记本模式：为每本书在指定笔记本下创建独立文档
2. 文档模式：在指定文档下为每本书创建子文档

📚 目录导航

📂 三种浏览模式

1. 目录模式

• 章节导航：显示完整的书籍目录结构
• 层级展示：支持多级目录，自动缩进显示
• 进度显示：每章节显示阅读进度百分比
• 书签操作：悬停章节显示 📖 书签按钮，点击添加/删除书签
• 当前位置：高亮显示当前阅读的章节

2. 书签模式

• 书签列表：显示所有已保存的书签
• 快速跳转：点击书签直接跳转到对应位置
• 书签管理：悬停显示 🗑️ 删除按钮，一键删除书签
• 空状态提示：无书签时显示"暂无书签"提示
• 章节标题：显示书签所在的章节名称

3. 标注模式

• 标注列表：显示所有颜色标注内容
• 颜色分类：左侧颜色边框标识不同标注类型
• 内容展示：标注文本 + 章节信息分离显示
• 快速定位：点击标注直接跳转到原文位置
• 删除功能：悬停显示 🗑️ 删除按钮，管理标注内容

🔖 书签功能详解

添加书签方法：

1. 目录中添加：在目录模式下悬停章节，点击 📖 按钮
2. 阅读时添加：在阅读界面工具栏点击书签按钮
3. 自动保存：书签会立即保存到思源笔记数据库

书签样式特性：

• 视觉标识：已添加书签的章节显示红色 📖 图标
• 悬停效果：未添加书签时悬停显示透明图标
• 状态切换：点击切换添加/删除状态，即时响应

书签页面展示：

• 清晰布局：书签标题 + 章节位置信息
• 快速访问：点击任意书签立即跳转
• 批量管理：支持逐个删除管理

🎨 标注页面展示

标注内容布局：

• 主要文本：标注的原文内容，保持原始格式
• 章节信息：小字灰色显示，格式如"第三章"
• 颜色标识：左侧 3px 彩色边框，区分标注类型

标注交互功能：

• 点击跳转：点击标注内容直接定位到原文
• 悬停删除：悬停显示删除按钮，确认后删除
• 颜色识别：7 种颜色边框对应不同标注类型

🔍 智能搜索

• 实时搜索：输入关键词立即过滤章节
• 模糊匹配：支持中英文模糊搜索
• 搜索范围：仅在目录模式下生效
• 结果高亮：匹配的章节保持显示

📊 进度显示

• 章节进度：每章显示阅读百分比
• 进度条：底部彩色进度条可视化
• 自动更新：阅读时实时更新进度
• 持久保存：进度自动保存到数据库

📚 词典查询

🌐 多词典支持

支持 7 个专业词典源，自动选择最合适的词典：

🎯 智能识别

• 中文单字 → 自动选择汉字词典
• 中文词组 → 自动选择词语词典
• 英文词汇 → 自动选择剑桥词典

🖱️ 便捷操作

• 拖拽调整：可拖动词典窗口位置和大小
• Pin 固定：点击 📌 按钮固定窗口，避免误关闭
• 快捷关闭：ESC 键或点击外部区域关闭

⚙️ 设置说明

🎨 主题设置

1. 点击工具栏设置按钮 ⚙️
2. 选择 主题 选项卡
3. 在预设主题中选择喜欢的配色
4. 或选择"自定义"创建个人专属主题

📝 标注设置

1. 选择 标注 选项卡
2. 选择标注文档创建方式：
   • 笔记本模式：每本书创建独立文档
   • 文档模式：在指定文档下创建子文档
3. 设置目标笔记本或父文档

📖 阅读设置

1. 选择 阅读 选项卡
2. 设置翻页方式：
   • 点击翻页：点击页面区域翻页（已移除）
   • 仅工具栏：只能通过按钮翻页
3. 选择翻页动画效果
4. 设置单页或双页显示模式

🔧 通用设置

1. 选择 通用 选项卡
2. 设置书籍打开方式：
   • 新标签：在新标签页打开
   • 右侧标签：在右侧打开
   • 底部标签：在底部打开
   • 新窗口：在新窗口打开
3. 选择目录打开位置：
   • 窗口：弹窗显示
   • 左侧：左侧面板
   • 右侧：右侧面板

🎨 EPUB 块样式设置

支持多种 EPUB 块显示样式，让文档中的 EPUB 链接更加美观：

5 种块样式

设置方法

1. 单个设置：

   • 点击 EPUB 链接块左侧的块标图标
   • 在菜单中找到 插件 → EPUB样式
   • 选择喜欢的样式

2. 批量设置：

   • 点击文档右上角的菜单图标（···）
   • 在菜单中找到 插件 → 批量转换EPUB样式
   • 选择要应用的样式

3. 宽度调整：

   • 点击块标图标 → 插件 → 宽度
   • 卡片和封面样式支持宽度调整
   • 可通过滑块或输入数值调整
   • 支持 25%-100% 范围调整

自动功能

• 自动提取元数据：标题、作者、出版社、封面等
• 进度显示：显示阅读进度百分比
• 时间记录：显示最后阅读时间
• 封面缓存：自动上传和缓存书籍封面

💡 使用技巧

📖 高效阅读技巧

1. 主题切换：根据时间和环境选择合适主题
   • 白天使用"默认"或"杏仁黄"
   • 夜晚使用"夜间"或"暗黑"模式
2. 阅读模式：根据内容类型选择
   • 小说类：分页模式 + 单页显示
   • 学术类：滚动模式 + 双页显示

📝 标注管理技巧

1. 颜色分类法：

   • 🔴 红色：核心概念和重要理论
   • 🟡 黄色：一般重点和关键信息
   • 🟢 绿色：正面案例和成功经验
   • 🔵 蓝色：补充资料和扩展阅读
   • 🟣 紫色：疑问和需要进一步验证的内容

2. 标注整理：定期在标注模式下回顾所有标注内容

3. 标注导出：标注会自动保存到思源笔记文档，便于后续整理

🔖 书签管理技巧

1. 重要章节：为关键章节添加书签，便于快速返回
2. 阅读断点：暂停阅读时添加书签，下次快速继续
3. 参考标记：为需要反复查阅的章节添加书签
4. 批量清理：定期在书签模式下清理不需要的书签

📚 词典查询技巧

1. 快速查词：遇到生词直接双击选中查询
2. 固定窗口：学习时点击 📌 固定词典窗口
3. 多词典对比：切换不同词典标签对比释义

🎨 EPUB 块样式技巧

1. 图书收藏：使用"卡片"样式制作个人图书库
2. 阅读笔记：使用"边框"样式突出重点书籍
3. 快速预览：使用"阅读器"样式在文档中直接阅读
4. 封面展示：使用"封面"样式制作书籍展示墙
5. 宽度调整：根据屏幕大小调整卡片宽度获得最佳效果

❓ 常见问题

📱 使用问题

Q：EPUB 文件打不开？
A：检查文件格式是否为标准 EPUB，确保文件未损坏

Q：标注没有保存？
A：检查标注设置中是否正确配置了笔记本或父文档

Q：词典查询没反应？
A：检查网络连接，部分词典需要联网查询

Q：主题切换无效？
A：刷新阅读器页面，或重新打开 EPUB 文件

⚙️ 设置问题

Q：找不到设置按钮？
A：设置按钮在工具栏右侧，图标为 ⚙️

Q：标注文档在哪里？
A：根据设置的模式，在对应笔记本或文档下查找

Q：如何修改快捷键？
A：目前快捷键固定，后续版本将支持自定义

Q：EPUB 块样式无效？
A：确保 EPUB 文件已正确拖拽到文档中，点击块标图标通过菜单选择对应样式

Q：卡片样式不显示封面？
A：需要等待插件自动提取封面，提取较慢时可能需要几秒钟

Q：嵌入式阅读器无法操作？
A：点击阅读器内部激活焦点，然后可使用方向键翻页

Q：自定义主题不生效？
A：确保在主题设置中选择了"自定义"，并检查颜色值格式是否正确

🔧 技术架构

技术栈

设计理念

• 🎯 职责清晰：单一职责，模块化设计
• 🔗 松耦合：组合函数，依赖注入
• 📱 用户友好：现代 UI，智能交互
• ⚡ 性能优先：算法优化，内存管理
• 🛠️ 可扩展性：插件架构，配置化

性能优化

• 🚀 简洁高效：单行函数，链式操作
• 💾 智能缓存：标注缓存，进度防抖
• 🔄 响应式更新：直接数组操作，避免重载
• 🧹 内存管理：自动清理，防内存泄漏

🙏 致谢

• 感谢思源笔记团队提供的优秀软件，让插件开发变得更加便捷高效。
• 思源笔记插件开发指南 及其作者提供的详细开发文档
• 归叶插件开发者 vv 提供的 Vue3 + Vite 思源插件模板
• Epub.js 开源项目提供强大的 EPUB 渲染引擎

同时感谢所有使用和反馈的用户，您们的建议让思阅不断完善。

开发理念：极简、高效、优雅、完美
技术选型：Vue3 + Epub.js + 思源笔记 API
架构特点：模块化、组合式、响应式、可扩展