指南 · 资源

Anki 到 Deckbase 迁移操作手册

适用于 APKG 与 CSV 路径的低风险迁移工作流,设有明确的质量关卡,让导入速度不会损害记忆保持的质量。

Deckbase 编辑团队阅读约 8 分钟

本手册适合谁

本指南面向已经拥有活跃 Anki 牌组、希望有条理地迁移到 Deckbase、同时不破坏每日复习连贯性的学习者。如果你正在搜索 anki import csv,这正是把快速搬运与质量稳定区分开来的实施路径。

迁移前检查清单

  1. 1
    首次导入前,备份每一个源牌组。
  2. 2
    列出最近 30 天内活跃的牌组,优先迁移这些牌组。
  3. 3
    在扩展到多个牌组之前,先定义通过/不通过的质量关卡。
  4. 4
    设定每日复习下限(按时长或按卡片数量),以保持习惯的连续性。

路径 A:APKG 优先迁移

当速度与结构保真最重要时,使用 APKG。这条路径适合第一波迁移,目标是保持连续,而不是做到完美清理。

  • 导入一个活跃牌组,并立即抽查 30 张卡片。
  • 只修复影响大的问题:无法阅读的题干、损坏的媒体文件、明显的重复。
  • 当天就恢复复习,不要为了大规模的外观修改而暂停。

路径 B:CSV 优先迁移

当需要做字段级规范化时,使用 CSV。CSV 前期耗时更长,但更容易在大规模下统一命名、执行模板规则并完成去重。

  1. 1
    导入前先统一字段名与术语格式。
  2. 2
    为题干、答案、标签和上下文建立单一规范映射。
  3. 3
    先导入试点批次,通过所有质量关卡后再全面铺开。

字段映射矩阵

正面

用途
题干文本
质量规则
仅包含一个概念
操作说明
导入前拆分内容过载的卡片

背面

用途
期望答案
质量规则
先给出直接答案
操作说明
把冗长解释放在笔记中

标签

用途
主题分组
质量规则
分类体系保持一致
操作说明
使用 领域/章节 的命名方式

补充 / 笔记

用途
上下文支持
质量规则
简短且可选
操作说明
避免在其中嵌入答案线索

媒体

用途
视觉/听觉上下文
质量规则
已附加且可正常读取
操作说明
在样本中检查失效引用

批次质量关卡

在每一批新导入之前先跑一遍关卡。只要有一项不通过,就暂停新的导入,先修复卡片质量。这样可以把问题控制在很小的范围,避免积压成债。

可理解性

通过阈值
抽样卡片中 >=90% 可理解
未通过信号
题干格式含糊或嘈杂

重复率

通过阈值
<3% 的重复正面题干
未通过信号
该批次存在重复的定义或标题

单次会话负担

通过阈值
会话时长周环比增幅 <15%
未通过信号
导入的卡片过于冗长

遗忘率趋势

通过阈值
到第 2 周保持稳定或有所改善
未通过信号
核心主题的题干质量偏低

规模化之前需要处理的 Anki 特有问题

大多数迁移退化都来自一些在样本里看似很小、在数据量放大后却代价高昂的边缘情况。在导入更多牌组之前,先检查完形填空渲染、暂停卡片状态、顽固卡(leech)行为和媒体引用。

完形填空卡片

常见故障
导入后缺失完形标记
缓解措施
在全面迁移前验证样本的完形渲染

暂停的卡片

常见故障
意外出现活跃复习负担
缓解措施
导出暂停状态,并在导入后重新应用

顽固卡(leech)

常见故障
长期失败污染队列
缓解措施
标记顽固卡,并执行重写/归档策略

媒体引用

常见故障
图片或音频指针失效
缓解措施
对前 100 张卡片运行失效媒体扫描

牌组选项

常见故障
间隔行为不匹配
缓解措施
在扩展更多牌组前先跑 14 天指标

可重复迁移的 CSV 导入契约

如果你要做周期性导入,就定义一份固定的 CSV 契约并为其设定版本。这样可以减少不同操作者之间的结构漂移,也让 QA 自动化更容易实现。一个实用的基线是六列契约,包含标识、题干、答案、上下文、分类和来源字段。

note_id

作用
稳定的行标识
约束
防止意外重复摄入

front_text

作用
题干字段
约束
统一标点与 unicode 变体

back_text

作用
答案字段
约束
把直接答案放在第一句

context_hint

作用
可选的消歧信息
约束
仅使用简短的领域上下文

tags_pipe

作用
分类分组
约束
使用竖线分隔的规范标签

source_ref

作用
可追溯性
约束
记录章节/页码以便 QA 回溯

保持 UTF-8 编码,统一换行符,避免在导出的单元格中出现隐藏的电子表格公式。这些小的约束能防止悄无声息的导入损坏。

14 天稳定化流程

  1. 1
    第 1-3 天:迁移一个活跃牌组,并立刻恢复每日复习。
  2. 2
    第 4-7 天:修复最容易出错的卡片,并去除重复的正面题干。
  3. 3
    第 8-10 天:统一标签与模板,并验证会话时长的趋势。
  4. 4
    第 11-14 天:只有在完成率和遗忘率指标保持健康时,才扩大迁移范围。

按场景划分的迁移建议

考试冲刺(8-12 周)

首要目标
保持每日完成率稳定
推荐做法
只导入活跃牌组,暂停归档牌组的迁移

长期语言学习

首要目标
保留句子语境
推荐做法
采用 CSV 路径并严格执行字段规范化

团队迁移

首要目标
模板一致性
推荐做法
在批量导入前发布单一规范映射

归档清理

首要目标
淘汰低产出牌组
推荐做法
按主题迁移,并尽早舍弃过时卡片

常见问题

应该先用 APKG 还是 CSV?

如果希望快速完成结构搬运,先用 APKG。如果需要在规模化之前严格清理字段或规范模板,则用 CSV。

一次应该迁移多少个牌组?

先从一个活跃牌组开始,稳定运行 7-14 天。只有在完成率、会话时长和遗忘率趋势保持健康时,才继续扩展。

迁移期间可以同时保留 Anki 和 Deckbase 吗?

可以。很多学习者在 Deckbase 中创建全新卡片的同时,把旧牌组留在 Anki,等质量控制稳定后再合并。

如果卡片导入不正确怎么办?

常见问题包括编码问题(请使用 UTF-8)、缺少必填字段以及模板不匹配。导出为 CSV,在电子表格中修复问题,然后重新导入。本手册包含一份用于可重复迁移的 CSV 契约。

如果迁移效果不好可以回滚吗?

可以。迁移前先把 Anki 牌组导出为备份(.apkg)。Deckbase 不会删除你原有的 Anki 数据。如果 Deckbase 不符合你的需求,你随时可以回到 Anki,而不会丢失进度。

迁移后的第一周该做什么?

专注于稳定化:修复出错的卡片、去除重复题干,并建立每日复习习惯。在主牌组稳定之前不要添加新牌组。密切关注会话时长和遗忘率。

迁移会丢失复习历史吗?

卡片内容会随 APKG 导入一并转移,但复习历史(学习状态、间隔)不会,因此导入的卡片会从零开始。之后 Deckbase 的 FSRS 调度器会依据你的新复习记录设定间隔。

迁移后的第一周:成功清单

头七天决定迁移是否成功。先把主牌组稳定下来,再扩展到其他牌组。

  1. 1
    第 1 天:完成首次包含导入卡片的复习会话,记录任何格式问题。
  2. 2
    第 2-3 天:找出并修复那些让人困惑或题干不清的卡片。
  3. 3
    第 4-5 天:运行重复检查,合并正面题干相同的卡片。
  4. 4
    第 6-7 天:评估你的会话时长。如果明显增加,检查卡片是否过长。
  5. 5
    到第 7 天:决定是继续用 Anki、完全切换到 Deckbase,还是两者并用。

小贴士:第一个月内保留 Anki 安装和原始牌组不要动。这样如果 Deckbase 不符合需求,你还有回滚的选项。

想先看顶层概览?先读那篇关于迁移策略的已发布文章,再回到本手册了解具体执行。从 Anki 导入/导出指南 开始。