使用场景和入口
Anki 卡包导入用于将 .apkg 文件中的卡片和附件转换为记乎牌组。在记乎桌面版的牌组首页点击“导入Anki卡包”，依次完成文件选择、内容设置、预览和确认导入。
- 文件要求：支持新旧版
.apkg，每次选择一个文件，单个文件最大 2 GiB。不支持直接导入.colpkg集合备份或普通 ZIP 压缩包。 - 导入位置：新的导入流程会创建新牌组，不能选择已有牌组作为目标。
- 学习进度：不迁移 Anki 的学习进度和复习记录，导入后按记乎的新卡开始学习。
- 数量限制：导入功能不设会员专享门槛；普通用户每个牌组最多 50 张卡片，PLUS 会员最多 50,000 张。请以预览页的容量检查结果为准。
不同卡包的模板和附件可能存在差异。建议保留原始文件，并在确认前检查预览，特别是挖空、音频和带交互效果的卡片。
准备 Anki 卡包
已经有 .apkg 文件，可以直接进入下一步。如果卡片还在 Anki 中，请先在电脑端 Anki 导出：
- 选择导出格式。打开“文件 → 导出”，选择 Anki 牌组包（
.apkg）。 - 选择牌组。指定需要迁移的内容。
- 包含媒体。勾选“包含媒体”，将本地图片、音频等附件一起打包。
- 保存文件。“包含调度信息”无需为记乎导入勾选，即使包含，也不会迁移学习进度。
不同语言或版本的选项名称可能略有不同，可参考Anki 官方导出说明。如果手中只有集合备份，请先在 Anki 中准备好要迁移的牌组，再导出为牌组包；直接修改后缀不能转换文件格式。
选择卡包文件
- 打开导入工具。在记乎桌面版的牌组首页点击“导入Anki卡包”。
- 选择文件。点击“选择 APKG 文件”，或将一个本机卡包拖入导入区域。
- 等待解析。解析完成后进入导入设置，核对来源文件。
传输工具附加了 .apk.1g 或 .apkg.1g 后缀的文件，也可以直接拖入，但文件内容仍须是有效的 Anki 卡包。
设置导入内容
- 填写新牌组名称。名称为 1–30 个字符；自动填入的文件名过长时，请先缩短。
- 选择导入内容。逐项勾选需要的源牌组，核对已选择的牌组数和卡片数。
- 选择重复处理方式。“遇到已导入卡片”可选“跳过并保留现有内容”或“导入为副本”。该选项不用于覆盖更新已有卡片，也不代表可以合并到任意已有牌组。
- 生成预览。点击“生成预览”，检查转换结果。
生成预览时尚未创建新牌组。首次预览时直接关闭，不会留下空牌组。
检查预览并确认导入
请先检查数量和目录，再切换几张卡片，查看正反面、字段、挖空和媒体。有朗读按钮时，可以试听。
- 数量与目录：确认可导入数量，并展开目录明细查看导入位置。子牌组会转换为目录，过深的层级会合并显示。
- 转换说明：部分卡片的展示或交互会变化。阅读说明后，如果接受这些变化，勾选“已查看并接受转换说明”。
- 不兼容卡片：若接受跳过这些卡片，勾选“仅导入兼容部分”。全部卡片都不兼容时无法导入。
预览默认不加载外部图片、音视频和字体。需要查看时，可勾选“允许预览加载远程媒体（会连接卡片中的外部网站）”。接受转换说明不会自动开启此选项；远程媒体仍依赖原网站，离线时可能无法使用。
需要调整范围时，点击“上一步”；返回后需要重新预览和确认。确认无误后，点击“确认导入 × 张”，开始创建新牌组并导入卡片。
处理完成、失败和部分成功
导入结束后，核对“已导入”“重复跳过”“不兼容”“失败”和“未导入”的数量，再点击“查看牌组”。先抽查几张不同类型的卡片，确认内容和媒体符合预期，再开始学习。
导入取消或停止后，已经创建的牌组和已导入卡片会保留。结果页提供“预览剩余卡片”时，可以从该入口重新预览并继续处理；有失败明细时，先查看具体原因。
准备换设备学习时，请先等待同步完成，再在另一设备查看。具体操作见同步与恢复；需要管理导入的图片和音频，可阅读附件管理。
内容兼容和转换说明
导入会把 Anki 的卡片内容转换为记乎可编辑、可学习的卡片，并检查模板和附件。支持某种卡片类型，不代表其中所有脚本、样式和附件都能原样保留。请结合下列规则和本次预览结果判断。
| 检查结果 | 处理方式 |
|---|---|
| 兼容 | 可以导入。仍需检查正反面和媒体是否符合预期。 |
| 需要转换 | 保留可转换的内容，但展示、交互或编辑方式可能变化。预览会列出说明，勾选“已查看并接受转换说明”后才能继续。 |
| 卡片不兼容 | 相关卡片不导入。只有明确勾选“仅导入兼容部分”，才会导入其余可用卡片；全包没有兼容卡片时不能继续。 |
| 文件或整体检查失败 | 无法开始导入。需要重新准备文件、减少导入范围或解决提示的问题。 |
支持导入的内容
| 内容 | 支持范围与边界 |
|---|---|
| 普通问答、反向、可选反向、多模板卡片 | 按卡包中已有的卡片分别转换。同一笔记生成的多张卡片独立导入，不会在记乎中自动建立联动关系。 |
| 普通编号挖空 | 当前编号保留为挖空，其他编号显示答案；不同字段可以包含不同编号。提示会转为可见文字，嵌套挖空不支持。 |
| 字段和常见模板结构 | 支持字段引用、嵌套条件以及在背面引用正面内容（FrontSide）。引用的字段必须存在，条件块必须完整配对。 |
| 文字与排版 | 支持常见富文本和可转换的卡面 CSS。原字段名称用于显示，字段说明保留为备注；实际字体和排版仍需查看预览。 |
| 本地媒体 | 支持包内图片、音频、视频、CSS 背景和字体。Anki 的 sound 媒体标记会转换为相应的音频或视频引用；附件必须存在并通过校验。 |
| 常用数学公式 | 支持常用的行内、块级公式分隔方式，例如 \( … \) 和 \[ … \]。不包含依赖外部 LaTeX 编译生成内容的方式。 |
| 单字段语音朗读 | 支持指定语言的单字段朗读，转换为原位置的记乎朗读按钮。朗读读取字段文字，编辑保存后使用新内容；自动朗读按记乎学习设置执行。 |
需要转换并确认的内容
| Anki 中的功能 | 转换后的表现 |
|---|---|
| 输入答案比对（type） | 转为普通问答。正面提示回忆答案，背面显示答案，不保留输入框和自动比对。 |
| 点击显示提示（hint） | 转为直接可见的提示，不再需要点击展开。 |
| 纯文本、日语注音等显示过滤器 | text、furigana、kana、kanji 会生成附加可编辑字段，分别保留提取的文字、注音、读音或汉字显示结果。原字段也保留，两者独立编辑。 |
| 未知字段过滤器 | 无法识别的过滤效果不保留，按底层字段内容继续转换并提示。依赖过滤器生成答案或隐藏内容的卡片，尤其需要检查预览。 |
| 同一字段同时显示原文和挖空 | 拆分为独立可编辑字段，分别用于原文和挖空。修改其中一份不会更新另一份。 |
| 仅显示当前挖空（cloze-only） | 正面显示当前编号的提示，没有提示时显示“...”；背面显示当前编号的答案，多段用逗号连接。正反面的生成字段独立编辑。 |
| 指定朗读声音和语速 | 支持识别 voices、speed 设置，但转换后使用记乎当前的声音和语速，不保证与 Anki 的音色和播放速度一致。 |
| 多字段朗读块 | 受支持的语音块合并为独立可编辑的朗读字段。后续修改原字段时，需要同时检查并更新这份朗读内容。 |
| 由字段拼接的媒体地址 | 在导入时确定图片、音视频或封面来源。之后修改原文件名字段，不会自动重新选择附件。 |
| 内嵌样式、内联背景 | 可转换的样式移入卡片模板样式；图片尺寸和说明会尽量保留。复杂布局需要逐张抽查。 |
| 多来源媒体和视频封面 | 多来源媒体使用第一个来源；视频封面转为可见图片，不保留原有的多来源切换或封面行为。 |
| 缺失字体 | 使用系统字体替代，字形、换行和排版可能变化。 |
| 未显示内容中的缺失附件 | 不影响当前题目显示的未显示字段或条件块，可以保留附件名称和缺失标记。后续编辑或改变显示条件时，仍需补齐附件。 |
| 标签、牌组名等来源信息 | 模板引用的标签、笔记类型、牌组、子牌组和卡片模板名称会转换为导入时的显示内容，不会随记乎中的名称变化自动更新。 |
转换得到的注音、朗读、原文或挖空显示字段，是可独立修改的内容。修改原字段后，应检查这些附加字段和相关卡片，不能假定它们会自动同步变化。
模板脚本和交互效果
模板中的 JavaScript 会尝试转换为静态显示结果。例如，根据字段内容修改文字、样式或增删部分页面内容，能够转换时会保留处理后的显示结果，并移除脚本。
点击事件、计时器、联网请求和插件能力不会作为原有脚本功能带入记乎。某段脚本无法转换时，会移除该段脚本并保留其余可转换内容，预览会提示。依赖脚本生成的题干、答案或动态效果可能因此缺失，必须检查卡面后再决定是否接受。
脚本被移除不代表整张卡片一定可导入。如果剩余内容仍包含不支持的交互元素、不安全样式或缺失必需附件，相关卡片仍会列为不兼容。
远程图片、音频和字体
可识别的 HTTP/HTTPS 远程媒体会保留原地址，并提示离线风险，不会自动变成本地附件。原网站失效、限制访问或设备离线时，内容可能无法显示或播放。
“允许预览加载远程媒体”只控制本次预览是否连接外部网站，与“已查看并接受转换说明”是两项独立选择。关闭预览联网不会把远程地址转换成本地资源。
不能兼容的内容
以下问题会使相关卡片无法导入。可以先在 Anki 中调整，再重新导出并预览；也可以接受仅导入其他兼容卡片。
| 不兼容情况 | 建议处理 |
|---|---|
| 图片遮挡、未支持的自定义或插件笔记类型 | 先在 Anki 中改为普通问答或受支持的编号挖空；图片遮挡可整理为带独立题目图和答案图的普通卡片。仅含未知显示过滤器的普通卡片，按前述转换规则处理。 |
| 嵌套挖空 | 将挖空内部继续包含挖空的内容拆为平级挖空或不同卡片。 |
| 卡片找不到对应编号的可见挖空 | 检查该卡片的挖空编号及正面模板，确认正面实际引用了对应内容。 |
| 缺失题目实际需要的图片、音频等附件 | 在 Anki 中补齐附件，确认能正常显示或播放，再勾选“包含媒体”导出。不会通过忽略必需附件来导入该卡片。 |
| 媒体没有有效来源，或地址无法解析 | 修正媒体地址或改用包内本地附件。无效编码及不支持的地址格式不能按远程媒体保留。 |
| 内嵌 SVG 引用了外部资源 | 将此类 SVG 转为独立图片后重新导出。SVG 内部引用自身图形片段和普通导航链接，不属于这一限制。 |
| 依赖外部 LaTeX 编译 | 例如使用 [latex]、[$]、[$$] 标记的内容。改为记乎支持的公式写法，或在 Anki 中整理为已打包的独立图片。 |
| 无法处理的朗读语法 | 包括未知 TTS 扩展参数、无效语言代码、放在 HTML 属性中的朗读指令，以及不受支持的语音块写法。可简化为标准单字段朗读。 |
| 模板结构或引用错误 | 包括引用不存在的字段、条件块未配对、缺少对应模板、缺少关联笔记或牌组等。先修正 Anki 中的卡片和模板。 |
| 剩余内容含不支持的交互或可执行内容 | 例如嵌入网页、表单、输入框、按钮、字段内脚本、残留事件脚本或可执行模板代码。先改为静态文字、图片或普通问答。 |
| 不安全或无法解析的样式、外部样式表 | 移除不支持的样式依赖，使用可随卡包保留的普通卡面样式。 |
| 相同来源身份对应不同内容 | 先在 Anki 中整理冲突来源后重新导出。导入不会任意选择其中一份作为正确内容。 |
目录、编辑关系和学习进度
- 目录最多三级。卡包文件名作为导入根目录，源子牌组转为目录。超出层级的名称会合并，例如源路径 A::B::C::D 可显示为“卡包根目录 / A / B::C::D”。
- 卡片独立编辑。同一笔记生成的正向、反向和其他卡片不会联动，修改一张卡片不会同步修改其他卡片。
- 编辑偏好不迁移。Anki 字段编辑器的字体、字号、从右向左编辑和默认 HTML 编辑偏好，不会直接变成记乎卡面设置。卡面按可转换的内容和样式显示。
- 学习状态不迁移。不保留原到期时间、复习间隔、暂停状态、FSRS 状态和复习记录，导入后按新卡开始学习。过滤牌组可识别的原牌组信息只用于恢复目录，不恢复过滤牌组状态。
- 重试与重新导入不同。同一次导入中使用“预览剩余卡片”可以继续处理剩余内容；关闭后重新选择文件，会创建另一个新牌组，不会追加到上一次牌组。
哪些问题会阻止整个导入？
文件格式不支持、主数据损坏、压缩包结构异常或超出整体限制时，无法开始导入。单个压缩包最大 2 GiB，解压后的内容总量最多 10 GiB，压缩包内条目最多 100,000 个；卡片和附件还需通过各自的大小与内容检查。可尝试在 Anki 中减少导出范围，分包处理。
卡片数量超出当前账号的牌组容量时，需要返回设置减少选择范围。所有卡片都不兼容时，需要先修正源内容；勾选接受转换说明不能绕过不兼容检查。
开始导入后，单张卡片的附件处理失败可能只影响该卡片；磁盘空间或数据库故障等问题会停止后续导入。已经成功导入的内容会保留，应先核对结果，再处理失败或剩余卡片。
导入后的检查
- 已导入、跳过、不兼容、失败和未导入数量与结果页一致。
- 目录位置和卡片内容符合所选范围。
- 代表性卡片的正反面、挖空和提示显示正确。
- 图片能够显示，音频、视频和朗读能够正常使用。
- 需要补充导入时，先检查剩余卡片，避免重复导入已成功内容。
- 切换设备前等待同步完成，在另一设备抽查卡片和媒体。
常见问题
找不到导入入口怎么办？
请在记乎桌面版的牌组首页查找“导入Anki卡包”，卡片编辑器中没有这个入口。如果所用版本没有该功能，需要使用包含此功能的桌面版。
为什么卡片数量和 Anki 中看到的不一样？
导入按“卡片”计数，不是按“笔记”计数。一条笔记可能生成正向、反向或多个挖空卡片。选择范围、不兼容卡片和重复跳过，也会影响最终数量。
为什么“确认导入”不能点击？
查看按钮旁的提示：可能超出容量、没有可导入卡片、兼容性说明尚未加载完成，或尚未勾选必要确认项。加载失败时请重试；超出容量时返回上一步减少导入范围。
图片或音频缺失怎么办？
先查看兼容性说明。如果包内缺少附件，请回到 Anki 确认原卡片的媒体可用，并勾选“包含媒体”重新导出。如果使用远程媒体，请检查是否已允许预览加载，以及原地址是否仍可访问。
文件无法解析怎么办？
确认文件已完整下载、未超过 2 GiB，且是有效的 APKG 牌组包。仍然失败时，可从 Anki 重新导出后再试；文件改名无法修复损坏的内容。
导入后可以继续编辑吗？
可以。需要注意，同一条 Anki 笔记生成的多张卡片，以及转换生成的附加字段彼此独立，修改其中一个不会自动更新其他内容。