AI 集成
使用 AI 助手增强阅读体验
小幻阅读的书籍阅读器集成了 AI 对话功能，可以帮助您理解书籍内容、翻译文本、回答问题。
支持的 AI 服务
| 服务类型 | 说明 |
|---|---|
| OpenAI | OpenAI 官方及所有兼容 API 格式的服务 |
| Claude | Anthropic Claude API 及兼容服务 |
| Gemini | Google AI Studio 或 Vertex AI |
| Azure OpenAI | 微软 Azure OpenAI 企业级服务 |
兼容性说明
OpenAI 和 Claude 类型支持使用兼容 API 的第三方服务（如 DashScope、OpenRouter 等），只需配置对应的 Base URL 即可。
配置 AI 服务
添加服务商
- 打开应用设置
- 进入 AI 配置页面
- 点击添加服务商
- 选择服务类型并填写配置信息
配置项说明
| 配置项 | 说明 |
|---|---|
| 名称 | 自定义名称，便于识别 |
| 服务类型 | OpenAI / Claude / Gemini / Azure OpenAI |
| Base URL | API 端点地址 |
| API Key | 服务商提供的密钥 |
Base URL 示例
| 服务 | Base URL |
|---|---|
| OpenAI 官方 | https://api.openai.com/v1 |
| Claude 官方 | https://api.anthropic.com/v1 |
| Gemini 官方 | https://generativelanguage.googleapis.com/v1beta |
| Azure OpenAI | https://{resource-name}.openai.azure.com |
| DashScope | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| OpenRouter | https://openrouter.ai/api/v1 |
安全提示
API 密钥会使用 Windows 凭据管理器加密存储，但请勿在公共设备上保存敏感密钥。
管理模型
每个服务商可以配置多个模型：
- 预设模型：常用模型已预先配置
- 自定义模型：手动添加服务商支持的模型 ID
AI 聊天面板
在书籍阅读器中，点击侧边栏的 AI 标签打开聊天面板。
界面组成
| 区域 | 功能 |
|---|---|
| 模型选择器 | 切换当前使用的 AI 模型 |
| 模式选择器 | 选择对话模式（系统提示词） |
| 消息列表 | 显示对话历史 |
| 输入框 | 输入问题或指令 |
| 会话管理 | 创建、切换、删除会话 |
对话模式
对话模式定义了 AI 的行为方式，通过设置系统提示词来实现：
| 模式 | 说明 |
|---|---|
| 默认 | 通用助手模式 |
| 阅读助手 | 专注于帮助理解书籍内容 |
| 翻译 | 翻译所选文本 |
| 自定义 | 用户自定义的模式 |
您可以创建自定义模式，定义专属的系统提示词。
AI 工具调用
AI 助手可以执行特定操作来辅助阅读，这些操作称为"工具"。
可用工具
| 工具 | 功能 | 说明 |
|---|---|---|
| 获取目录 | 读取书籍目录 | AI 了解书籍结构 |
| 获取当前章节 | 读取当前章节内容 | AI 了解您正在阅读的内容 |
| 获取指定章节 | 读取特定章节 | 根据章节 ID 获取内容 |
| 获取选中文本 | 读取划词内容 | AI 了解您选中的文本 |
| 跳转章节 | 导航到指定章节 | AI 帮您跳转 |
| 跳转位置 | 导航到指定位置 | 精确定位 |
| 搜索书籍 | 全文搜索 | 支持正则表达式 |
工具执行流程
- 用户提问
- AI 判断是否需要调用工具
- AI 请求执行工具（显示确认对话框）
- 用户批准或拒绝
- 工具执行并返回结果
- AI 基于结果生成回答
用户控制
所有工具调用都需要您的批准才会执行。您可以在弹出的确认对话框中选择允许或拒绝。
工具使用示例
示例 1：询问书籍内容
用户：这本书讲了什么？
AI：[调用获取目录]
AI：根据目录，这本书主要包含以下章节...示例 2：查找内容
用户：帮我找到关于"人工智能"的章节
AI：[调用搜索书籍，关键词：人工智能]
AI：我在以下位置找到了相关内容...示例 3：解释选中内容
用户：[选中一段文字] 解释这段话
AI：[调用获取选中文本]
AI：这段话的意思是...AI 指令
AI 指令是一种快速执行预定义提示词的功能，适合需要频繁使用的场景，如解释生词、总结段落等。
什么是 AI 指令？
与 AI 聊天不同，AI 指令用于一次性快速获取响应，无需维护对话上下文。您可以预先定义提示词模板，选中文本后一键执行，直接获取结果。
使用方式
- 在书籍中选中文本
- 点击选择菜单中的 ⚡ 按钮
- 从弹出的指令列表中选择要执行的指令
- 等待 AI 响应
响应会在浮层中显示，支持 Markdown 格式。您可以复制响应内容或重新生成。
管理指令
在侧边栏点击 AI 标签，然后切换到指令面板：
| 操作 | 方式 |
|---|---|
| 添加指令 | 点击顶部 + 按钮 |
| 编辑指令 | 点击指令右侧的编辑按钮 |
| 删除指令 | 点击指令右侧的删除按钮 |
| 调整顺序 | 拖动指令卡片 |
模板变量
指令提示词支持以下变量，执行时会自动替换为实际内容：
| 变量 | 说明 | 示例 |
|---|---|---|
{SELTEXT} | 当前选中的文本 | 用户划选的内容 |
{SELPARA} | 选中文本所在的段落 | 包含选中内容的完整段落 |
{CHAPTER} | 当前章节的全文 | 正在阅读的章节内容 |
指令示例
解释生词
请解释以下词语的含义，并给出例句：
{SELTEXT}翻译段落
请将以下段落翻译成简体中文：
{SELPARA}总结章节
请用 3-5 句话总结以下内容的要点：
{CHAPTER}选择模型
在指令面板顶部有模型选择器，可以为 AI 指令单独选择模型。这与 AI 聊天使用的模型是独立的。
如果没有手动选择模型，会自动使用第一个可用的模型。
会话管理
AI 聊天支持多会话功能，每本书可以创建多个独立的对话。
会话特点
| 特点 | 说明 |
|---|---|
| 书籍关联 | 每个会话绑定到特定书籍 |
| 历史保存 | 对话记录持久化存储 |
| 独立上下文 | 不同会话互不影响 |
| 可恢复 | 下次打开书籍可继续对话 |
会话操作
| 操作 | 方式 |
|---|---|
| 新建会话 | 点击会话列表的 + 按钮 |
| 切换会话 | 点击会话列表中的项目 |
| 删除会话 | 点击历史记录中条目尾部的删除按钮 |
常见问题
AI 功能无法使用？
- 检查是否已配置 AI 服务商
- 确认 API Key 正确
- 检查网络连接
- 尝试使用其他模型
响应速度很慢？
AI 响应速度取决于：
- 网络延迟
- 模型类型（更大的模型更慢）
- API 服务负载
建议：
- 使用更小的模型
- 选择响应更快的服务商
- 检查网络连接质量
工具调用失败？
- 确保在批准对话框中点击了允许
- 部分工具可能因书籍格式不支持而失败
- 查看错误提示了解具体原因
如何使用国内 AI 服务？
配置步骤：
- 选择 OpenAI 类型（兼容 API）
- 填写服务商的 Base URL
- 填写对应的 API Key
- 添加服务商支持的模型 ID
支持的国内服务包括：阿里云 DashScope、智谱 AI 等支持 OpenAI 兼容格式的服务。
会话数据保存在哪里？
会话数据保存在书库目录的数据库文件中。迁移书库时会一并迁移所有 AI 会话记录。