# Mobile Ink Annotation 介绍与使用手册 > 适用版本：Mobile Ink Annotation Pro 1.0.8（最低 Obsidian 1.5.0）
> 文档更新：2026-09-15 Mobile Ink Annotation 是一个面向 Obsidian 的手写标注插件，重点服务于 iPad、触控屏、Apple Pencil 和手写笔场景。它可以在 Markdown 笔记、PDF 文档和独立手写笔记中直接书写、圈画、插入文本/形状/便利贴、截图、识别文字、调用 AI 问答，并把重要内容沉淀为批注、收藏、题库或 `.imap` 批注思维导图。 在 1.0.5 中，批注中心升级为按文档或按时间浏览的学习工作台：可在单条批注上直接转文字、追问 AI、生成学习/错题卡片，也可将所选批注、单个文档或当前筛选结果导出为 `.duowei` 文件。AI 问答改用可切换的模型预设，并增加上下文管理、服务端会话同步和写回笔记位置选择。 在 1.0.6 中，更新检查与安装界面改为卡片式布局，集中展示版本、发布日期、最低兼容版本和精简更新要点，并提供独立的完整更新日志入口。更新失败时会显示更明确的原因；移动端弹窗布局与触控操作也得到优化。 在 1.0.7 中，批注中心之上新增「题库」：阅读时圈到的题目或批注中心里的摘录可以交给 AI 抽取成结构化题目，用 FSRS 排期复习，复习时能直接在题卡上手写演算。卡片收藏夹并入批注中心，成为内置的「收藏」集合，旧收藏自动迁移；批注中心改为「范围导航 + 列表 + 详情抽屉」布局，新增瀑布流、表格视图和「整理到笔记」。阅读页工具栏精简，摘录胶囊的 AI 面板可拖动、可调整大小，圈画 OCR 结果就地核对。书写与自动保存完成多轮性能优化，AI 请求补上超时与桌面端流式回退，设置页拆成五个标签页并提供搜索框。 在 1.0.8 中，重点修复手写批注在批注中心和笔记回链卡片里“看不到笔迹”或“画错位置”的问题：PDF 手写记录的预览图按阅读页真实的页面布局定位；导出的手写回链卡片能找回整组笔迹并直接显示批注中心渲染的页面截图；`整理到笔记` 为每条批注生成预览图并显示进度。标注画布不再借用主题的 `.markdown-preview-view` 样式，第三方主题不会再把标注页渲染成空白。 新版插件进一步加强了阅读、复习与知识整理能力：PDF 标注中可以直接添加文本、矩形、圆形、线条、单向箭头、双向箭头和书写便利贴；支持文字遮盖、框选遮盖、全文搜索、目录与书签、出链引用框和标准 PDF 批注互操作；批注与截图还可以边读边加入 `.imap` 思维导图。导出 PDF 时会尽量保留原 PDF 并追加标准批注，必要时自动回退到所见即所得的栅格化导出。 本文档同时适用于 Basic 与 Pro 构建。不同构建可用功能不同，实际界面以当前安装版本为准。 ## 1. 功能概览 ### Basic 基础版 - Markdown 手写标注：在普通笔记页面上方书写、划线和批注。 - PDF 手写标注：在 PDF 页面上使用手写笔做自由标记。 - 基础绘图工具：钢笔、荧光笔、橡皮擦。 - 临时演示工具：激光笔，笔迹短暂显示后自动消失，不写入标注数据。 - 笔迹样式：支持调整颜色、笔宽和透明度。 - 基础操作：撤销、重做、保存、退出。 - 虚拟 PDF：为在线 PDF 或库外本地 PDF 建立库内占位文件，并使用基础标注工具书写。 ### Pro 专业版 Pro 版在基础手写标注之上增加以下能力： - 独立手写笔记：创建 `.mink` 手写文件，支持多页、纸张模板、图片、形状、文本、贴纸。 - PDF 对象标注：在 PDF 页面中插入文本、矩形、圆形、线条、单向箭头、双向箭头。 - 书写便利贴：在 PDF 标注、Markdown 标注和独立手写笔记中插入可独立书写的便利贴。 - PDF 文本批注：对 PDF 可选文本做高亮、下划线、笔记和问答。 - PDF 遮盖复习：对选中文字或任意框选区域创建遮盖，点击即可显示/重新遮盖。 - PDF 阅读导航：目录与书签、PDF 文本搜索、页码定位和出链引用框。 - 截图与区域选择：圈画页面区域，生成截图、复制回链、保存图片、OCR、AI 问图或加入脑图。 - 笔迹选择：框选已有笔迹后复制、粘贴、删除、缩放或生成回链截图。 - 批注中心：按文档、瀑布流或表格集中查看 Markdown、PDF 和独立手写笔记中的批注，在详情抽屉里写思考、转文字、追问 AI、生成学习卡片，并把批注整理到指定笔记。 - 收藏：阅读时把文本、截图、OCR 结果或重点批注收藏到批注中心的内置「收藏」集合。 - 题库与复习：把批注或阅读材料交给 AI 抽取为结构化题目，按 FSRS 排期复习，复习时可手写演算，并导出 Anki、自测卷或多维表。 - 批注导出为多维表：把所选批注、单个文档或当前筛选结果导出为 `.duowei` 文件。 - 原文批注侧栏：在 Markdown 源文中添加、查看和维护原文批注。 - 批注思维导图：创建 `.imap`，从批注中心、选中文本、截图或已有批注持续采集并整理知识结构。 - AI 会话历史：搜索、置顶、重命名和继续此前的智能问答/问图会话。 - 嵌入预览：在 Markdown 中预览独立手写笔记或回链内容。 - 触控输入：面向 iPad 和触控屏优化手写体验。 - PDF 导出：导出包含笔迹、文本批注、对象标注、书写便利贴和独立笔记内容的 PDF。 - 标准 PDF 批注互操作：导入 PDF 内置批注；桌面端还可导出标准批注副本，或备份后写回源 PDF。 ## 2. 安装与启用 ### 手动安装 1. 下载插件发布包。 2. 将发布包解压到当前库的 `.obsidian/plugins/` 目录下。 3. 重启 Obsidian 或重新加载插件。 4. 进入 `设置 -> 第三方插件`，启用 Mobile Ink Annotation。 ### 从已安装版本更新 Pro 版支持由用户主动检查和安装私有更新： 1. 打开 `设置 -> Mobile Ink Annotation Pro -> 授权` 标签页。 2. 点击凭证卡片上的 `检查更新`。插件只在这次点击后查询一次版本目录，不会在后台定时检查。 3. 如果发现当前授权权益覆盖的新版本，查看版本号、发布序号、发布日期、最低 Obsidian 版本和更新说明。 4. 点击 `下载、验签并安装`。插件会校验发布签名、文件大小和文件哈希，再替换 `main.js`、`styles.css` 与 `manifest.json`。 5. 安装成功后，完全退出并重新打开 Obsidian。仅重新关闭当前标签页不足以加载新版插件代码。 安装器会先在插件目录的 `.peyote-backup` 下备份当前程序文件；如果安装中途失败，会尽可能自动恢复原版本，并保留备份路径供人工恢复。更新不会删除笔迹、批注、卡片、脑图、独立手写笔记或插件设置。 检查更新需要本机已有有效 Ink Pro 授权。如果服务器已有新版本，但当前更新权益没有覆盖该发布序号，窗口会显示最新版信息，现有已安装版本仍可按许可证继续使用。 ## 3. 首次配置 打开 `设置 -> Mobile Ink Annotation` 后，建议按下列顺序配置。 ### 设置页结构 设置页分成五个标签页，顶部另有一个检索框： - `标注阅读`：PDF 视图与交互、选区工具与批注中心（含 PDF 预览裁切、导出样式）、题库复习、五色摘录标签。 - `笔刷手写`：默认橡皮擦、手写笔记与贴纸目录，以及四组可折叠的笔刷高级参数。 - `AI 与 OCR`：模型预设、交互体验与 RAG、提示词与快捷动作（含题库讲解方向）、百度 OCR。 - `存储数据`：从基础版导入标注，以及五个数据存储目录。 - `授权`：授权凭证卡片、激活/续期/恢复、隐私与联网说明。 检索框按设置项名称和说明跨标签页过滤，输入关键词（例如 `压感`、`贴纸`、`目录`、`RAG`）即可直接定位，不必先记住它在哪一页；折叠起来的笔刷参数分组在检索时会自动展开。 ### 授权、续期、设备与版本更新 Pro 版首次启用后，需要在插件设置中激活授权： 1. 点击 `激活授权`，或运行命令 `激活 Mobile Ink Annotation Pro`。 2. 输入购买时取得的 `INK1` 开头激活码；爱发电渠道还需要填写订单号。 3. 激活成功后，把只显示一次的恢复码保存在 Obsidian 库之外。恢复码用于本机身份丢失或无法继续使用原本机授权时恢复许可证。 `DWL` 开头的是许可证 ID，不是激活码；`DW1` 是其他产品的卡密，不能用于激活 Ink Pro。激活、续期或重新绑定失败时，应先核对卡密类型、购买渠道和订单号。 `授权` 标签页顶部是授权凭证卡片，卡片上显示许可证类型、授权状态徽标、当前版本与发布序号，下面三格分别是更新政策（含许可证覆盖的发布序号）、使用期限（含宽限期）和联网策略。卡片底部的按钮含义如下： - `重新检查`：只做本机签名验证，不联网。插件日常启动走的也是这一步。 - `检查更新`：点击后查询一次当前产品的私有发布目录；具体安装流程见“从已安装版本更新”。 - `同步授权状态`：仅在点击后联网，更新本机设备状态和最新签名许可证。授权被限制、退款、撤销或本机被解绑时，Pro 功能会暂停，但已有数据不会删除。 - `管理设备`：点击后联网查看已绑定设备。解绑当前设备会立即暂停本机 Pro 功能；之后可使用最初的 Ink Pro 激活码重新绑定，并重新占用一个设备名额。 卡片下方的 `授权维护与激活码` 只在有对应操作时出现：固定期限授权显示 `提前续期` / `宽限期续期` / `续期授权`，可输入 `INK1…REN` 续期码延长使用期，不会自动扣款；未激活或被远程解绑时显示 `激活授权` / `重新绑定授权` 和 `使用恢复码`；系统时钟异常时显示 `校准授权时间`。买断且状态正常时没有需要维护的项目，这一块不会显示。 联网激活、恢复、续期、同步、设备管理和检查更新时，插件只提交完成操作所需的激活码或恢复码、订单号（渠道要求时）、许可证 ID、设备证明和发布序号信息，不上传笔记、文件名、手写内容或使用数据。 ### PDF 默认打开方式 `PDF 默认使用标注视图打开` 控制点击 PDF 文件时是否自动进入插件的 PDF 标注视图。 - 开启后：打开 PDF 时会直接显示插件标注视图，并加载已保存的手写、文本高亮、下划线和批注。 - 关闭后：PDF 默认仍使用 Obsidian 原生 PDF 视图，需要通过命令或按钮进入标注。 ### 移动端文本选择 `移动端文本选择` 默认开启，用于控制 iPad、安卓平板等设备上的 PDF 文本选择手势。 - 开启后：可以使用插件的文本选择工具选中 PDF 文字并创建高亮、下划线、批注、遮盖、卡片或脑图节点。 - 关闭后：移动端文本选择工具不可用，插件不再拦截相应触摸手势，页面边缘更容易触发系统菜单或系统滑动。 如果设备上的系统手势与 PDF 选词频繁冲突，可暂时关闭此项；桌面端文本选择不受影响。 ### PDF 出链显示 `PDF 出链显示` 默认开启。开启后，PDF 标注视图会扫描库内指向当前 PDF 批注或页面区域的引用，并在原位置显示出链引用框。 - 点击引用框可以打开引用来源；同一区域有多个来源时会显示来源菜单。 - 引用区域支持通过四角控制点调整；对于脑图截图节点，调整后会同步更新脑图节点的原文区域和截图。 - 右键引用框可以复制当前引用、复制来源链接或删除来源文件中的这条引用。 - 关闭后不扫描也不显示引用框，适合大型库中希望减少后台索引和页面干扰的场景。 ### 遮盖复习 Pro 版提供两项遮盖设置： - `遮盖颜色`：用于之后新建的文字遮盖和框选遮盖，已有遮盖保留原颜色。 - `默认显示遮盖内容`：关闭时打开文档默认保持遮盖；开启时默认显示答案，仍可逐个点击重新遮盖。 遮盖的显示/隐藏状态是当前阅读会话中的临时状态；创建的遮盖区域本身会随批注保存。 ### MD 源文件批注选区工具条 `MD 源文件批注选区工具条` 默认开启。开启后，在 Markdown 编辑器中选中文本会显示高亮、下划线、加粗、批注和颜色工具条；关闭后不会再弹出选区工具条，但仍可通过命令面板或右键菜单添加原文批注。 ### PDF 预览裁切 `PDF 预览裁切` 决定圈画和高亮在批注中心里的预览图裁多大，同时影响 OCR 和发给 AI 的图片范围： - `按文字行（推荐）`：只保留圈到的那几行，卡片上多留一行上下文；OCR 与 AI 图片随之更准。 - `只要圈到的行`：不留上下文，只裁圈到的行。 - `整段（旧行为）`：横向不裁，纵向至少 180pt。 扫描件没有文字层，一律按「整段」处理。修改后已打开的批注中心会重新生成预览。 ### 批注中心导出样式 Pro 版可设置批注中心导出 Markdown 时的默认样式： - `清爽引用`：适合直接阅读和复盘。 - `紧凑列表`：适合快速整理大量批注。 - `详细归档`：保留来源、状态、位置、关联卡片等更多元数据。 ### 题库复习 `题库复习` 分组统一设置题库的复习参数，修改不会影响已有作答记录和复习进度： - `每日复习上限`：默认 60 题，范围 1–500。限制新一轮复习或专项练习的题目数；正在进行的轮次不受影响。 - `目标保持率（%）`：默认 90%，范围 70%–97%。数值越高，复习越频繁；修改后从下一次评分开始影响间隔。 题库本身的使用方法见“题库与复习”一章。 ### 桌面端高清 PDF 放大 `桌面端高清 PDF 放大` 默认关闭。开启后，PC 端在高倍缩放且交互空闲时，会为可见区域叠加高清局部 tile。它能改善大屏或高分辨率显示器上的放大清晰度，但会增加内存与渲染开销；普通阅读或低配置设备建议保持关闭。 ### 笔刷与书写 - `默认橡皮擦模式`：选择像素级或笔画级擦除。 - `手感与轨迹`、`速度与笔宽`、`压感与收尖`、`输入、渲染与预测`：四组默认折叠的低频参数，点击标题展开。 - 高级参数修改后会立即应用到已打开的标注视图。 - `恢复默认笔刷参数` 只重置高级参数，不修改当前颜色、粗细、透明度和橡皮擦模式。 常用调节建议：轨迹抖动时提高坐标稳定、稳定半径或防抖过滤；转折被过度磨平时提高拐角保真；无压感设备可调整默认压力；笔画粗细跳变时提高宽度稳定、压感平滑或速度平滑。若不确定，优先使用默认值。 ### 数据存储目录 `存储数据` 标签页的 `数据存储目录` 可分别指定以下库内文件夹： - 手写/PDF 标注数据：保存 `*.ink.json`。 - 截图数据：保存截图、回链截图、卡片截图和脑图区域截图。 - 批注中心数据：保存工作流索引 `index.json`、收藏与题库 `question-bank.json`。 - 旧收藏迁移来源：只用于读取 1.0.6 及更早版本的收藏备份；新收藏保存在批注中心数据目录。 - Markdown 原文批注数据：保存原文批注索引。 留空时使用当前插件目录下的 `annotations`、`captures`、`annotation-center`、`card-favorites` 和 `md-source-annotations`。自定义路径应填写相对于库根目录的路径。修改路径只会改变之后读取和写入的位置，不代表自动搬迁旧文件；已有数据需要自行确认和迁移后再切换。 ### 百度 OCR OCR 功能用于识别截图、区域选择和批注中心里的手写/图片批注。插件调用百度智能云的文字识别接口，需要你自己开通服务并填入 API Key 与 Secret Key。插件只在本地保存这两个值，不会上传到 Peyote 的任何服务器。 #### 第一步：开通百度文字识别服务 1. 打开百度智能云文字识别控制台：`https://console.bce.baidu.com/ai-engine/ocr/overview/index`。 2. 使用百度账号登录；首次使用需要完成实名认证，否则无法领取额度或调用接口。 3. 在概览页找到要使用的接口，先领取免费额度或开通按量计费。至少需要开通 `通用文字识别（标准版）`；如果准备识别手写内容，同时开通 `手写文字识别`。 4. 确认接口状态为已开通。未开通就调用时，插件会提示 `OCR 接口报错 6: No permission to access data`。 #### 第二步：创建应用并取得 API Key / Secret Key 1. 在同一控制台进入应用列表，创建一个新应用。 2. 应用名称随意填写，接口勾选上一步已开通的文字识别接口。 3. 创建完成后，在应用详情中复制 `API Key` 和 `Secret Key`。 4. Secret Key 只在应用详情中可见，建议同时保存到你自己的密码管理器。 百度控制台的页面文案和入口位置会随版本调整，以你打开时的实际界面为准；插件真正需要的只有「已开通对应接口」和「该应用的 API Key / Secret Key」两件事。 #### 第三步：在插件中填写 进入 `设置 -> Mobile Ink Annotation -> AI 与 OCR -> 百度 OCR 手写识别`，按顺序完成： 1. `OCR 模型`：从下拉框选择接口。可选 `通用文字识别（标准版）`、`通用文字识别（高精度版）`、`手写文字识别` 和 `PP-OCRv5`。切换后插件会自动切换请求地址并按接口类型发送参数。分组标题下方会实时显示当前接口地址，这一行的说明里还带有该接口的官方文档链接，用来核对是否选对了接口。 2. `API Key`：粘贴上一步复制的 API Key。 3. `Secret Key`：粘贴 Secret Key，输入框以密码形式显示。 4. 修改 API Key 或 Secret Key 会立即作废已缓存的 access_token，下次识别时自动重新获取。 #### 第四步：验证配置 1. 在 `Access Token 缓存` 一行点击 `立即刷新`。 2. 成功时提示 `百度 OCR Access Token 已刷新`，该行会显示缓存的过期时间。 3. 失败时会直接显示百度返回的错误信息，据此回到第一步或第二步排查。 4. 打开任意 PDF 或笔记，用圈画截图工具框选一段文字并执行 OCR，确认能返回结果。 access_token 由插件自动获取和缓存，过期后会自动续取，正常使用不需要手动干预。 #### 模型选择建议 - `通用文字识别（标准版）`：日常印刷体截图，免费额度通常最多，作为默认选择。 - `通用文字识别（高精度版）`：小字号、排版密集或扫描质量一般的页面。 - `手写文字识别`：识别手写笔记和自己写的批注。 - `PP-OCRv5`：版式复杂或前几种效果不佳时可以试用。 不同接口的免费额度、并发限制和计费方式各不相同，以百度控制台的实际说明为准。 #### 常见错误码 - `6`：该 API Key 所属应用没有开通对应的 OCR 接口权限，回到第一步开通并确认应用已勾选该接口。 - `110` / `111`：access_token 无效或已过期。插件会自动重取一次并重试；持续失败时检查 API Key 与 Secret Key 是否配对。 - `17` / `18`：当日调用量或并发超限，等待额度恢复或在控制台调整套餐。 完整错误码见 `OCR 模型` 一行说明里给出的百度官方文档链接。 #### 内置识别参数 以下 OCR 参数已作为内置默认参数，不再显示在插件设置中： - 识别语言：`CHN_ENG` - 检测图像方向：开启 - 输出段落：开启 - 检测语言：关闭 - 返回置信度：关闭 - 自动整理文本：开启 ### AI 问答与 AI 问图 从 1.0.5 起，AI 配置统一到 `模型预设`。一个预设就是一组 `Endpoint + 模型 + API Key`，文本问答（智能问答）和图片问答（智能问图）各自选用一个预设。1.0.4 及更早版本中分开的 `智能问答 Endpoint / 模型 / API Key` 和 `智能问图 Endpoint / 模型 / API Key` 已不再单独显示。 所有预设都按 OpenAI-compatible chat completions 方式调用。 从旧版本升级时不需要重新配置：原有的两套设置会自动转成预设。两套配置指向同一服务时合并成一个名为 `默认模型` 的预设，同时作为文本默认和图片默认；指向不同服务时拆成 `文本问答` 和 `图片问答` 两个预设。升级后建议打开确认一次名称和 `支持图片输入` 开关。 #### 第一步：添加预设 `AI 与 OCR` 标签页的 `模型预设` 分组标题右侧提供两个按钮： - `＋ 添加预设`：手动填写一个预设，适合接入 OpenAI、DeepSeek、通义千问等云端服务，或你自己搭建的兼容接口。 - `导入本地服务`：一次性加入 `本地 Gemini`、`本地 Qwen`、`本地 DeepSeek`、`本地 Kimi`、`本地 MiMo` 和 `本地 Ollama` 六个本机代理预设，地址分别指向 `127.0.0.1` 的对应端口。已存在的预设不会重复添加。 #### 第二步：填写预设字段 点击 `＋ 添加预设` 或已有预设右侧的铅笔图标，打开 `编辑模型预设`： - `名称`：显示在问答输入框上方的模型标签和切换菜单里，建议写成能一眼区分的名字。 - `Endpoint`：chat completions 地址。只填到 `/v1` 也可以，插件会自动补全 `/chat/completions`；漏写协议头时自动补上（局域网地址补 `http`，其余补 `https`）。 - `模型`：发给服务的 `model` 字段。浏览器代理类服务会忽略它，随便填一个即可。 - `API Key`：以密码形式输入。本地或局域网服务留空即可；留空时插件不会发送 `Authorization` 头。 - `支持图片输入`：关闭时，智能问图不会选用这个预设。接入视觉模型时必须开启。 - `会话由服务端保存`：浏览器代理类服务（Gemini / DeepSeek / Kimi / MiMo / Qwen）需要开启。这类服务只读取最后一条消息，对话保存在浏览器页面里；开启后插件不再重复发送本地历史，并在新建会话时调用下面的重置接口。 - `重置会话路径`：新建或清空会话时 POST 的路径。开启上一项后会自动填入默认值，留空表示该服务不支持重置。 - `内容格式`：`数组（多模态，推荐）` 是标准的 OpenAI 格式。少数服务（例如 Ollama 代理）把 `content` 声明成字符串，遇到数组会返回 HTTP 422，这类服务改选 `字符串（图片走 image 字段）`。 - `结构化输出`：只用于题目抽取与讲解。确认服务支持 JSON 输出参数后再开启；浏览器代理始终使用提示词与本地校验，不会发送该参数。 - `温度`：0 最稳定、2 最发散，留空使用插件默认的 0.2。抽题、改写这类要求忠于原文的任务建议留空或填 0。 - `最大输出长度`：发给服务的 `max_tokens`。留空表示不指定；题库这类长 JSON 回答被截断时在这里调大。 #### 第三步：测试并保存 1. 点击 `测试生成`。插件会实际调用一次模型；勾选了 `支持图片输入` 的预设会同时发送一张 32×32 的测试图片。 2. 弹窗中会直接显示探测结果，据此判断 Endpoint、模型名、API Key 和内容格式是否正确。 3. 确认无误后点击 `保存`。名称和 Endpoint 为必填项。 这一步会产生一次真实调用并计费，请在切换服务商或排查故障时使用，不必每次打开设置都点。 #### 第四步：指定默认预设 保存后，每个预设会在设置页列出一行，显示 Endpoint、模型和标记： - `文本默认`：当前用于智能问答的预设。 - `图片默认`：当前用于智能问图的预设。 - `视觉`：该预设已勾选支持图片输入。 - `服务端会话`：该预设的对话保存在服务端。 - `字符串格式`：该预设使用字符串内容格式。 每行右侧的图标依次是：对话气泡图标设为文本问答默认、图片图标设为图片问答默认、铅笔编辑、垃圾桶删除。未勾选 `支持图片输入` 的预设无法设为图片默认。日常使用时，也可以直接点问答面板顶部的模型标签临时切换预设。 #### 提问行为设置 - `发送快捷键`：可选 `自动（跟随设备）`、`Enter 发送，Shift + Enter 换行`、`Ctrl/Cmd + Enter 发送`。选 `自动` 时移动端用 Enter 发送、桌面端用 Ctrl/Cmd + Enter 发送。中文输入法确认候选词不会误触发送。 `提示词与快捷动作` 分组集中管理提示词，留空即恢复默认： - `题库讲解方向`：`AI 补全讲解` 按这个方向给解析和秒杀技巧，可选 `通用`、`公务员考试 · 行测`、`公务员考试 · 申论`、`考研数学`、`考研英语`、`大学英语四六级` 或 `自定义`。选自定义时再填写一句 `自定义讲解角色`，说明模型身份和这门考试看重什么。题目自己的「学科」字段会一并告诉模型。 - `全局回答风格`：每次请求都会带上的表达偏好，用来设置语言、详略和语气。它不会覆盖题目抽取、来源边界或结构化输出规则；浏览器代理类服务会把它并入当轮提问。 - `一键提问`：显示在快捷提问气泡和问答面板里的按钮，每行一条，格式为 `标签|提示词`，最多 8 条。输入框下方会提示实际生效的条数和被截断的标签。 - `追问`：回答生成后显示在气泡里的追问按钮，格式同上；清空则不显示追问行。 #### 历史记录 `启用 AI 问答历史记录` 默认开启： - 开启后，会话写入本地插件数据，重启后仍可搜索、置顶、重命名、删除和继续会话。 - 关闭后，会话只保留在当前使用期间，不写入磁盘。 - `清空 AI 问答历史记录` 会永久删除本地保存的全部问答/问图会话，且不可撤销。按钮需要连续点击两次确认，第二次点击前有 6 秒确认窗口；清空时会同时删除插件生成的 AI 截图，并重置所有服务端会话预设。 ### RAG 本地知识库 `智能问答默认开启 RAG` 控制问答面板是否默认从当前库召回相关 Markdown 片段作为上下文。 `RAG 本地向量库文件夹` 可以填写： - `vector_store.json` 所在文件夹。 - 或直接填写 `vector_store.json` 文件路径。 当前实现面向本地向量库文件，适合配合支持 `BAAI/bge-m3` 等嵌入模型的本地索引流程使用。 ### 独立笔记和贴纸目录 Pro 版显示以下目录设置： - `独立手写笔记存放目录`：新建 `.mink` 手写笔记时使用的默认目录，默认 `Handwriting`。 - `自定义贴纸素材目录`：独立手写笔记加载自定义贴纸的目录，默认 `Handwriting/Stickers`。 截图位置已统一到前述 `数据存储目录 -> 截图数据`，留空时默认使用插件目录下的 `captures`，不再跟随源文件目录。 自定义贴纸目录支持常见图片素材，例如 PNG、JPG、WebP、SVG 和 BMP。也可以放置 `manifest.json` 来配置贴纸名称、分类、默认尺寸和旋转角度。 ## 4. 打开标注 ### 使用左侧 Ribbon 图标 插件会在左侧 Ribbon 中添加常用入口： - 铅笔图标：打开当前 Markdown 或 PDF 的手写标注。 - 批注中心图标：打开批注中心，Pro 版可用。收藏和题库都在批注中心内部。 - 原文批注图标：打开 Markdown 原文批注侧栏，Pro 版可用。 - 分支图标：创建空白 `.imap` 批注思维导图，Pro 版可用。 1.0.6 及更早版本的书签图标（卡片收藏夹）已移除，收藏改由批注中心的「我的收藏」承载。 ### 使用命令面板 在命令面板中可以搜索以下命令： - `Open mobile ink annotation for current note` - `Open annotation center` - `打开批注中心 · 收藏`（原 `Open card favorites`，直接进入批注中心的收藏集合） - `Add markdown source annotation` - `Open markdown source annotations sidebar` - `创建新的独立手写笔记` - `创建自定义手账贴纸素材目录` - `创建批注思维导图` - `使用标注思维导图打开当前 .imap` - `Create virtual PDF from URL or file URI` - `打开智能问答侧栏` - `对选中文本发起智能问答` - `停止智能问答生成` - `导出当前智能问答会话为笔记` - `检查 Mobile Ink Annotation Pro 更新` 命令是否出现取决于当前构建版本和功能授权。四条智能问答命令需要当前构建已开放 OCR/AI 功能；`对选中文本发起智能问答` 只在编辑器中有选中文本时出现，`停止智能问答生成` 只在问答侧栏正在生成时可用。 `Create virtual PDF from URL or file URI` 会打开“创建虚拟 PDF”对话框，可填写 `http://`、`https://` 或 `file:///` 地址、库内目标目录和显示文件名。详见“PDF 标注”中的虚拟 PDF 小节。 ## 5. 标注视图工具栏 进入标注视图后，可拖动的悬浮工具栏提供书写、选择、插入、颜色和更多操作；标题栏保留撤销、重做、缩放、目录与书签和文本搜索等高频按钮。不同文件类型会显示不同工具：Markdown 标注侧重手写、截图、原文批注和便利贴；PDF 标注会额外显示文本选择、PDF 对象标注和 PDF 导出相关入口；独立手写笔记会显示页面、模板、图片、贴纸、文本和形状等入口。 1.0.7 精简了主工具栏：只保留画笔、记号笔、橡皮擦、框选/圈画、选择文本、添加、颜色和「更多」；激光笔、浏览模式、伴随脑图、批注中心 · 收藏、撤销和重做移入「更多」面板。 ### 绘图工具 - 画笔：用于普通手写。 - 记号笔：用于半透明重点标记。 - 橡皮擦：擦除已有笔迹，可切换像素擦除和笔画擦除。 - 激光笔：位于「更多」面板，用于讲解或临时指示，轨迹会自动消失，不会保存。 - 浏览模式：位于「更多」面板；开启「手指书写」后，主工具栏会额外显示一个手形按钮。浏览模式下手指只翻页、不落墨，也不会触发选择或圈画。 - 框选标注：选择已有笔迹后进行复制、粘贴、删除、缩放或生成回链，Pro 版可用。 - 圈画标注：圈出页面区域后执行 OCR、AI 问图、保存、收藏、添加错题或加入脑图，Pro 版可用。 - 遮盖框选：在 Markdown/PDF 标注页面上拖出任意矩形遮盖，Pro 版可用。 - 文本选择：在 PDF 或支持文本批注的场景中选中文本，Pro 版可用。 - 添加：直接列出书写便利贴、添加文本、单向箭头、矩形框、圆形、线条、双向箭头；独立手写笔记还有添加贴纸和添加图片。具体可用项目以当前文件类型为准。 画笔和记号笔是两个独立工具。单击用于切换工具；再次点按当前已激活的画笔或记号笔会打开粗细和透明度设置，再次点按当前已激活的橡皮擦会打开擦除模式和大小设置（不再需要双击）。 笔工具设置中还提供 `轻压长写`、`均衡`、`丝滑顺畅`、`轻快灵敏`、`稳定控笔` 五种手感预设，以及常用的跟手灵敏度、笔触反差和扁头高亮开关。更细的速度、滤波、压感曲线、收尖与预测参数位于插件设置的 `笔刷手写` 标签页。 需要在触控设备上快速切换“滚动页面”和“落笔书写”时，使用「更多」面板里的浏览模式，或开启手指书写后主工具栏上的手形按钮；重新点击任一书写工具即可继续书写。 ### 批注与对象工具 - 文本批注：PDF 中选中文本后，可创建高亮、下划线、笔记或发起 AI 问答。 - 文字遮盖：PDF 中选中文字后选择遮盖，阅读时点击遮盖块显示答案，再次点击重新遮盖。 - 区域遮盖：从“框选/圈画标注”菜单选择“遮盖框选”，可遮盖扫描 PDF、图片、公式或非文本区域。 - 原文批注：Markdown 中可对源文内容添加批注，并在侧栏中集中查看和维护。 - 文本对象：在 PDF 或独立手写笔记中插入可编辑文本框。 - 形状对象：插入矩形、圆形、线条、单向箭头和双向箭头。 - 书写便利贴：插入一个可独立打开书写板的小卡片，适合补充长段手写说明。 - 图片与贴纸：在独立手写笔记中插入本地图片、内置贴纸或自定义贴纸。 对象类工具和笔迹工具的区别是：笔迹直接画在页面上；对象会作为可选中的元素保存，后续可以移动、缩放、旋转、删除或调整样式。 ### 摘录胶囊与 AI 解释面板 选中文字、圈画区域或点击已有批注后，页面上会出现一条紧贴选区的“摘录胶囊”。它是 Markdown 标注、PDF 标注和原文批注共用的操作条： - 第一排是五色分类（对应设置中的“五色摘录标签”），选中文本时点击颜色即创建该分类的高亮；已有批注上点击可改分类。 - 样式：下划线、删除线、遮盖；已有批注还可以切回高亮。 - 常用动作：`写想法 / 查看想法`、`复制原文`（圈画为 `复制图片`）、`删除`；圈画区域的胶囊直接提供 `AI 解释` 和 `提取文字`。 - 展开更多后分为两组：`卡片与导出`（AI 解释、添加错题 / 识别并添加错题、导出卡片、入脑图、收藏、存图）和 `引用`（标签、复制回链）。 点击 `AI 解释` 后胶囊会长成一个面板：顶部是可拖动的标题栏，右下角的把手可以拖动调整宽度和回答区高度（双击恢复默认）。面板固定在屏幕上，页面滚动或缩放不会让它漂移；回答生成后下方显示追问按钮（设置中的“追问”）。桌面端快捷键：`Esc` 收起面板（再按一次清除当前选区）、`Ctrl/Cmd+Shift+C` 复制整段回答、`Ctrl/Cmd+I` 把回答插入到当前笔记；在回答里选中一段文字再 `Ctrl/Cmd+C` 只复制选中部分。 圈画区域执行 `提取文字` 后，识别结果直接显示在胶囊下方：一行字数与 `问 AI`、`保存文本` 按钮，下面是可编辑的“文本流核对”区和 `规整断行`。修正后的文字随这条摘录一起保存，批注中心和题库使用的都是修正后的文本。只有胶囊已经不可见（例如识别还没结束就清除了圈画）时才回退到弹窗显示。 ### 样式与视图 - 笔宽与透明度：调整当前绘图工具粗细和透明度。 - 颜色：切换当前笔迹颜色，颜色盘最后一格为自定义颜色入口。 - 缩放：放大、缩小或重置页面缩放。 - 触控输入：「更多」面板中的「手指书写」，在支持的设备上开启手指输入，Pro 版可用。 - 折叠工具栏：减少工具栏占用空间，适合 iPad 横屏或小屏设备。折叠后剩一个可拖动的铅笔按钮。 - 伴随脑图：「更多」面板中，在 Markdown/PDF 标注中打开右侧或底部脑图整理面板，Pro 版可用。 - 批注中心 · 收藏：「更多」面板中，直接打开批注中心的收藏集合。1.0.6 的阅读页卡片抽屉已移除。 - 更多面板：从上到下依次为撤销、重做、浏览模式、激光笔、伴随脑图、批注中心 · 收藏、目录与书签、手指书写、缩放、切换模板、导出 PDF、保存和退出；PDF 桌面端还可见标准批注相关命令。撤销、重做、缩放和手指书写这类可反复点按的操作不会关闭面板；浏览模式、激光笔、伴随脑图、收藏、目录与书签和保存执行后会自动收起。 PDF 对象被选中后会显示紧凑的样式面板。样式面板主要用于调整透明度、边框颜色、边框粗细、填充颜色和字体颜色；宽度、高度和旋转仍通过页面上的控制点直接调整。 ### PC 端操作方式 在 PC 上主要使用鼠标、触控板和键盘操作。 - 书写：选择钢笔或荧光笔后，按住鼠标左键拖动即可书写；使用支持压感的数位板或手写屏时，以设备实际压感表现为准。 - 调整笔迹：再次点按当前已激活的画笔或记号笔打开粗细和透明度设置，选择颜色后继续书写即可应用新样式。 - 擦除：单击橡皮擦切换到擦除工具；再次点按已激活的橡皮擦打开擦除设置，在像素擦除和笔画擦除之间切换。像素擦除适合局部修笔画，笔画擦除适合一次删除整条笔迹。 - 浏览页面：从「更多」面板进入浏览模式，或切换到任一非书写状态后，可以使用鼠标滚轮、触控板或滚动条浏览页面。浏览模式下文档区会显示小手或抓手指针。 - 临时指示：从「更多」面板选择激光笔后拖动指示重点，轨迹会自行淡出，适合演示或屏幕讲解。 - 选择笔迹：选择“框选标注”后，在页面上框选已有笔迹；选中后可复制、粘贴、删除、拖动、缩放或生成回链截图。 - 圈画区域：选择“圈画标注”后圈出目标区域；完成后在摘录胶囊中选择 AI 解释、提取文字、复制图片，或展开更多执行识别并添加错题、导出卡片、入脑图、收藏、存图、标签和复制回链。 - PDF 文本选择：选择文本选择工具后，用鼠标拖过 PDF 文本。选中文本后可在摘录胶囊中选分类颜色、下划线/删除线/遮盖、写想法、复制原文，或展开更多执行 AI 解释、添加错题、导出卡片、入脑图、收藏、标签和复制回链。 - PDF 文本搜索：从标题栏或搜索入口打开浮动搜索框，输入关键词后使用上一个/下一个定位；`Enter` 前进，`Shift+Enter` 后退，`Esc` 关闭。搜索框可以拖动。 - 插入对象：点击添加入口，选择文本、单向箭头、矩形框、圆形、线条、双向箭头或书写便利贴。对象插入后可拖动改变位置，拖拽控制点改变大小，使用旋转控制点调整角度。 - 编辑文本对象：双击 PDF 文本对象进入编辑；也可以右键对象，在菜单中选择编辑文本、样式、透明度或删除。文本对象中的 Markdown（链接、双链、加粗、列表、公式、表格等）会渲染显示，单击其中的链接直接打开。 - 对象样式：选中形状、线条、箭头或文本对象后，在样式面板中调整边框颜色、边框粗细、填充、字体颜色和透明度。 - 右键菜单：对 PDF 对象或部分批注内容点击右键，可打开与当前对象相关的菜单。菜单项会随对象类型变化。 - 保存：长时间书写、插入对象或准备切换文件前，建议点击保存，确保笔迹、文本批注和对象标注已写入数据文件。 新版会把高频手写输入合并到屏幕刷新帧中绘制，并只刷新受影响的画布区域。长 Markdown、跨分页连续书写、荧光笔绘制和包含大量旧笔迹时，抬笔后的整页重绘和重复复制会明显减少。 PC 端更适合做精细选择、文本批注、对象排版和导出前检查。需要连续大量手写时，建议使用手写屏或数位板。 ### 移动端操作方式 在 iPad、安卓平板和触控屏设备上，工具栏会更强调触控、手写笔和小屏空间。 - 书写：选择钢笔或荧光笔后，直接用 Apple Pencil、手写笔或手指在页面上书写。 - 触控输入：如果希望用手指书写，需要开启触控输入；如果主要使用手写笔，建议按设备习惯配置，减少手指滚动时误写。 - 页面滚动：在浏览状态或未锁定为书写输入时，可以用手指上下滑动页面。PDF 文本层允许横向、纵向滚动和双指缩放，只有真正进入文本选择拖拽时才会锁定滚动。 - 缩放：使用双指捏合缩放 PDF 或页面。移动端 PDF 放大后会优先刷新当前可见区域的高清局部画面，减少等待整页重绘造成的卡顿。 - 调整工具：再次点按当前已激活的画笔或记号笔打开粗细和透明度设置；再次点按已激活的橡皮擦打开擦除模式和大小设置。窄屏下弹窗会使用更紧凑布局。 - 擦除：像素擦除适合用手写笔修小范围笔迹；笔画擦除适合快速删除整条误写笔迹。 - 圈画选择：选择“圈画标注”后，用手指或手写笔圈出区域；完成后在摘录胶囊中选择 AI 解释、提取文字，或展开更多执行识别并添加错题、收藏、存图或入脑图。识别结果直接显示在胶囊下方，可就地修正。 - PDF 文本选择：进入文本选择工具后，长按约 0.2 秒开始选词，随后拖动扩大选区；直接滑动仍然是翻页。PDF 与 Markdown 标注页的判定一致。为了避免和页面滚动冲突，建议先放大到合适比例，再进行文本选择。触屏上插件自己绘制选区和拖动把手，不会弹出系统的复制菜单。 - 遮盖：可对选中文字创建遮盖，也可使用“遮盖框选”直接框住图像或公式；在浏览状态点击遮盖块即可显示/隐藏内容。 - 书写中打开批注：不必退出画笔模式。手写笔继续书写，用手指轻点高亮、下划线、批注标记或遮盖块即可直接打开批注菜单，点击空白处收起。手指滑动仍是翻页，只有“按下不移动并快速抬起”才算轻点；刚写完一笔的短时间内手指点击不生效，这是防误触的手掌拒识。开启“手指书写”后手指本身就是笔，此时可用主工具栏上的手形按钮切到浏览模式再点击。框选/圈画模式下轻点已有摘录同样可以直接打开，不必先退出模式。 - 插入对象：点击添加入口插入文本、箭头、矩形框、圆形、线条或便利贴。对象选中后可用单指拖动位置，拖动控制点缩放，必要时先放大页面再精细调整。 - 拖动与系统侧栏：拖动对象、便利贴、回链引用框控制点、浮动工具栏、搜索框或脑图节点时，插件会在该次拖动期间拦截 Obsidian 左右侧栏的滑出手势。正常页面滚动、双指缩放和笔迹输入不受影响。 - 书写便利贴：插入便利贴后，双击卡片打开独立书写板；完成后返回页面，便利贴会显示缩略预览。便利贴适合在移动端补充较长手写说明，避免把页面正文区域写得过密。 - 折叠工具栏：横屏或小屏设备上，可以折叠不常用工具栏区域，为正文和 PDF 页面留出更多空间。 - 保存与导出：移动端导出前建议先保存。新版移动端 Markdown 导出使用安全保存流程，降低权限和内存问题，但大文档或多图文档仍建议分段检查。 新版移动端使用更大的 Markdown 墨迹分片，并让书写中与空闲时保持相同的安全显示倍率，减少高倍缩放下落笔时重新分配多个画布造成的停顿。跨分片笔迹会在相邻分片中增量提交，不需要每次抬笔都重新整理整篇文档的全部笔迹。 移动端更适合连续阅读、圈画、手写批注和快速截图。需要大量文本编辑、精细对象排版或批量整理时，PC 端操作会更高效。 ### 常见工具操作示例 给 PDF 段落做文本批注： 1. 打开 PDF 标注视图。 2. 选择文本选择工具。 3. 拖动选中 PDF 中的文字。 4. 在摘录胶囊中选择分类颜色、下划线、遮盖、写想法、收藏或 AI 解释。 5. 点击保存。 在 PDF 上添加箭头和说明文字： 1. 点击添加入口。 2. 选择单向箭头或双向箭头，在页面中放置对象。 3. 拖动箭头调整位置、长度和方向。 4. 再次点击添加入口，选择文本对象，输入说明文字。 5. 选中文本或箭头后，通过样式面板调整颜色、边框和透明度。 6. 点击保存，导出 PDF 时对象会一起导出。 用圈画标注做 OCR 或 AI 问图： 1. 从“框选/圈画标注”中选择“圈画标注”。 2. 圈出题目、图表、公式或页面局部区域。 3. 在摘录胶囊中选择“提取文字”或“AI 解释”。 4. 识别结果显示在胶囊下方，可在“文本流核对”中修正、点“规整断行”合并硬换行，再选择“问 AI”或“保存文本”；AI 回答可复制或插入到当前笔记。 5. 题目材料可直接选择“识别并添加错题”进入题库。 制作遮盖复习材料： 1. 对可选文字，使用文本选择工具选中答案，再从批注工具中选择“遮盖”。 2. 对扫描页、公式或图片，打开“框选/圈画标注”，选择“遮盖框选”后拖出矩形。 3. 切回浏览状态，点击遮盖块查看答案；再次点击恢复遮盖。 4. 如需统一改变新遮盖颜色或默认显示状态，到插件设置中调整“遮盖颜色”和“默认显示遮盖内容”。 边读边加入思维导图： 1. 点击工具栏的“伴随脑图”，选择已有 `.imap` 或新建脑图。 2. 在结构树中单击一个主题，把它设为收集目标；也可以保持默认“收集箱”。 3. 选中文字、圈画截图或打开已有批注菜单，点击“加入脑图”。 4. 在伴随面板中整理待处理批注，或打开完整脑图继续调整层级和布局。 使用书写便利贴补充长批注： 1. 点击添加入口，选择书写便利贴。 2. 将便利贴拖到合适位置，并调整大小。 3. 双击便利贴打开书写板。 4. 在书写板中用笔补充说明，必要时使用擦除或清空。 5. 点击完成后返回页面，保存当前标注。 ### 保存与退出 - 保存：把当前笔迹、文本批注、独立笔记元素写入插件数据文件。 - 退出：离开标注视图并回到普通阅读或编辑流程。 建议在长时间书写或切换文件前主动保存。 1.0.7 起自动保存不再与书写抢主线程：保存前的笔迹整理、分页归属和 JSON 编码都分批执行，落笔时会立即让出并在抬笔后重新取快照；大 PDF 保存前的离屏页面清理同样分批进行。退出、导出等场景的强制保存仍会同步完成。密集重叠的历史笔迹会缓存为位图分块，追加一笔时不再整块重画；缩放但实际分辨率不变时也不再重建画布。以上均不改变笔迹文件格式。 首次为新 Markdown 或 PDF 建立标注文件时，如果数据目录位于普通、可索引的 Vault 文件夹，插件会优先使用 Obsidian Vault 的协调写入接口；默认隐藏插件目录则使用底层适配器，并在失败时回退到 Vault API。若移动端文档提供器、云同步或文件监听器引发创建竞争，插件会重新检查目标后自动重试。覆盖已有标注文件前仍会刷新同路径的 `.bak` 恢复副本。若所有写入路径都失败，插件会保留错误而不会把未成功写入误报为保存完成。 ## 6. Markdown 标注 Markdown 标注适合在笔记阅读视图上直接做圈画、箭头、手写补充和重点标记。 基本流程： 1. 打开一篇 Markdown 笔记。 2. 点击左侧铅笔图标，或运行 `Open mobile ink annotation for current note`。 3. 使用钢笔、荧光笔或橡皮擦进行标注。 4. 点击保存。 Pro 版可进一步使用： - 圈画选择：圈出笔记中的局部区域，执行截图、OCR、AI 问图、收藏、添加错题或加入脑图。 - AI 问答：对选中内容或截图内容提问。 - 原文批注：在 Markdown 源文中绑定批注，后续可通过侧栏查看。 - 书写便利贴：在 Markdown 标注页插入可拖动、缩放、删除的手写便利贴。 - 回链截图：生成可回跳到源位置的图片或链接。笔记里的手写回链卡片会优先显示批注中心渲染的“笔迹所在页面区域”截图，没有截图时在方格纸上绘制整组笔迹；刚写完就导出也能立即显示，不必等保存完成。 - 遮盖框选：为 Markdown 阅读页面的任意矩形区域创建遮盖。 - 伴随脑图：在不离开阅读页的情况下采集文字、截图和已有批注。 原文批注侧栏采用类似 SideNote 的侧边查看方式，但数据接入插件自己的 Markdown 源文件批注体系。它适合在阅读长文时把批注绑定到原文位置，并在侧栏中集中查看和维护。 ## 7. PDF 标注 PDF 标注适合阅读论文、教材、讲义和扫描件。 基本流程： 1. 打开 PDF 文件。 2. 若已开启 `PDF 默认使用标注视图打开`，PDF 会自动进入插件视图；否则从命令面板或 Ribbon 手动打开。 3. 使用钢笔、荧光笔、橡皮擦进行页面标注。 4. 点击保存。 Pro 版支持 PDF 文本批注： - 选中文本后创建高亮、下划线、笔记或遮盖。 - 对选中文本发起 AI 问答。 - 将重点文本或截图收藏到批注中心。 - 将题目材料 `添加错题` 进入题库。 - 将选中文字或已有批注加入当前思维导图。 - 导出带有标注的 PDF。 Pro 版还支持 PDF 对象标注： - 点击添加入口后，可插入文本、矩形、圆形、线条、单向箭头、双向箭头和书写便利贴。 - 插入后的对象可以拖动、缩放、旋转和删除。 - 文本对象支持双击再次编辑，也可以通过右键菜单进入编辑。文本中的 Markdown 语法（链接、`[[双链]]`、加粗、列表、引用、`$公式$`、表格等）会渲染显示，不含 Markdown 语法的纯文本保持原样；单击渲染出的链接会打开目标，双击仍进入编辑。 - 形状默认使用黑色边框和空心填充，可在样式面板中调整边框、填充和透明度。 - 线条、箭头和形状会随批注保存，重新打开 PDF 后会恢复显示。 对扫描版 PDF，如果没有可选文本，可以使用圈画选择后执行 OCR。 ### PDF 导航与搜索 - `目录与书签`：在 PDF 有目录或书签数据时快速跳转章节。 - 对少数经过 WPS 导出或合并后“保留目录文字、但把目标页引用写成空值”的扫描 PDF，点击目录项时会尝试把目录项与可视目录页的链接行配对，并使用已配置的 OCR 只识别该行最右侧的印刷页码，再跳到正文页；识别结果会在当前视图中缓存。未配置 OCR 时会明确提示源 PDF 的目录目标已损坏。标准目录目标不走此回退，也不会调用 OCR。 - 文本搜索：输入关键词后在匹配位置之间前后跳转；移动端会限制一次构建的匹配数量，以避免大文档占用过多内存。 - 页码与缩放：可通过页面导航、滚轮/触控板、双指捏合和更多菜单中的缩放操作浏览。 - 桌面端高清放大：如高倍放大后文字偏糊，可在设置中开启高清 PDF tile；大文件卡顿时应关闭。 扫描版 PDF 没有真实文本层时，文本选择和全文搜索可能不可用，应改用圈画截图加 OCR。 ### PDF 出链引用框 当库内 Markdown、白板或 `.imap` 节点包含指向 PDF 批注或区域的回链时，页面会显示引用框。点击可跳到来源，右键可复制或删除来源引用；拖动四角可修正引用范围。若不需要这些提示，可在设置中关闭 `PDF 出链显示`。 ### 标准 PDF 批注互操作 PDF 的更多菜单提供以下操作，其中“导出标准 PDF 批注”和“写入标准 PDF 批注”仅支持桌面端： - `导入标准 PDF 批注`：把 PDF 文件内部已有的文本批注、墨迹和支持的对象合并到插件数据中，并自动去重。打开 PDF 时也会按可见页面逐步尝试导入内置批注。 - `导出标准 PDF 批注`：保留原 PDF 页面并生成同目录的 `<原文件名>-标准批注.pdf`，源文件不变。 - `写入标准 PDF 批注`：先在源 PDF 同目录创建带时间戳的 `standard-annotation-backup` 备份，再用追加了标准批注的内容覆盖源 PDF；执行前会再次确认。 - `导出 PDF`：面向最终阅读效果的通用导出；遇到无法稳定表示为标准批注的对象时会自动回退为所见即所得输出。 遮盖属于插件内复习交互，不作为普通标准 PDF 文本批注导出。若希望导出的 PDF 保留当前视觉遮盖效果，请使用通用“导出 PDF”并检查结果。 ### 虚拟 PDF 虚拟 PDF 用于标注在线 PDF 或 Obsidian 库外的本地 PDF，而不必先复制整份原文到库内。 1. 运行 `Create virtual PDF from URL or file URI`。 2. 输入 `https://.../paper.pdf`、`http://.../paper.pdf`，或桌面端可访问的 `file:///D:/Docs/paper.pdf`。 3. 选择库内占位文件目录，默认 `External PDFs`，并可自定义文件名。 4. 插件创建一个很小的 `.pdf` 占位文件并立即打开标注视图；笔迹、批注和回链都绑定到该占位文件。 注意：在线地址需要联网且服务器允许下载；`file:///` 依赖桌面端文件系统能力，移动端通常无法读取库外本地路径。不要用普通 PDF 阅读器编辑这个占位文件，它的内容只是源地址而不是真实 PDF 数据。 ## 8. 独立手写笔记 独立手写笔记使用 `.mink` 文件保存，适合做草稿纸、课堂笔记、会议白板、手账和月历计划。 ### 创建笔记 运行命令 `创建新的独立手写笔记` 后，插件会在配置的独立手写笔记目录中创建新文件。 ### 纸张模板 独立笔记支持多种模板： - 空白页 - 横线纸 - 方格纸 - 点阵纸 - 康奈尔笔记 - 月历手写 iPad 上的月历模板已经针对顶部空间做了优化，标题会避开 Obsidian 顶部工具栏遮挡。 ### 插入元素 独立笔记可插入： - 图片 - 形状 - 贴纸 - 文本 - 书写便利贴 贴纸包含内置贴纸和自定义贴纸。即使当前处于笔画工具状态，也可以通过贴纸入口插入贴纸。 书写便利贴会作为独立对象保存。插入后页面上显示一张小卡片，双击卡片可打开独立书写板；书写板支持笔、擦除、清空和完成。便利贴本体可以拖动、缩放和删除，重新打开后会保留书写内容并显示缩略预览。 ### 多页管理 独立笔记支持添加页面和删除当前页面。多页内容会随 `.mink` 文件一起保存，导出 PDF 时也会按页面输出。 ## 9. 圈画截图、OCR 与 AI 问图 Pro 版的“圈画标注”工具用于把页面局部区域转换成可操作对象。 圈画完成后，摘录胶囊直接提供两个主动作： - `AI 解释`：把截图发送给视觉模型并提问，回答显示在胶囊长成的面板里，可追问、复制或插入到当前笔记。 - `提取文字`：调用百度 OCR 识别截图。识别结果显示在胶囊下方，可在“文本流核对”里修正、用 `规整断行` 合并识别出的硬换行，再 `问 AI` 或 `保存文本`。修正后的文字随这条摘录保存。 展开更多后还有： - `识别并添加错题`：先识别文字，再连同截图一起交给 AI 抽取成题库题目，详见“题库与复习”。 - `导出卡片`：生成独立的卡片笔记。 - `入脑图`：保存截图并在当前 `.imap` 中生成图片节点。 - `收藏`：把截图（及已有的识别文字）收藏到批注中心的收藏集合。 - `存图`：把截图保存到“截图数据”目录。 - `标签` / `复制回链`：给这条摘录加标签，或复制可回到原文位置的链接。 OCR 适合处理教材截图、扫描 PDF、图片中的题目或表格。AI 问图适合让模型解释图表、公式、题目截图或页面结构。发给 AI 的截图会先按“PDF 预览裁切”裁到圈选范围，并在发送前压缩（桌面长边 1280、移动端 1024），已足够小的图片不会重编码。 ## 10. AI 问答 AI 问答用于纯文本场景，默认使用标记为 `文本默认` 的模型预设，也可以在问答面板顶部的模型标签上临时切换。 可用入口包括： - 对选中文本提问。 - 对 PDF 文本批注提问。 - 对 Markdown 原文或批注内容提问。 - 在开启 RAG 时，结合本地库召回片段提问。 当请求中包含截图或图片时，插件会改用标记为 `图片默认` 的预设。 同一会话可积累多个上下文，但默认只发送最新图片；出现两张以上图片时，可开启“多图”进行比较。只支持单图的模型预设会显示“单图”且禁用多图开关。快捷提问气泡与问答侧栏使用相同的上下文和历史。 问答侧栏支持新建会话、清空当前会话、编辑/复制/删除单轮内容、重新生成回答、复制最新回答，以及开启或关闭当前会话的 RAG。启用历史记录后，可从“历史会话”中搜索、置顶、重命名、删除或继续以前的会话。 切换到由服务端保存会话的浏览器代理时，插件会在需要时先重置服务端会话，再回放本地历史。新建、清空、编辑、删除、停止生成和重新生成都会使远端状态在下一次请求前重新同步。清空会话会同时移除上下文；删除会话或清空全部历史时，也会清理插件生成的 AI 截图。 如果需要把回答绑定回当前选中文本、批注或截图，可以使用问答界面中的关联操作；关联后可从批注或区域继续查看对应的 AI 内容。 把回答写回笔记时，可以选择插入目标：当前笔记、发起提问时选中的文本，或截图区域所在位置。目标笔记已经关闭或无法编辑时会明确提示，不会静默丢失内容。切换服务商配置档后，可先用连通性探测确认 Endpoint、模型和传输方式可用，再开始提问。 ### 超时与传输方式 - 流式回答如果 180 秒内没有收到任何数据，会断开并提示“服务可能已停止响应”；不支持流式的缓冲请求最长等待 300 秒；首次连接某个 Endpoint 时的预检 8 秒超时。超时后会话不会卡在“正在思考”，可直接重试。 - 桌面端在常规流式请求因跨域限制失败时，会自动改用 Node 直连的流式传输，对不返回跨域头的 OpenAI 兼容中继也能逐字输出。该路径不经过系统代理和系统证书，只作为回退；移动端不提供。 - 开启 RAG 时召回内容总量限制在 6000 字符、单条 1400 字符，超出部分截断或省略，避免浏览器代理把提问截掉。 ### 题目抽取任务 从阅读页或批注中心发起“添加错题 / 整理为题目 / AI 补全讲解”时，材料和抽取指令会以“待确认任务”的形式放入问答侧栏：材料固定，你可以修改提问后再发送，也可以选择 `仅提问`（保留材料和提示词，但这次回答不写入题库）。任务包含多张图片时需要选择支持多图的模型并开启多图；材料图片不可用时不会发送不完整的任务。重新生成不会重复写入题库。 ## 11. 收藏 1.0.7 起，卡片收藏夹并入批注中心：阅读时点击「收藏」的内容进入 `批注中心 → 我的收藏`，也就是内置的「收藏」集合。不再有独立的收藏夹视图、Ribbon 书签图标和阅读页卡片抽屉。 可收藏的内容包括： - PDF 或 Markdown 文本片段。 - 圈画截图区域（连同已识别的文字）。 - 已有的高亮、下划线、批注或原文批注。 - 笔迹选择生成的截图。 已经是批注的内容收藏时直接使用原记录，不会复制一份；没有批注的文字和截图会生成一条摘录记录，并保留“收藏时的内容”快照，即使原批注之后被删除，收藏里仍能看到当时的原文和截图。 在收藏集合里，每条收藏和普通批注一样可以转文字、写思考、追问 AI、整理到笔记、加入其他集合、生成学习卡片或添加到题库；在条目上点 `取消收藏` 即可移出。收藏本身没有单独的学习状态，复习请使用题库。 ### 从旧版收藏迁移 首次打开批注中心时，插件会把 1.0.6 及更早版本的卡片收藏迁移一次：保留原文、截图、回链和状态；原“学习中”以标签和原状态记录保留，“已掌握 / 已归档”对应批注中心的已归档状态。旧收藏文件保留为备份，不会删除；已经从收藏中移除的条目不会在下次启动时重新导入。 命令 `Open card favorites` 改名为 `打开批注中心 · 收藏`；旧的收藏夹工作区标签重新打开时会自动跳到收藏集合。设置中的“旧收藏迁移来源”只用于读取旧备份文件，新收藏保存在批注中心数据目录。 ## 12. 批注中心 批注中心用于集中查看不同来源的标注与批注，适合复盘整本书、整篇论文或一组课程资料。1.0.7 起它是一个三栏工作台：左侧「范围导航」，中间批注列表，右侧详情抽屉默认收起，点击任一批注时滑出。面板较窄时导航和抽屉改为浮层，点击遮罩或 `Esc` 关闭。 ### 范围导航 导航顶部的“阅读工作台”提供固定范围，每项显示计数： - `全部批注`、`最近 7 天`。 - `我的收藏`：内置「收藏」集合，见“收藏”一章。 - `已整理题目`：已经生成过题库题目的批注。 - `收集箱` / `已归档`：批注只有这两种处理状态。 - `题库`：切换到题库面板，计数是当前到期待复习的题目数，见下一章。 下方是“精读集合”：可新建、编辑集合（名称、图标、颜色），一条批注可属于多个集合。搜索行左侧的“范围导航”按钮可以收起或展开导航；窄屏下它控制浮层开合。 ### 视图与筛选 顶部搜索框匹配原文、我的思考、OCR 文字、文档名，以及被折叠的 AI 回答。视图切换有三种： - `按文档`：批注按来源文档分组，组头可折叠；“文档操作”菜单提供打开原文、只看本文档、整理到笔记、导出多维表、归档当前文档结果。`全部折叠 / 全部展开` 一键处理所有分组。 - `瀑布流`：多列卡片平铺，适合全局浏览。 - `表格`：高密度条目表，行首固定“跳转原文”，可通过“选择显示的列”开关类型、摘录、来源、位置、标签、状态、连接、更新时间、创建时间（标签和创建时间默认隐藏）。 `筛选` 打开弹窗：来源文档、内容形态（文本 / 图片区域 / 手写批注 / 独立手写页）、标签；“更多筛选与排序”里有来源类型、状态、知识连接（已关联 / 未关联 / 已有卡片 / 源文件缺失）、AI 状态（已解答 / 未解答）、OCR 状态（已识别 / 待识别）、更新时间和排序。生效的条件以胶囊显示在搜索框下方，可单独移除或一键清空。列表较长时分批加载，点击“加载更多”继续。 由 AI 追问产生的派生批注默认折叠到源批注下，源批注卡片显示「N 条 AI 回答」，答案在详情中查看。需要单独管理这些记录时，在筛选弹窗中开启 `显示 AI 生成的批注`。没有有效父记录的 AI 记录始终独立显示。 “更多”菜单提供选择当前全部结果、导出 Markdown 汇总、导出多维表、复制 Markdown、批量生成卡片和清理失效批注（源文件已不存在的记录）；Markdown 导出与复制的格式由设置中的“批注中心导出样式”控制。`刷新` 重建索引。 ### 批注卡片与详情抽屉 卡片显示类型、摘录或预览图、来源与位置、标签、集合和连接状态；手写和圈画在滚动到可视范围后才生成预览。PDF 区域预览按整页位图合成后裁切，框内的笔迹和文字标记一并可见，裁切范围由设置“PDF 预览裁切”决定。PDF 手写记录的预览按阅读页的连续文档布局定位，打开中的阅读页会提供尚未保存的笔迹和实际页面尺寸；同一组笔迹换了布局宽度会重新生成预览，不会沿用错位的旧图。真实页面截图不叠加方格纸背景。 点击卡片打开右侧详情抽屉： - `原文`：大图预览与原文上下文，`跳转原文` 回到来源位置。 - `我的思考`：直接编辑，自动保存；保存失败时草稿保留，重新打开后可重试。 - `AI 助读`：`解释 / 总结 / 联系` 三个一键提问，也可输入问题（Enter 发送，Shift+Enter 换行），生成中可停止；回答沉淀到这条批注上，可继续追问。 - `识别文字`：对手写和图片批注执行 OCR，可编辑、重新识别。 - `知识连接`：显示关联笔记和已整理到笔记的块，可 `关联已有笔记`。 - 标签、集合、收藏，以及 `整理到笔记` 和“更多”。 单条批注的“更多”菜单：整理到笔记、打开原文、复制 Markdown、关联已有笔记、归档 / 放回收集箱、AI 学习卡片、AI 错题卡片、添加到题库、打开关联题目、制作思维导图、删除。 键盘：`J / K` 或方向键移动焦点，`Enter` 打开详情，`Space` 打开或关闭详情，`X` 勾选，`A` 归档并跳到下一条，`O` 打开原文，`Esc` 关闭详情。 ### 整理到笔记 `整理到笔记` 把一条、多选或整个文档分组的批注写入你指定的 Markdown 笔记：先选择已有笔记，再选择插入位置（追加到笔记末尾，或某个二级标题之下），弹窗中可预览将要写入的 Markdown。每条批注写成带稳定块 ID（`^anno-`）的引用块，包含原文回链、原文或识别文字、我的思考和预览图；每一条批注（包括手写）都会生成预览图，处理时显示“正在准备批注预览图（n/N）…”，某条生成失败只影响该条并在完成提示中注明条数。手写批注由回链卡片本身展示预览图，不会在卡片上方再嵌一张。重复整理到同一笔记不会重复插入，只会同步回链。写入位置记录在批注上，详情抽屉的“知识连接”里可以跳回。 ### 多选与批量操作 点击 `多选` 进入勾选模式（或按 `X`），底部出现批量操作条：`整理到笔记`、`加入集合`，以及“更多”里的复制 Markdown、归档所选、放回收集箱、导出多维表、批量生成卡片、整理所选为错题、AI 批量汇总（一次最多 20 条）和制作思维导图。切换筛选后不在当前结果中的勾选项会被清除。 ### 单条批注上的 OCR 与 AI 手写批注和图片批注支持 `转文字`：识别结果、状态和错误信息缓存在这条批注上，可以编辑、保存、复制、重新识别或单独删除。`追问 AI` 的回答沉淀在批注上，可展开查看、复制或删除。`AI 学习卡片` / `AI 错题卡片` 把批注原文、OCR 文本和 AI 回答输出为结构化卡片笔记；已生成的卡片可从批注直接打开。删除 AI 摘要、单条 AI 回答或 OCR 结果时只清除对应内容，原始手写、截图和文本批注不受影响。 ### 导出为多维表 `导出多维表`（当前列表、所选或单个文档）会在库内生成独立的 `.duowei` 文件，字段包含摘录、附近原文、批注说明、我的理解、OCR 文字、AI 摘要、AI 问答、来源文件、批注定位、来源类型、页码、位置、集合、标签、状态、创建/更新时间、相关笔记和学习卡片，并预置 `表格`、`批注画廊` 和 `按状态` 三个视图。 该文件由多维表格插件打开，两个插件相互独立安装，本插件不参与后续的表格编辑与同步。导出在本地完成，不经过任何服务端。 ## 13. 题库与复习 题库建立在批注中心之上：批注是原料，题目是独立的结构化记录，保存在批注中心数据目录下的 `question-bank.json`。在范围导航中点击 `题库` 进入题库面板；点击面板导航顶部的按钮返回批注中心。 ### 把材料变成题目 三个入口： - 阅读页：选中文字、圈画区域或打开已有批注后，在摘录胶囊“更多”里选择 `添加错题`（圈画为 `识别并添加错题`，会先 OCR）。不必先进入批注中心；选中文字会先按当前分类颜色生成一条高亮、圈画会保存这块区域摘录，题目来源指向这条批注，已有批注则直接复用。 - 批注中心：单条批注“更多”菜单的 `添加到题库`，或多选后的 `整理所选为错题`。 - 题库面板：`新建题目` 手工填写。 一次最多合并 8 份材料。多份材料时会弹出“整理为题库题目”窗口：标注每份材料的用途（题干 / 答案 / 解析 / 上下文 / 综合材料），选择 `合并为一道题` 或 `每份各自成题`，再选择 `放入侧栏再确认` 或 `确认无误，直接发送`。材料已经在题库中时提示 `补充材料`（作为上下文追加到已有题目）、`打开题目` 或 `另建新题目`。 抽取由你在 AI 侧栏确认后发送。AI 只负责题干、题型、选项、答案、解析、秒杀技巧、知识点、错因、难度、学科；文件路径、页码、坐标、回链和截图由插件生成。原文没有答案时答案留空并标记 `待补答案`，不会编造；非题目材料标记为 `非题目`；模型返回的字段置信度低于 0.6 时显示“待核对”。新抽取的题目默认为 `待复核`。 ### 题库面板 - 顶部：`分类导航` 开关、搜索框（`Ctrl/⌘ K`，匹配题干、知识点、学科、来源）、`新建题目`、`刷新并同步笔记`、“更多”和 `开始今日复习`。 - 筛选轨道：状态胶囊 `全部 / 到期复习 / 顽固错题 / 待复核 / 待完善`，题型和错因下拉。 - 视图：`题卡流`（答案默认遮罩，点击展开答案、我的作答、解析、技巧和错因，卡片左侧色条按错因着色）、`紧凑表格`（答案列可就地编辑，适合快速补答案）、`独立复习`。 - 左侧分类导航按复习状态、题库合集、学科、标签分组并显示计数，另有“未标注学科”“无标签”“未归入合集”桶方便补分类；面板不足 900px 宽时导航和详情改为浮层。 “更多”菜单：新建 / 重命名 / 删除题库合集、所选题目加入或移出合集、批量核对当前筛选或已选题目、导出（多维表 / Anki TSV / 自测卷 Markdown）、开始专项练习、导入旧版错题卡。合集只是归属，删除合集不会删除题目或复习记录。 ### 题目详情与核对 点击题目打开详情抽屉，可编辑题干、题型、选项（勾选正确项）、答案、解析、秒杀技巧、知识点、我的作答、错因、错因分类、难度、学科、标签，查看来源材料、关联笔记、复习状态和最近 20 条复习记录。 - 手工修改过的字段自动加锁，之后 `重新抽取` 不会覆盖；可对单个字段解锁或 `重新抽取此字段`。 - `AI 补全讲解`：按设置里的“题库讲解方向”补写解析、技巧与考点；可选 `只写解析与考点` 或 `连答案一起推导`，推导出的答案标记为 `AI 推导（需核对）`。 - 来源：`添加来源材料`（从批注中挑选题干、答案或解析批注）、`更新来源快照`、`跳转原文`、`打开来源文件`；原批注变化或删除时显示“来源已变化 / 已解绑，保留材料快照”。 - 勾选抽屉底部的 `已核对题干、选项和答案，可以进入复习` 后题目才会进入复习队列；题干或答案为空时无法勾选。题干、题型、选项、答案、来源用途或来源 OCR 文本再次变化会自动取消核对。 - 抽屉关闭即保存；保存失败时抽屉保留并提示原因，另有 `放弃修改`。删除题目会保留原批注、生成的笔记和截图。 ### 复习 `开始今日复习` 或切换到 `独立复习` 视图后进入单题作答： - 队列按“学习 / 重学到期题 → 到期旧题 → 新题”出题，受“每日复习上限”限制；等待页显示下一题到期时间并自动唤醒。 - 作答：客观题选择选项、主观题输入文字或心答，`提交答案` 或 `显示答案与解析`（空格）。客观题对错单独记录，不替代记忆评分。 - 评分四档：`忘记了 / 想起但困难 / 正常想起 / 轻松想起`（数字 `1–4`），按钮上显示预计下次间隔；使用 FSRS 调度，目标保持率在设置中调整。 - `撤销上次评分`（`Ctrl/Cmd+Z`）恢复上一题的作答与调度；`稍后继续` 保存断点，`结束本轮` 结束会话但不删除历史、不改到期时间。未提交的草稿保存在本机。 - 本题思考用时显示在题卡上，展开答案即停表；番茄钟默认 25 分钟跨题连续，胶囊上可设 1–180 分钟、暂停、重置。 - `标记已掌握` 不退出调度；选择“忘记了”会清除掌握标记。`暂停复习` 停止出题，恢复后保留原到期时间。累计遗忘 8 次的题目标记为 `顽固错题`，建议回到来源材料修复。 - 答案展开后可查看来源截图或保存的原文快照，题目阶段保持遮罩。 - `开始专项练习（不改变复习计划）` 按当前筛选练习未到期题目，保存作答和统计，但不改变 FSRS 到期时间。 - 本轮结束显示完成次数、回忆正确率和平均思考时间。 ### 复习时手写演算 复习页右下角的入口（快捷键 `W`）打开手写草稿，有三种形态：整页原位手写（透明层覆盖题卡）、双栏草稿纸（窄屏改为下方抽屉）、纯净稿纸（整屏演算，顶部保留题目摘要）。悬浮工具条提供钢笔（`P`）、荧光笔（`H`）、笔画橡皮（`E`）、触控互动（`D`，用手指点选项和滚动）、五色、三档粗细、隐藏笔迹、撤销重做、清空和退出；底纹可在方格 / 点阵 / 横线 / 纯白间切换。 手写笔与手指的判定和阅读页一致：看到手写笔后的 1.2 秒内手指只滚动不书写，之后恢复；“书写”胶囊可在自动 / 仅触控笔 / 手指之间切换。提交评分时两块稿纸会裁到笔迹范围拼成一张快照随复习记录保存；草稿随文字作答一起写入本机断点，`稍后继续` 不会丢失演算。 ### 笔记同步与导出 题目可同步为库内笔记 `Annotations/QuestionBank/<题目 ID>.md`（`同步笔记`）。题干、答案、解析、我的错因四个区段可以在 Obsidian 里直接修改，回到题库时自动回读并锁定对应字段；选项、技巧、我的作答、分类、来源使用受保护的补充区段随题目同步，个人增加的其他段落保留。进入题库、刷新和开始复习时会自动同步已有关联笔记；没有关联笔记的题目不会自动创建文件。补充区段被外部修改时停止同步并提示人工合并；被删除的笔记只在显式点击 `同步笔记` 时重建。复习评分只写题库文件，不会重写笔记。 导出： - `Anki TSV`：带稳定 GUID 和 `#guid column` 指令，自动写出 mastered / suspended / leech 标签，重复导入可沿用同一张卡。 - `自测卷 Markdown`：前半部分是题目，后半部分是参考答案与解析。 - `多维表`：含错因分类看板视图的 `.duowei` 文件。 - `导入旧版错题卡`：扫描 1.0.5 生成的错题卡片笔记，按“题目内容 / 解析 / 秒杀技巧 / 考察知识点 / 错误原因”章节导入，答案留空待补。 ## 14. 原文批注 原文批注用于 Markdown 源文绑定。你可以在编辑器中选中一段文字，运行 `Add markdown source annotation`，或直接使用选区工具条（五色摘录，数字 `1–5` 快速分类，下划线和加粗可直接点），为这段原文添加颜色、类型和说明。后续可通过原文批注侧栏集中管理，也会出现在批注中心。 原文批注数据默认保存在插件目录下的 `md-source-annotations/annotations.json` 中；自定义存储目录后以设置为准。文件修改或重命名后，插件会按选中文字、前后上下文和所在标题路径重新定位批注，而不是沿用失效的绝对位置。 原文批注侧栏可以在“当前文件”和“全部”之间切换并搜索原文或批注，可按正文位置或创建时间排序、折叠全部批注、导出当前范围为 Markdown。每张卡片支持定位原文、编辑、复制回链、收藏和删除；删除后短时间内可撤销；如果源文变化后无法重新定位，会显示“位置待恢复”。由脑图节点自动建立的链接型原文标记不会作为普通批注卡片显示。 ## 15. 批注思维导图 Pro 版使用 `.imap` 文件保存批注思维导图。新建脑图默认放在库内 `Mind Maps` 文件夹；如果该文件夹无法创建，则回退到库根目录。`.imap` 使用与 Ink Whiteboard `WhiteboardData version: 1` 兼容的数据结构，保存节点、结构边、来源回链、截图、视口和布局信息。 ### 创建与打开 - 点击左侧分支图标或运行 `创建批注思维导图`，创建空白脑图。 - 在批注中心选中一条或多条批注后点击“制作思维导图”，会按来源文件分组生成主题与批注节点。 - 双击 `.imap` 会由插件注册的脑图视图打开；若扩展名被其他插件接管，可运行 `使用标注思维导图打开当前 .imap`。 ### 编辑主题 - `Tab`：给当前主题添加子主题。 - `Enter`：添加同级主题。 - `Shift+Enter` 或 `F2`：编辑标题；编辑时 `Enter` 保存、`Esc` 取消。 - `Space`：折叠或展开分支；折叠徽标会显示隐藏的子孙数量。 - `Delete` 或 `Backspace`：删除所选分支，中心主题不能删除。 - 方向键：在父主题、子主题和同级主题之间导航。 - `Ctrl+Z`：撤销；`Ctrl+Shift+Z` 或 `Ctrl+Y`：重做。 拖动主题到另一主题中部，会把它变成目标的子主题；拖到目标上缘或下缘，会插入为前一个或后一个同级主题；拖到空白处会回到自动布局位置。右键节点还可添加子主题/同级主题、编辑、折叠、设置收集目标、打开来源、复制回链或删除分支。 ### 布局、画布与图片 - 布局支持放射、向右、向左和树形；切换布局或点击“整理导图”会重新自动排布并平滑过渡。 - 滚轮缩放；触屏双指捏合缩放和平移；右下角提供缩小、恢复 100%、放大和适合内容。 - `Ctrl+0` 适合内容，`Ctrl+=`/`Ctrl++` 放大，`Ctrl+-` 缩小。 - 一级分支会自动分配颜色，连接线和批注卡左侧色条保持一致。 - 可从仓库选择图片、导入本地图片、粘贴剪贴板图片，也可直接拖放图片或在脑图视图按 `Ctrl+V`。 - 从本地文件或剪贴板导入脑图的图片，默认复制到脑图同目录的 `assets`；如果脑图位于库根目录，则使用 `Mind Maps/assets`。从阅读页圈画加入脑图的截图保存到“截图数据”目录。 ### 边读边采集 Markdown/PDF 标注视图中有三个“加入脑图”入口： - 选中文字：生成带原文位置和回链的摘录节点。 - 圈画区域：保存截图并生成图片节点。 - 已有批注：按批注记录去重，避免重复加入。 内容优先进入当前脑图中固定的“收集目标”主题；未固定目标时进入自动创建的“收集箱”。如果尚无 `.imap`，插件会先创建脑图。新节点会自动移入视野并闪烁提示。 ### 伴随脑图面板 点击标注工具栏中的“伴随脑图”。桌面和平板通常显示在阅读区右侧，窄屏设备显示为底部面板。 1. 选择或新建 `.imap`；该选择与快速“加入脑图”共享。 2. 在结构树中单击主题，把它设为收集目标；再次单击取消，图钉表示当前目标。 3. 在“待整理批注”中勾选多条后点击“加入目标”，点击单条加入按钮，或把整张卡片拖到结构树中的任意主题；分屏打开完整脑图时，也可以把卡片直接拖到完整脑图节点上。 4. 开启“自动加入”后，当前文档新保存的批注会自动进入目标主题。 5. 双击结构节点或点击展开按钮，在分栏中打开完整脑图。 完整脑图与伴随面板会同步内容。目标脑图已打开时，快速采集直接修改该视图中的内存文档并保留撤销能力；未打开时由统一服务安全读写文件，减少并发覆盖。 ### 跳回原文与调整区域 带来源的节点悬停时会出现跳转按钮，也可以右键选择“跳回原文”或“打开节点来源”。截图节点选择“调整原文区域”后，会回到 PDF/Markdown 并显示可调整的引用框；拖动四角更新范围后，脑图中的截图和回链会一并刷新。 ### 导出脑图 完整脑图工具栏可导出： - Markdown：层级列表，并尽量保留 Obsidian 回链。 - OPML：适合与支持 OPML 的大纲/脑图软件交换。 - FreeMind `.mm`：适合导入兼容 FreeMind 格式的软件。 导出文件保存在 `.imap` 同目录，文件名为 `<脑图名>-导出`；若重名会自动追加序号。 ## 16. 导出 PDF Pro 版支持导出 PDF。 可导出的内容包括： - Markdown 标注页面。 - PDF 原文及其手写、文本批注和对象标注。 - 独立 `.mink` 手写笔记。 - 独立笔记中的图片、形状、贴纸、文本和书写便利贴。 新版导出逻辑会根据内容类型自动选择更合适的导出方式： - PDF 原文导出优先保留原 PDF，并以增量方式追加标准批注，减少整份 PDF 重栅格化导致的模糊、体积变大或卡顿。 - 手写笔迹会尽量写为标准 `/Ink` 批注。 - 矩形、圆形、线条和箭头会尽量写为标准 PDF 形状或线条批注，并保留实线、虚线、点线等边框样式。 - 文本、贴纸、书写便利贴等外观不稳定的对象，会在需要时回退到所见即所得导出，保证视觉上不会丢失。 - 移动端 Markdown 导出会使用更稳定的分片和安全保存流程，降低内存过高或没有权限保存 PDF 的风险。 导出前建议先保存当前标注，确保最新笔迹和元素已经写入数据文件。 ## 17. 数据存储与隐私 插件主要数据保存在当前 Obsidian 库内。 常见数据位置： - 手写与文本批注：默认位于插件目录下的 `annotations` 数据目录，也可在设置中自定义。 - 独立手写笔记：设置中的独立手写笔记目录，默认 `Handwriting`。 - 批注中心工作流与收藏：默认位于插件目录下的 `annotation-center`（`index.json`）。 - 题库：同一目录下的 `question-bank.json`，每次写入前生成 `question-bank.json.bak`；题目同步的笔记位于库内 `Annotations/QuestionBank/`，只在你点击同步笔记时创建。 - 旧版卡片收藏备份：插件目录下的 `card-favorites`，迁移后只读不删。 - 整理到笔记：写入你指定的 Markdown 笔记，每条批注带 `^anno-` 块 ID。 - 原文批注：默认位于插件目录下的 `md-source-annotations`。 - 自定义贴纸：设置中的自定义贴纸素材目录，默认 `Handwriting/Stickers`。 - 截图文件：默认位于插件目录下的 `captures`，也可在“数据存储目录”中自定义。 - 批注思维导图：默认位于库内 `Mind Maps`；脑图本地导入图片通常位于脑图同目录的 `assets`。 - AI 会话历史：启用历史记录时保存在本地插件数据中。 - 批注上的 OCR 文本、AI 摘要、AI 回答、标签、收藏快照和笔记块记录：随批注中心工作流索引一起保存在 `annotation-center` 目录中，不单独成文件。 - 复习评分、作答记录、思考耗时和手写演算快照：保存在 `question-bank.json` 中；未提交的作答草稿和番茄钟状态只保存在当前设备。 - 导出的多维表：按导出时选择的位置保存为库内的 `.duowei` 文件。 修改自定义数据目录前，建议先备份并手动迁移旧目录。单纯修改设置不会自动把旧数据复制到新位置；切换后若发现数据为空，应先恢复原路径，再检查迁移结果。 OCR 和 AI 功能会把待处理文本或图片发送给你配置的外部服务商。API Key 和 Secret Key 保存在本地插件设置中，请根据团队或个人隐私要求决定是否启用相关功能。用户主动点击目标页引用已经损坏的 PDF 目录项时，插件也可能调用已配置的 OCR，但只发送目录行最右侧的印刷页码小裁剪，不发送整页或整份 PDF；正常 PDF 目录不会调用 OCR。 批注中心的转文字、追问 AI、生成卡片、批量汇总，以及题库的题目抽取和 AI 补全讲解，同样需要用户主动点击才会发送对应的文本或图片；抽取任务发送前会先显示在 AI 侧栏供确认。批注中心和题库不会在后台自动识别或提问。整理到笔记、导出多维表、Anki、自测卷都在本地完成，不经过任何服务端。桌面端的 Node 流式回退直接建立到 AI 服务的连接，不经过系统代理。 授权与更新服务不会在插件启动后自动联网。只有用户主动执行激活、恢复、续期、同步授权、管理设备、检查更新或下载更新时才会发起对应请求；这些请求不包含笔记、文件名、手写内容、截图、OCR 内容或 AI 会话。 ## 18. 常见问题 ### “检查更新”按钮不可用 检查以下项目： - 当前设备是否已经激活，并且 `授权状态` 为有效。 - 当前构建是否包含正式授权服务地址；测试构建或未配置的开发构建不能检查私有更新。 - 固定期限授权是否已经到期；到期后需先续期并同步授权状态。 - 本机是否已在另一台设备上被解绑；可先点击 `同步授权状态`，再使用原 Ink Pro 激活码重新绑定。 ### 更新下载或安装失败 先确认网络可访问授权服务和发布下载地址，并确认当前 Obsidian 版本不低于更新窗口显示的最低版本。插件会拒绝签名无效、文件大小不符、哈希不符、产品 ID 不符或版本信息不一致的安装包。 安装失败时原版本会尽可能自动恢复。若重启后插件无法加载，可从提示中的 `.peyote-backup/<备份目录>/` 取回 `main.js`、`manifest.json` 和 `styles.css`，覆盖到当前插件目录后重启 Obsidian。不要删除笔迹或批注数据目录。 ### 设备解绑后 Pro 功能不可用 这是预期行为。解绑状态同步到本机后，插件会安全关闭 Pro 视图，但不会删除已有手写和批注数据。进入设置中的 `重新绑定授权`，输入最初购买时取得的 Ink Pro 激活码；重新绑定会再次占用一个设备名额。 ### 新文件第一次保存批注失败 新版已针对 iOS、Android、iCloud、移动端文档提供器和同步插件的首次旁车文件写入增加协调写入与竞争重试。若仍失败，请检查标注数据目录是否可写、设备剩余空间是否充足，以及同步工具是否正锁定目标文件夹；保留现有页面，待同步完成后再次点击保存。 ### PDF 打开后不是插件标注视图 检查 `PDF 默认使用标注视图打开` 是否开启。也可以在打开 PDF 后通过命令面板运行 `Open mobile ink annotation for current note`。 ### OCR 失败 检查以下项目： - 百度 OCR API Key 和 Secret Key 是否正确、是否来自同一个应用。 - Access Token 是否已过期，可点击 `立即刷新` 直接看到百度返回的错误。 - 报错 `6: No permission to access data` 表示该应用没有开通当前选择的 OCR 接口，回到百度控制台开通后重试。 - 当前 OCR 模型是否适合图片类型，例如手写内容优先选择手写文字接口。 - 是否已超出当日免费额度或并发限制（错误码 `17` / `18`）。 - 网络是否允许访问百度智能云接口。 ### AI 问图失败 检查以下项目： - 是否已有预设被标记为 `图片默认`。没有勾选 `支持图片输入` 的预设不能设为图片默认。 - 该预设指向的模型本身是否支持图片输入。 - Endpoint 是否为 OpenAI-compatible chat completions 接口。 - API Key 是否具备调用该视觉模型的权限。 - 打开该预设点一次 `测试生成`，视觉预设会附带一张测试图片，可直接看到服务端返回的错误。 ### AI 文本问答失败 先确认有预设被标记为 `文本默认`，再打开该预设检查 Endpoint、模型和 API Key，并点 `测试生成` 查看返回结果。文本问答只使用文本默认预设，不会回退到图片默认预设。 ### 提问后一直显示“正在思考”，或提示超时 流式回答 180 秒内没有任何数据会自动断开并提示；缓冲请求最长等待 300 秒。出现这类提示说明服务端接受了连接但没有返回内容：先在预设里点 `测试生成` 看服务是否正常，再检查中继或本地代理是否卡住。桌面端如果常规流式请求因跨域失败，插件会自动改用 Node 直连流式；该路径不走系统代理，需要代理的网络环境请让服务端补上跨域响应头，或改用不流式的服务。 ### 提示 HTTP 422 或服务拒绝请求 部分服务把 `content` 声明成字符串，收到标准的 OpenAI 数组格式会直接返回 422。编辑该预设，把 `内容格式` 改为 `字符串（图片走 image 字段）` 后重试。 ### 浏览器代理返回了上一轮的回答 这类服务把对话保存在浏览器页面里。请确认该预设已开启 `会话由服务端保存`，并填写了 `重置会话路径`。插件检测到返回内容与上一轮相同时会阻止写入，并在下次重试时重建并恢复本地会话。 ### 独立笔记月历标题被顶部栏遮挡 请更新到包含 iPad 月历模板顶部间距优化的版本。新版会为独立笔记月历模板预留顶部空间，避免标题与 Obsidian 顶部工具栏重叠。 ### 标注页在某些主题下整页空白 1.0.8 之前，标注画布的背景层借用了 Obsidian 主题的 `.markdown-preview-view` 类名，部分第三方主题对该类设置的布局、滤镜、混合模式或可见性规则会泄漏到画布上，导致整个标注页空白。更新到 1.0.8 后画布改用插件自己的 `.mobile-ink-background`。如果你为标注页写过自定义 CSS，请改用这个类名。 ### 整理到笔记后的手写回链卡片显示“手写区域（无笔迹）” 这是 1.0.7 的已知问题：批注中心导出的回链写的是记录 ID 而不是逐条笔迹 ID，卡片按笔迹 ID 找不到内容。更新到 1.0.8 后打开笔记即可正常显示，不需要重新整理；想让这些块也带上预览图，可再执行一次 `整理到笔记`，不会重复插入。 ### 批注中心里 PDF 手写预览图偏移或画到页面外 1.0.8 起预览按阅读页真实布局定位，并会在下次需要时重新生成旧的错位预览图。若某条仍不正确，先在阅读页把该 PDF 的批注保存一次，再回到批注中心滚动到该记录。 ### 贴纸无法插入 贴纸只在独立手写笔记中可用。请确认当前文件是 `.mink` 独立笔记，并从更多菜单中的贴纸入口插入。新版已支持在笔画工具状态下添加贴纸。 ### PDF 中插入的文本或形状重新打开后不见了 请先确认当前标注已经保存。新版 PDF 对象会随批注数据保存，重新打开 PDF 时会恢复对象层；如果是从其他 PDF 阅读器写入的标准批注，插件打开时也会尽量自动导入为插件内可显示的批注。 ### PDF 导出后虚线或点线变成实线 请更新到包含新版 PDF 形状导出的版本。新版会同时写入 PDF 标准边框信息和外观流，重新导入时也会从 PDF.js 暴露的边框样式推断实线、虚线或点线，减少样式丢失。 ### 移动端导出 PDF 失败或提示没有权限 新版移动端 Markdown 导出已恢复稳定路径，并使用移动端安全保存流程。仍然失败时，建议先保存当前标注，关闭其他占用内存较高的页面，再重新导出。 ### 找不到自定义贴纸 检查 `自定义贴纸素材目录` 是否存在，并确认图片格式为 PNG、JPG、WebP、SVG 或 BMP。也可以运行 `创建自定义手账贴纸素材目录` 创建默认目录结构。 ### PDF 无法选中文字或搜索不到内容 先确认当前 PDF 是否具有真实文本层。扫描件通常只有图片，无法直接选词或全文搜索，需要使用“圈画标注”后执行 OCR。移动端还应确认设置中的 `移动端文本选择` 已开启。 ### 遮盖点击后无法显示答案 请先切换到浏览状态或 PDF 文本选择状态，再点击遮盖块。若所有遮盖打开时都直接显示内容，检查设置中的 `默认显示遮盖内容`；该设置只改变初始显示状态，不会删除遮盖。 ### 看不到 PDF 出链引用框 确认 `PDF 出链显示` 已开启，并且 Markdown、白板或脑图中的链接确实包含当前 PDF 的批注 ID、页码或区域信息。大型库索引刷新可能需要短暂等待；引用源被改写后可重新打开 PDF 触发刷新。 ### 标准 PDF 批注按钮不可用 标准批注导出和写回源 PDF 只支持桌面端 PDF 标注视图，且需要页面加载完成。写回会修改当前库内的 `.pdf` 文件，因此务必确认自动备份已成功生成；普通“导出 PDF”仍可根据环境使用兼容路径。 ### 虚拟 PDF 打不开 - 在线 PDF：确认地址可直接返回 PDF，并检查网络访问权限。 - 库外本地 PDF：使用完整 `file:///` URI；该能力依赖桌面端文件系统，移动端通常不可用。 - 不要把占位文件当作真实 PDF 覆盖；如地址失效，需要重新创建或修改占位文件第一行的来源地址。 ### 加入脑图后找不到节点 先检查伴随面板当前选择的 `.imap`。如果设置了收集目标，新节点会进入该主题；否则进入“收集箱”。已有批注按记录 ID 去重，重复加入时不会再创建第二个节点。 ### `.imap` 被其他插件打开 在文件浏览器中选中该文件后运行 `使用标注思维导图打开当前 .imap`。如果同时安装 Ink Whiteboard，应只让 Mobile Ink Annotation 注册 `.imap` 扩展名，并从 Ink Whiteboard 的显式命令打开兼容视图。 ### 修改数据目录后批注或卡片消失 目录设置不会自动迁移文件。先把路径改回原值确认数据仍在，再将旧目录内容完整复制到新目录，最后重新切换设置并重载插件。不要在未备份时删除原目录。 ### 升级后批注状态里没有“已摘录”和“已理解” 这是 1.0.5 的预期变化。批注状态精简为 `收件箱` 和 `已归档` 两种，原有的“已摘录”归入 `收件箱`，“已理解”归入 `已归档`，首次打开批注中心时自动迁移。如需回退到 1.0.4，请先备份 `annotation-center` 目录。 ### 批注上的“转文字”没有反应 依次检查：OCR 是否已在设置中配置并可用；该批注是否为手写或图片批注（纯文本批注不需要 OCR）；当前批注是否已经定位到具体页面。识别失败时错误信息会保留在这条批注上，可在修正配置后点击“重新识别”。 ### 导出的 `.duowei` 文件打不开 `.duowei` 由多维表格插件负责打开。请确认该插件已安装并启用，且版本能够识别当前文件格式。本插件只生成文件，不参与后续的表格编辑与同步。 ### 双击画笔没有打开粗细设置 1.0.7 起改为“再次点按”：画笔或记号笔已经激活时再点一次即打开粗细与透明度，橡皮擦同理打开擦除设置。要切换到浏览模式，请打开「更多」面板选择“浏览模式”，或开启手指书写后使用主工具栏上的手形按钮。 ### 找不到卡片收藏夹、书签图标或阅读页卡片抽屉 它们已并入批注中心。打开批注中心后在范围导航选择 `我的收藏`，或运行命令 `打开批注中心 · 收藏`，或在阅读页「更多」面板选择“批注中心 · 收藏”。旧收藏会在首次打开批注中心时自动迁移；如果没有出现，检查“旧收藏迁移来源”目录是否还指向原来的 `card-favorites`。 ### 旧收藏迁移后“学习中”“已掌握”去哪了 收藏并入批注中心后不再有独立的学习状态。原“学习中”保留为标签和原状态记录；“已掌握 / 已归档”对应批注中心的已归档。需要按记忆曲线复习的内容请添加到题库。 ### 题目不出现在复习队列里 复习只出到期且已核对的题目。依次检查：题目是否勾选了 `已核对`（AI 抽取的题目默认为待复核）；题干和答案是否为空、是否还有 `待补答案` / `选项待完善` 等缺口；题目是否被 `暂停复习`；是否已达到“每日复习上限”。想练习未到期题目，用“更多”里的 `开始专项练习`。 ### AI 抽取的题目没有答案 原文材料里没有明确答案时插件要求模型留空并标记 `待补答案`，不会猜。可以在详情里手工填写，或 `添加来源材料` 把答案页的批注补进来后重新抽取，或使用 `AI 补全讲解 → 连答案一起推导`（结果标记为 AI 推导，仍需核对）。 ### 抽取出的题目字段乱码或被截断 先检查预设的 `最大输出长度` 是否太小，题库的 JSON 回答较长；服务支持时可开启 `结构化输出`。浏览器代理类服务不发送该参数，只能靠提示词，建议一次少合并几份材料。 ### 题目笔记提示“笔记待合并”或“存在冲突” 笔记里受保护区段之外的补充区段（选项、技巧、我的作答、分类、来源）被外部修改过，插件不会覆盖。打开该笔记按提示手动合并后，再在题库中点 `同步笔记`。只改题干、答案、解析、错因四个区段不会冲突，会自动回读并锁定字段。 ### PDF 文本对象显示成了格式化文本 文本对象中出现 Markdown 语法（链接、双链、`**加粗**`、列表、`$公式$`、表格等）时会渲染显示，不含这些语法的纯文本保持原样。需要显示字面符号时用反斜杠转义，或把文本拆开避免匹配。 ### 阅读页触屏选不中文字 触屏上的文本选择改为长按判定：按住约 0.2 秒不动后开始选词，随后拖动扩大选区；一开始就滑动会被当成翻页。手写笔与手指共用同一判定。仍无法选中时检查设置中的 `移动端文本选择` 是否开启，以及 PDF 是否有真实文本层。 ### 移动端拖动时 Obsidian 侧栏仍然滑出 请先确认已完全退出并重新打开 Obsidian，而不是只关闭标注页。此修复仅在插件自己的拖动操作期间拦截左右侧栏手势；从页面空白处开始的 Obsidian 系统滑动仍会按应用默认行为打开侧栏。若确认从对象、控制点、搜索框或脑图节点上开始拖动仍可复现，请记录设备类型、Obsidian 版本、起始元素和拖动方向。 ## 19. 推荐工作流 ### 论文阅读 1. 开启 PDF 默认标注视图。 2. 使用记号笔标记核心段落，用五色分类区分论点、方法、数据和疑问。 3. 对关键段落在摘录胶囊里写想法，或点 `AI 解释` 追问。 4. 使用文本、箭头或形状标出图表中的关键位置。 5. 对复杂图表圈画后执行 AI 解释或提取文字。 6. 将重要结论 `收藏`，或 `入脑图` 加入当前 `.imap`。 7. 在伴随脑图中把“收集箱”内容整理到不同主题。 8. 阅读结束后在批注中心按文档复盘，多选后 `整理到笔记` 写入论文笔记。 ### 教材刷题 1. 打开 PDF 或 Markdown 题目材料，在页面上手写解题过程。 2. 圈画做错的题目，在摘录胶囊里选择 `识别并添加错题`；答案和解析在别的页时，先把它们也圈画或高亮，再在弹出的窗口里标注题干 / 答案 / 解析用途并合并为一道题。 3. 在 AI 侧栏确认材料后发送，回到批注中心 `题库` 核对题干、答案和错因，勾选“已核对”。 4. 需要讲解时点 `AI 补全讲解`，先在设置里把“题库讲解方向”设为对应考试。 5. 每天点 `开始今日复习`，复习时用手写草稿演算，按回忆情况评分；`顽固错题` 回到来源材料补解析。 6. 考前用 `导出自测卷 Markdown` 打印，或 `导出 Anki TSV` 同步到 Anki。 7. 对答案区域创建遮盖，在原书上翻看时点击显示答案。 ### 课堂或会议手写笔记 1. 创建独立 `.mink` 手写笔记。 2. 选择横线纸、方格纸、康奈尔或月历模板。 3. 插入图片、贴纸、文本或书写便利贴作为结构化辅助。 4. 会后导出 PDF 或在 Obsidian 中嵌入预览。 ### 知识库问答 1. 准备本地 `vector_store.json`。 2. 在设置中填写 RAG 本地向量库路径。 3. 开启智能问答默认 RAG。 4. 对选中文本、批注或问题发起 AI 问答。 ### 边读边构建知识图谱 1. 打开资料的 Markdown/PDF 标注视图和“伴随脑图”。 2. 新建或选择一个 `.imap`，先建立章节或问题框架。 3. 把当前主题固定为收集目标。 4. 阅读时将关键文字、截图和已有批注持续加入脑图。 5. 通过拖拽调整父子/同级结构，使用放射、单向或树形布局整理。 6. 从节点跳回原文复核上下文，完成后导出 Markdown、OPML 或 FreeMind。 ## 20. 维护建议 - 定期备份 Obsidian 库，尤其是实际配置的 `annotations`、`captures`、`annotation-center`（含 `index.json` 与题库 `question-bank.json`）和 `md-source-annotations` 数据目录；`card-favorites` 是旧收藏备份，迁移完成后仍建议保留一份。 - 题目同步生成的 `Annotations/QuestionBank/` 笔记和整理到笔记的目标笔记都是普通 Markdown，可随库同步；不要手工改动其中的 `` 区段标记和 `^anno-` 块 ID。 - 重要 `.mink` 独立笔记建议纳入同步或版本管理。 - 重要 `.imap` 及其 `assets` 图片目录建议一起纳入同步或版本管理。 - 应用内更新成功并确认新版稳定后，再按备份策略清理插件目录中的旧 `.peyote-backup` 和 `.peyote-update` 内容；至少保留最近一次可用备份。 - 调整数据存储目录前先备份并手动迁移，确认新位置读取正常后再清理旧目录。 - 修改 API Key 后，建议重新执行一次 OCR 或 AI 问答确认配置可用。 - 在 iPad 上使用时，建议折叠不常用工具栏区域，为页面内容留出更多空间。