开始使用
从一本书开始。AI、同步和插件可以在需要时再设置。本指南描述当前开发构建版本；最新发布的应用可能尚未提供其中一些控件。请在「设置 → 关于」中查看已安装的版本。
导入书籍
使用书库的导入功能，或将支持的文件拖入应用。ReadAware 使用单一阅读引擎处理 EPUB、MOBI、AZW3、FB2、PDF，以及支持的文字和漫画格式。副文件名不保证个别文件一定可读。受 DRM 保护的书籍不受支持；ReadAware 不会移除 DRM，也不会把原始书籍转换成其他格式。你也可以一次性导入整个文件夹的书籍；每本书都会记住它来自哪个文件夹，因此你可以让智能助理按文件夹对书架进行分组。
导入的书籍位于本地书库。使用搜索、最爱和集合整理书籍；开启书籍时会恢复存储的阅读位置。
让阅读器更舒适
开启阅读器外观控制项，调整字体、间距、边界、页面颜色和版面。可重排书籍支持卷动与分页版面。PDF 和漫画页面有自己的固定版面控制项；字体设置无法重新排版嵌在页面影像中的文字。用捏合手势缩放这些页面，或在 macOS 上使用 Cmd = 和 Cmd −（其他平台用 Ctrl）；Cmd 0 恢复为适配大小，外观控制项可选择按页宽还是整页适配。在单页和双页版面中，Cmd L 或缩放比例旁的锁可以锁定缩放视图，翻页时仍会显示每页的同一部分。每本书都会在此设备上记住其缩放比例和你在页面上的位置。
所有书籍使用的字体选择会按当前书籍的语言记住，因此切换语言时无需再次选择字体。针对单本书的外观覆盖设置仍具有更高优先级。字体菜单还可以导入你自己的 TTF、OTF、WOFF、WOFF2 或 TTC 文件；导入的字体会跨设备同步。翻页可以使用点击区域，在 Android 上还可以使用音量键——请在「设置 → 阅读 → 翻页」中启用。
使用目录、书籍搜索和导航历史移动。精确来源位置与撷取文字搜索用途不同：搜索预览在导航前可能需要进一步查询来源。
标注与提问
选取段落即可加上荧光标示、笔记，或使用解释、查询、翻译等可用阅读动作。AI 动作使用你选择的模型设置和隐私设置；没有 AI，笔记与荧光标示仍然有用。
每本书都有持久对话。开启聊天面板询问阅读内容；全域上下文页面支持跨书库的独立对话。长期记忆跨对话共用，建立另一个讨论串不会建立另一个记忆库。
ReadAware 为每轮组合相关阅读上下文、笔记和记忆。记忆功能包含阅读目标、个人数据、书籍摘要和实体关系。生成内容可能不完整或错误，请检查并使用可用的修正与遗忘控制项。
对于小说，情节摘要和叙事上下文会跟随你的阅读进度，以帮助避免剧透。历史和传记可以使用关于真实事件的更广泛上下文。如果书籍分类不正确，你可以检查或更正它。
如果模型请求失败，请使用重试操作继续失败的步骤。工具活动会在对话中归组，展开即可查看助理执行了哪些操作。
连接模型
开启「设置 → AI」，选择服务商或兼容端点，输入 API 金钥并选择模型。Smart 模型处理较复杂的对话与综合，Fast 模型处理较轻量的工作；服务商目录与连线测试可协助检查设置。
AI 需要可用的服务商连线。BYOK 使用你选定的服务商，可能产生其费用；可用的 ReadAware AI 订阅也是选项；详见方案。一般本地阅读与标注不需要任何一项。
启用自动工作前，请检查阅读上下文和自动记忆设置。相关书籍摘录与其他选定上下文可能离开装置供推论使用，即使书库和记忆存储在本地。详见隐私政策。
搜索网页与查看图片
在「设置 → AI → 网页搜索」中启用搜索，选择 TinyFish、Exa、Tavily、SerpAPI 或 Brave，并输入该服务商的 API 密钥。此密钥与模型密钥分开。更换服务商或凭据后，请运行连接测试。
搜索和页面读取会使用所选的服务商和密钥。不同服务商的能力有所不同：SerpAPI 提供搜索但不提供页面读取，Brave 的页面读取需要访问其 LLM Context API。当某项能力不可用时，ReadAware 不会悄悄切换到其他服务商。
助理可以在有助于回答问题时使用网页来源和支持的图片结果。图片预览会链接回其来源；是否支持向模型发送图片内容取决于所选模型。搜索查询、请求的 URL 和图片请求可能离开你的设备。启用这些功能前，请查看隐私政策。
连接其他助理
「设置 → AI → 本地 API」允许其他助理在 ReadAware 运行时查询你的阅读数据。它默认关闭。启用后，使用复制安装提示词将ReadAware skill安装到你的助理中，然后使用复制连接配置分别提供本地地址和访问令牌。
该 API 只提供对书库元数据、目录、书籍文本、搜索、标注、阅读记录和限定范围记忆的只读访问。它不会暴露设置、模型密钥、原始文件或写入操作。已连接的助理可以请求未读文本，因此请告诉它需要遵守的阅读边界。
助理必须能够在同一台电脑上发出请求。云服务自己的 localhost 无法访问你的桌面，普通网页也无法调用此 API。请妥善保管连接令牌。重置令牌可以撤销旧连接，关闭 API 可以停止访问。外部助理继续发送的任何数据均受该助理的配置和服务商条款约束。
聆听与扩充
朗读取决于阅读器模式、可读文字和可用语音服务商。系统语音与语音插件有不同的网络和设置需求；没有可用文字的扫描页面不保证能朗读。
在「设置 → 插件」启用需要的工具并检查权限。插件可以加入阅读动作、命令、主题、内容来源和助理工具；可用性取决于包及应用支持的接口约定。从插件市场安装的插件会自动更新；若更新需要更多权限，会在那里等待你的批准。了解插件运作方式。
命令面板在 macOS 使用 Cmd K、其他平台使用 Ctrl K 开启；快捷键可在设置中变更。
同步与备份
两者解决不同问题：
- 同步在设备间传送加密事件和文件。在「数据与同步」中配置中继同步，或在传输插件的设置中配置 WebDAV 等传输方式。妥善保存加密口令。同步不保证每个设备本地设置、私有插件文件或临时任务都会同步。
- 备份建立用于复原的加密封存。自 0.6.5 版起只提供完整封存；旧版仅书库格式已停用，旧的仅书库文件无法再复原。完整复原会检查封存、要求通关密语和选项，并透过宿主复原流程合并支持数据。
中继同步在连接期间会自动运行。WebDAV 等插件传输使用插件设置中的立即同步；它们不会按照中继的自动计划运行。请查看对应的设置页面，处理连接错误或登录请求。
你可以离线继续阅读。设备重新连接后，一本书的共享进度会保留记录中最远的位置，即使另一台设备较新的更新落后于该位置。例如，离线读到第 300 页，不会被另一台设备之后记录的第 200 页替换。ReadAware 会在书籍内部比较位置，因为可见页码可能随版式变化。阅读时间会单独累计。这一规则不会在你返回重读前面页面时重置共享进度。
请查看已安装版本提供的选项。备份内容、成功存储，以及能否复原是不同事项；迁移或降级前请保留已知可用的副本。
寻找数据与诊断问题
本地数据目录、同步状态、备份动作和诊断功能都在设置中。读取失败时，适当情况下应显示可重试错误；存储失败不代表变更成功。回报问题时，请附上应用版本、操作系统、重现步骤及检查过的诊断汇出。