指南 · 资源
Anki 到 Deckbase 迁移操作手册
适用于 APKG 与 CSV 路径的低风险迁移工作流,设有明确的质量关卡,让导入速度不会损害记忆保持的质量。
本手册适合谁
本指南面向已经拥有活跃 Anki 牌组、希望有条理地迁移到 Deckbase、同时不破坏每日复习连贯性的学习者。如果你正在搜索 anki import csv,这正是把快速搬运与质量稳定区分开来的实施路径。
迁移前检查清单
- 1首次导入前,备份每一个源牌组。
- 2列出最近 30 天内活跃的牌组,优先迁移这些牌组。
- 3在扩展到多个牌组之前,先定义通过/不通过的质量关卡。
- 4设定每日复习下限(按时长或按卡片数量),以保持习惯的连续性。
路径 A:APKG 优先迁移
当速度与结构保真最重要时,使用 APKG。这条路径适合第一波迁移,目标是保持连续,而不是做到完美清理。
- 导入一个活跃牌组,并立即抽查 30 张卡片。
- 只修复影响大的问题:无法阅读的题干、损坏的媒体文件、明显的重复。
- 当天就恢复复习,不要为了大规模的外观修改而暂停。
路径 B:CSV 优先迁移
当需要做字段级规范化时,使用 CSV。CSV 前期耗时更长,但更容易在大规模下统一命名、执行模板规则并完成去重。
- 1导入前先统一字段名与术语格式。
- 2为题干、答案、标签和上下文建立单一规范映射。
- 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-3 天:迁移一个活跃牌组,并立刻恢复每日复习。
- 2第 4-7 天:修复最容易出错的卡片,并去除重复的正面题干。
- 3第 8-10 天:统一标签与模板,并验证会话时长的趋势。
- 4第 11-14 天:只有在完成率和遗忘率指标保持健康时,才扩大迁移范围。
按场景划分的迁移建议
考试冲刺(8-12 周)
- 首要目标
- 保持每日完成率稳定
- 推荐做法
- 只导入活跃牌组,暂停归档牌组的迁移
长期语言学习
- 首要目标
- 保留句子语境
- 推荐做法
- 采用 CSV 路径并严格执行字段规范化
团队迁移
- 首要目标
- 模板一致性
- 推荐做法
- 在批量导入前发布单一规范映射
归档清理
- 首要目标
- 淘汰低产出牌组
- 推荐做法
- 按主题迁移,并尽早舍弃过时卡片
常见问题
应该先用 APKG 还是 CSV?
一次应该迁移多少个牌组?
迁移期间可以同时保留 Anki 和 Deckbase 吗?
如果卡片导入不正确怎么办?
如果迁移效果不好可以回滚吗?
迁移后的第一周该做什么?
迁移会丢失复习历史吗?
迁移后的第一周:成功清单
头七天决定迁移是否成功。先把主牌组稳定下来,再扩展到其他牌组。
- 1第 1 天:完成首次包含导入卡片的复习会话,记录任何格式问题。
- 2第 2-3 天:找出并修复那些让人困惑或题干不清的卡片。
- 3第 4-5 天:运行重复检查,合并正面题干相同的卡片。
- 4第 6-7 天:评估你的会话时长。如果明显增加,检查卡片是否过长。
- 5到第 7 天:决定是继续用 Anki、完全切换到 Deckbase,还是两者并用。
小贴士:第一个月内保留 Anki 安装和原始牌组不要动。这样如果 Deckbase 不符合需求,你还有回滚的选项。
想先看顶层概览?先读那篇关于迁移策略的已发布文章,再回到本手册了解具体执行。从 Anki 导入/导出指南 开始。